Litescrape sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.litescrape.com/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

← All documentation

// Facebook documentation

Facebook Search Pages API Alpha

Find public Pages by name, with country and ad-category preferences. Returns Page IDs, names and available metadata, with up to 15 suggestions. Pagination is unavailable.

GET / POST https://api.litescrape.com/api/facebook/search-pages

// from request to code

Integrate Facebook Search Pages

Build your request and copy it into your stack. Or let your coding agent set it up.

APIFacebook Search Pages
More options 3
Request parameters

Find public Pages by name, with country and ad-category preferences. Returns Page IDs, names and available metadata, with up to 15 suggestions. Pagination is unavailable.

Your request updates the code instantly.

Open the Playground →

Set LITESCRAPE_API_KEY on your server, then run this request.

request.sh
curl --fail-with-body --request POST 'https://api.litescrape.com/api/facebook/search-pages' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "NASA",
  "limit": 15,
  "country": "US",
  "ad_type": "ALL"
}'

Read all parameters →

JSON POST request example

POST to https://api.litescrape.com/api/facebook/search-pages with Content-Type: application/json and your Authorization: Bearer header.

POST · application/json
{
  "query": "NASA",
  "limit": 15,
  "country": "US",
  "ad_type": "ALL"
}

// request reference

Facebook Search Pages parameters

Send query parameters with GET /api/facebook/search-pages. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.

POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.

Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.

Request parameters

Find public Pages by name, with country and ad-category preferences. Returns Page IDs, names and available metadata, with up to 15 suggestions. Pagination is unavailable.

query
QueryRequired

Page name or phrase to look up.

Type string · GET query or POST JSON

  • Minimum characters: 1
  • Maximum characters: 200
  • Pattern: ^\S(?:.*\S)?$
limit
LimitOptional

Maximum Page suggestions per response; fewer may be available.

Type integer · GET query or POST JSON · Default 15

  • Minimum: 1
  • Maximum: 15
country
CountryOptional

Two-letter country preference for Page suggestions, such as US, GB or CA. Does not restrict a Page's location.

Type string · GET query or POST JSON · Default US

  • Pattern: ^[A-Z]{2}$
ad_type
Ad categoryOptional

Ad category for Page suggestions: all ads or political and issue ads.

Type string · GET query or POST JSON · Default ALL

Accepted valuesALLPOLITICAL_AND_ISSUE_ADS

// response

Work with the complete JSON response

Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.

Response groups include source_url, source, pages, submit_feedback_for_this_response_here. Groups and fields depend on the available results.

Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.

Illustrative success response. Results and optional fields vary with the available data.

200 · application/json
{
  "source_url": "https://www.facebook.com/ads/library/",
  "source": "page_suggestions",
  "pages": [
    {
      "page_id": "54971236771",
      "name": "NASA - National Aeronautics and Space Administration",
      "category": "Government Organization",
      "page_alias": "NASA",
      "image_uri": "https://scontent-lax3-1.xx.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=dst-png&cstp=mx800x800&ctp=s200x200&_nc_cat=1&ccb=1-7&_nc_sid=418b77&_nc_ohc=4lGeUjpKYjEQ7kNvwEcNGtv&_nc_oc=Adp4cV4Y4Usixn6YYSBl6Wy1HzKXOO0e-rOtYVYaD1TwUyucjEzh4R6ftkZHXaDHQ7g&_nc_zt=24&_nc_ht=scontent-lax3-1.xx&_nc_gid=K-EwX4gvmurTdLZNUKXkug&_nc_ss=7b289&oh=00_AQMjIAaeAC9Y9AnwKWFU0_z6yxsu9JBySiB5yh3g0QXk9g&oe=6AD17C15",
      "likes": 28716977,
      "verification": "BLUE_VERIFIED",
      "entity_type": "PERSON_PROFILE",
      "ig_username": "nasa",
      "ig_followers": 104331988
    },
    {
      "page_id": "57242657138",
      "name": "NASA Earth",
      "category": "Science Website",
      "page_alias": "nasaearth",
      "image_uri": "https://scontent-lax3-1.xx.fbcdn.net/v/t39.30808-1/658893230_1365685015607326_7541834145676870338_n.avif?stp=dst-avif&cstp=mx2048x1366&ctp=p200x200&_nc_cat=104&ccb=1-7&_nc_sid=418b77&_nc_ohc=yYeIqwd1hT0Q7kNvwHWoSZh&_nc_oc=AdqeQSXQdorPZndVZ4PZUUgCmYYn7tBEmHdpxGsSd0WHdL9IHaIOkhjKzIg_oXdPiX0&_nc_zt=24&_nc_ht=scontent-lax3-1.xx&_nc_gid=K-EwX4gvmurTdLZNUKXkug&_nc_ss=7b289&oh=00_AQPiUxJ_wW2f66ZiceeRBAZRC8H9U29sTtEQWN3ImrvTIQ&oe=6AD18D54",
      "likes": 11299448,
      "verification": "BLUE_VERIFIED",
      "entity_type": "PERSON_PROFILE",
      "ig_username": "nasaearth",
      "ig_followers": 2144800
    },
    {
      "page_id": "106558772714844",
      "name": "Josh Nasar",
      "category": "Public Figure",
      "page_alias": "joshuanasarfanpage",
      "image_uri": "https://scontent-lax3-1.xx.fbcdn.net/v/t39.30808-1/324025154_1323529671731122_9213150886294789590_n.jpg?stp=dst-jpg_tt6&cstp=mx828x444&ctp=p200x200&_nc_cat=1&ccb=1-7&_nc_sid=418b77&_nc_ohc=IB4bbUtwkYYQ7kNvwFWBhk6&_nc_oc=Adr6W0_txT185iMxxpNikbjYZxEoPtW33Y6IksKHcJJngTH3Y89D9Vzm_ROcDIAN934&_nc_zt=24&_nc_ht=scontent-lax3-1.xx&_nc_gid=K-EwX4gvmurTdLZNUKXkug&_nc_ss=7b289&oh=00_AQOchbO6p_l0KO8HPZbpx-xsS5c6EUuBxuN5OJrMwHHzwA&oe=6AD16E69",
      "likes": 3508125,
      "verification": "BLUE_VERIFIED",
      "entity_type": "PERSON_PROFILE",
      "ig_username": "joshnasar",
      "ig_followers": 1183394
    },
    {
      "page_id": "79209882917",
      "name": "NASA Solar System Exploration",
      "category": "Public Figure",
      "page_alias": "NASASolarSystem",
      "image_uri": "https://scontent-lax7-1.xx.fbcdn.net/v/t39.30808-1/241260165_217120870450866_7331285613217075250_n.png?stp=dst-png&cstp=mx1214x1214&ctp=s200x200&_nc_cat=105&ccb=1-7&_nc_sid=418b77&_nc_ohc=EE6dP_C3cQIQ7kNvwHUZ1ba&_nc_oc=Adq-YRMZCwRhv-cI_8pal2c343fvlfxNkBSrwQ8j1HgSBFcmwMshv9k6RjEqHBOceb4&_nc_zt=24&_nc_ht=scontent-lax7-1.xx&_nc_gid=K-EwX4gvmurTdLZNUKXkug&_nc_ss=7b289&oh=00_AQPnNSMq_O2qq2gj7xnLaOra1wFPaZeUour1tInHCaCmjQ&oe=6AD162C8",
      "likes": 5109426,
      "verification": "BLUE_VERIFIED",
      "entity_type": "PERSON_PROFILE",
      "ig_username": "nasasolarsystem",
      "ig_followers": 2718081
    },
    {
      "page_id": "202876413112285",
      "name": "NASA Artemis",
      "category": "Government Organization",
      "page_alias": "NASAArtemis",
      "image_uri": "https://scontent-lax3-1.xx.fbcdn.net/v/t39.30808-1/242064401_4441058882627329_554584327804861439_n.jpg?stp=dst-jpg_tt6&cstp=mx1079x1079&ctp=s200x200&_nc_cat=109&ccb=1-7&_nc_sid=418b77&_nc_ohc=iirzmHV7DXAQ7kNvwGltkmf&_nc_oc=Adoi17XU04HehF1ngnjJvJz4q1Ncz_BZcLGqUMLiNU-mz2a_cg6qEZ66GO7l6psx3EY&_nc_zt=24&_nc_ht=scontent-lax3-1.xx&_nc_gid=K-EwX4gvmurTdLZNUKXkug&_nc_ss=7b289&oh=00_AQMlOTCKeSTkx4wdWxUxt07hACfpMIyWaLDNSZ-ia-IXFw&oe=6AD18235",
      "likes": 4170274,
      "verification": "BLUE_VERIFIED",
      "entity_type": "PERSON_PROFILE",
      "ig_username": "nasaartemis",
      "ig_followers": 5567694
    },
    {
      "page_id": "493542940657979",
      "name": "Naša stranka",
      "category": "Political Party",
      "page_alias": "nasastranka.ba",
      "image_uri": "https://scontent-lax3-1.xx.fbcdn.net/v/t39.30808-1/793405669_1658358675653081_4344043038397180175_n.jpg?stp=dst-jpg_tt6&cstp=mx1200x1200&ctp=s200x200&_nc_cat=102&ccb=1-7&_nc_sid=418b77&_nc_ohc=AELls3xnmp4Q7kNvwHHYKgi&_nc_oc=AdpoleLb7w9KvcefzAs5Zl1M5LrpDQOVoQkc58vwIACw7svCpRzpxHpVHFGLrPBybFw&_nc_zt=24&_nc_ht=scontent-lax3-1.xx&_nc_gid=K-EwX4gvmurTdLZNUKXkug&_nc_ss=7b289&oh=00_AQNh62lYxp2RQIRczCQTGkAQN4h-Bti5gPculOibjr-Lyw&oe=6AD18FDB",
      "likes": 59627,
      "verification": "BLUE_VERIFIED",
      "entity_type": "PERSON_PROFILE",
      "ig_username": "nasastranka",
      "ig_followers": 7709
    },
    {
      "page_id": "946309125232244",
      "name": "Nasalpump",
      "category": "Product/service",
      "page_alias": "",
      "image_uri": "https://scontent-lax3-1.xx.fbcdn.net/v/t39.30808-1/615086595_122101952301203386_172418350720249438_n.jpg?stp=dst-jpg_tt6&cstp=mx1440x1440&ctp=s200x200&_nc_cat=102&ccb=1-7&_nc_sid=418b77&_nc_ohc=Yu9x_xKzxKcQ7kNvwHQWgPd&_nc_oc=AdrW5m57qMyvntIdY8xYvhjXkDe9B-CMEgxWT6esqhpLxpTeKSc3g-1gekSwucJ8fFM&_nc_zt=24&_nc_ht=scontent-lax3-1.xx&_nc_gid=K-EwX4gvmurTdLZNUKXkug&_nc_ss=7b289&oh=00_AQMupowS0cO6wVhfeQ4bATDIo0N-hTFXPA5ur99u14YAgA&oe=6AD18225",
      "likes": 2383,
      "verification": "NOT_VERIFIED",
      "entity_type": "PERSON_PROFILE",
      "ig_username": "nasalpump.shop",
      "ig_followers": 2205
    },
    {
      "page_id": "185244268335529",
      "name": "Naša super hrana",
      "category": "Government Organization",
      "page_alias": "nasasuperhrana",
      "image_uri": "https://scontent-lax3-1.xx.fbcdn.net/v/t39.30808-1/458931430_839237764999403_4214651644779961795_n.jpg?stp=dst-jpg_tt6&cstp=mx2048x1448&ctp=p200x200&_nc_cat=110&ccb=1-7&_nc_sid=418b77&_nc_ohc=7lXkTzR5f90Q7kNvwEWraSk&_nc_oc=AdpURq71E1DxvqjGoUgGd1W4VVhGbKNO2-diYvcO0eCZBd7ogsigDNieXRtgkro8168&_nc_zt=24&_nc_ht=scontent-lax3-1.xx&_nc_gid=K-EwX4gvmurTdLZNUKXkug&_nc_ss=7b289&oh=00_AQP_LA7fHYuILWVwWZCmcQAClQ8znDZ__Tqby2iFfDg8gg&oe=6AD1625F",
      "likes": 32974,
      "verification": "NOT_VERIFIED",
      "entity_type": "PERSON_PROFILE",
      "ig_username": "nasasuperhrana",
      "ig_followers": 2568
    },
    {
      "page_id": "519024461482574",
      "name": "NASA History",
      "category": "Government Organization",
      "page_alias": "NASAHistoryOffice",
      "image_uri": "https://scontent-lax3-1.xx.fbcdn.net/v/t39.30808-1/619489625_1195870842724021_2078285495526280735_n.jpg?stp=dst-jpg_tt6&cstp=mx1200x1200&ctp=s200x200&_nc_cat=1&ccb=1-7&_nc_sid=418b77&_nc_ohc=0L-e1bHK-J0Q7kNvwFxa3pB&_nc_oc=AdpUOACq9cpAYFw2xtTai11J9fdtNoJ_-sf6N0wmkOJ1c55DdLnEwDpIZnoqEroLCXA&_nc_zt=24&_nc_ht=scontent-lax3-1.xx&_nc_gid=K-EwX4gvmurTdLZNUKXkug&_nc_ss=7b289&oh=00_AQOmCzlWK3jV3vW1NhRUbcR_LW8L7-cHb-sQzGH9liV4hw&oe=6AD17319",
      "likes": 2420873,
      "verification": "BLUE_VERIFIED",
      "entity_type": "PERSON_PROFILE",
      "ig_username": "nasamoonbase",
      "ig_followers": 118800
    },
    {
      "page_id": "267875289901288",
      "name": "NASA's Johnson Space Center",
      "category": "Government Organization",
      "page_alias": "NASAJSC",
      "image_uri": "https://scontent-lax7-1.xx.fbcdn.net/v/t39.30808-1/320051371_814137286552871_2298523932649599660_n.jpg?stp=dst-jpg_tt6&cstp=mx800x800&ctp=s200x200&_nc_cat=105&ccb=1-7&_nc_sid=418b77&_nc_ohc=PzLIOCynewwQ7kNvwHNymB2&_nc_oc=AdosBKvvXKcW3QDVJF7FkYbx1N3BaW94MbmLah9qKxyCPV5d3X-wcS5RKis0N-FQKmw&_nc_zt=24&_nc_ht=scontent-lax7-1.xx&_nc_gid=K-EwX4gvmurTdLZNUKXkug&_nc_ss=7b289&oh=00_AQOoI1KopoigK45VQd0aNdMwmPrhvc_2nKguvZJawuB0JQ&oe=6AD18A7A",
      "likes": 2128592,
      "verification": "BLUE_VERIFIED",
      "entity_type": "PERSON_PROFILE",
      "ig_username": "nasajohnson",
      "ig_followers": 1574354
    },
    {
      "page_id": "116063838425155",
      "name": "NASA",
      "category": "Record label",
      "page_alias": "",
      "image_uri": "https://scontent-lax3-1.xx.fbcdn.net/v/t39.30808-1/299797474_388754093373515_7599886006600084404_n.jpg?stp=dst-jpg_tt6&cstp=mx558x720&ctp=p200x200&_nc_cat=109&ccb=1-7&_nc_sid=418b77&_nc_ohc=wVJ4yN67c1EQ7kNvwHEtp1o&_nc_oc=AdrKdtKOEK5aE9J0i8vdKctg8wOtpUaI3EvZaOnU-Hmas-BtVj_Thy2PpH4ubtp_p0A&_nc_zt=24&_nc_ht=scontent-lax3-1.xx&_nc_gid=K-EwX4gvmurTdLZNUKXkug&_nc_ss=7b289&oh=00_AQPIqh12RPmAlWb0oR3dxvVA8m84HXoy6BTyqpw8g1sRuA&oe=6AD19569",
      "likes": 1825,
      "verification": "NOT_VERIFIED",
      "entity_type": "PERSON_PROFILE",
      "ig_username": null,
      "ig_followers": null
    },
    {
      "page_id": "86505458090",
      "name": "NASA's Kennedy Space Center",
      "category": "Government Organization",
      "page_alias": "NASAKennedy",
      "image_uri": "https://scontent-lax3-1.xx.fbcdn.net/v/t39.30808-1/272663558_464027402054410_8145899201323383394_n.jpg?stp=dst-jpg_tt6&cstp=mx1258x1258&ctp=s200x200&_nc_cat=109&ccb=1-7&_nc_sid=418b77&_nc_ohc=Lqwg0pKpFdcQ7kNvwE92wNm&_nc_oc=AdqkgORv51Sz4hghgj9d4_H3MaXa3TuHAWhJlIlw59tOdDxNlWXh9vBsfQaGxFPNY5k&_nc_zt=24&_nc_ht=scontent-lax3-1.xx&_nc_gid=K-EwX4gvmurTdLZNUKXkug&_nc_ss=7b289&oh=00_AQMhK_SdPICUvkYMclFarYvgLxsD1WiCGYc3tu3eGt2QaA&oe=6AD165F1",
      "likes": 1931824,
      "verification": "BLUE_VERIFIED",
      "entity_type": "PERSON_PROFILE",
      "ig_username": null,
      "ig_followers": null
    },
    {
      "page_id": "175603359135248",
      "name": "NASA Universe",
      "category": "Government Organization",
      "page_alias": "NASAUniverse",
      "image_uri": "https://scontent-lax3-2.xx.fbcdn.net/v/t39.30808-1/272341566_298217115680003_4584897478699717817_n.jpg?stp=dst-jpg_tt6&cstp=mx1440x1440&ctp=s200x200&_nc_cat=111&ccb=1-7&_nc_sid=418b77&_nc_ohc=VSyaUPXSdzkQ7kNvwEEqpV7&_nc_oc=Adro-n0tXdOb_IoblbiCjS5-BGA2y_LPxfWx29bUfvlhlrk4TZpLUsE_qhdC8sqwMRQ&_nc_zt=24&_nc_ht=scontent-lax3-2.xx&_nc_gid=K-EwX4gvmurTdLZNUKXkug&_nc_ss=7b289&oh=00_AQPybw0uFWLqN39OfrfRTozk7oMVu0M_cSmKIuLvHoGuOA&oe=6AD18B6E",
      "likes": 1760768,
      "verification": "BLUE_VERIFIED",
      "entity_type": "PERSON_PROFILE",
      "ig_username": "nasauniverse",
      "ig_followers": 326529
    },
    {
      "page_id": "118107518236480",
      "name": "NASA Space Alerts",
      "category": "Science, Technology & Engineering",
      "page_alias": "NASASpaceAlerts",
      "image_uri": "https://scontent-lax3-2.xx.fbcdn.net/v/t39.30808-1/519897359_1148751277286627_2398819745703668374_n.jpg?stp=dst-jpg_tt6&cstp=mx1405x1369&ctp=p200x200&_nc_cat=107&ccb=1-7&_nc_sid=418b77&_nc_ohc=ucSWWllb2OYQ7kNvwGjlApu&_nc_oc=Adpwn0gl7ZSqQaCiE-0Bn8s5PkgU27JMf24pvsR98pOS8eV88oEnp3tGZ7eZIsvqRHc&_nc_zt=24&_nc_ht=scontent-lax3-2.xx&_nc_gid=K-EwX4gvmurTdLZNUKXkug&_nc_ss=7b289&oh=00_AQMNRIfhWoyhZkRH0TUXeYxXnna8V6L29pmTRCkMdCfUjw&oe=6AD16250",
      "likes": 1739701,
      "verification": "BLUE_VERIFIED",
      "entity_type": "PERSON_PROFILE",
      "ig_username": null,
      "ig_followers": null
    },
    {
      "page_id": "382651265048",
      "name": "NASA's James Webb Space Telescope",
      "category": "Science Website",
      "page_alias": "NASAWebb",
      "image_uri": "https://scontent-lax7-1.xx.fbcdn.net/v/t39.30808-1/431801464_793705439454330_18872977326830824_n.jpg?stp=dst-jpg_tt6&cstp=mx1460x2048&ctp=p200x200&_nc_cat=101&ccb=1-7&_nc_sid=418b77&_nc_ohc=hKYgsBQugkoQ7kNvwGzJW_O&_nc_oc=Adp-h05c0uMOqBEmugoSRMLaBMu7ZyOnAy9sdUz_nzcEh60b-obpeyzBn4ILbG2qvUU&_nc_zt=24&_nc_ht=scontent-lax7-1.xx&_nc_gid=K-EwX4gvmurTdLZNUKXkug&_nc_ss=7b289&oh=00_AQMSszNTNMRtPZLOpp96vh0CC_JdLwPqYRJSu5sXkV90Hw&oe=6AD165E2",
      "likes": 1726168,
      "verification": "BLUE_VERIFIED",
      "entity_type": "PERSON_PROFILE",
      "ig_username": "nasawebb",
      "ig_followers": 3575890
    }
  ],
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}

More Facebook APIs