Facebook Search Profiles API documentation

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.

curl --fail-with-body --request POST 'https://ecll-litescrape-v3--site-api-web.modal.run/api/facebook/search-profiles' \ --header "Authorization: Bearer $LITESCRAPE_API_KEY" \ --header 'Content-Type: application/json' \ --data '{ "query": "Nasa", "limit": 12 }'

JSON POST request example

POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/facebook/search-profiles with Content-Type: application/json and your Authorization: Bearer header.

{
  "query": "Nasa",
  "limit": 12
}

// request reference

Facebook Search Profiles parameters

Send query parameters with GET /api/facebook/search-profiles. 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 profiles by name and return displayed names and profile links. Returns up to 12 results. Pagination and enriched profile details are unavailable.

query

QueryRequired

Name to search for.

Type string · GET query or POST JSON

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

limit

LimitOptional

Maximum profiles per response; fewer may be available.

Type integer · GET query or POST JSON · Default 12

Minimum: 1
Maximum: 12

// 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, coverage, incomplete, profiles, 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.

{
  "source_url": "https://www.facebook.com/public/Nasa",
  "coverage": "initial",
  "incomplete": false,
  "profiles": [
    {
      "name": "Na Sa",
      "url": "https://www.facebook.com/people/Na-Sa/pfbid02cHnxbBTe132Vezx47MEcgMatmaNJvCrojfeES5ykoyrJRN6Ffm35wfaPx2FFem3Zl/"
    },
    {
      "name": "America America (Nasa)",
      "url": "https://www.facebook.com/people/America-America/pfbid02C8X1pkTQ6FzwbdN8WstiKaLbc94qVgJZbGVKs2Pr3Gravesraa6yRLdKPgZCZwR3l/"
    },
    {
      "name": "Nasa Sz",
      "url": "https://www.facebook.com/people/Nasa-Sz/pfbid0yoC523JVRzCc73uC8HMJtzxtB7rD4QGyjCQkg7zSn4hgN7CQ31wroH3fNcryRvcql/"
    },
    {
      "name": "NA SA",
      "url": "https://www.facebook.com/people/NA-SA/pfbid02h3SRMUmhND9ZnaRjuShgekB1i3sBrGDgoh3vekJDtynuYczRX9nx5PtRfP2S9eHHl/"
    },
    {
      "name": "Nasa Ra",
      "url": "https://www.facebook.com/people/Nasa-Ra/pfbid0dEqSzYkDLAo2fU2QGGP5SR6a3Pmn97Jj5NbodEtHjP7Hm5FeJNrBMcaKwFA5tN6rl/"
    },
    {
      "name": "NaSa Ci",
      "url": "https://www.facebook.com/people/NaSa-Ci/pfbid031YyUKhpHEivLhFbb8dAB4uYdK1NkAn6S4JjpzsV9grSXjPmZ4QvhkdknEMwrruLSl/"
    },
    {
      "name": "Nasa Nasa",
      "url": "https://www.facebook.com/people/Nasa-Nasa/pfbid02gWkYDmL8LCLCAPxEAfgzXEYSJQwb1EwgPZ5nGBPuZX6TgvaBuzhiXqtjnUNqDfTVl/"
    },
    {
      "name": "Na Sa",
      "url": "https://www.facebook.com/people/Na-Sa/pfbid0JeAh2oEDpjr7TLKE31ec16GJ9RJeFmo4k5DGwgGTWorMLuKXuxa8DFBKCvAXRj1Zl/"
    },
    {
      "name": "Nasa Nasa Nanamat",
      "url": "https://www.facebook.com/people/Nasa-Nasa-Nanamat/pfbid0X7FK9RgvigCxP7VDJhXtx1wW6tCSVjCzcL3bHLv8QdfNQFHaWnNDMYTF1ZEpBFNXl/"
    },
    {
      "name": "Nasa Eze",
      "url": "https://www.facebook.com/people/Nasa-Eze/pfbid02GimjfcrqckFBKnyoZAiht4bKn66BkAFpuLqRCqXHHNFpYs9qsEn9GsH4PiTH6GF9l/"
    },
    {
      "name": "Nasa Raja",
      "url": "https://www.facebook.com/people/Nasa-Raja/pfbid02epgR2XwQpNscNc9DZKXc9dXaZny1EE5Q1UxPJDG9GhNspRRjMihRKe1gJBLyF2rel/"
    },
    {
      "name": "Lukas Nasa",
      "url": "https://www.facebook.com/people/Lukas-Nasa/pfbid0gDw8jmzzo7BMRqGf3qPMiW5PvB1epjfTjBygnzoHEra8Ps53fJTrxuVt3AnNMNrdl/"
    }
  ],
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}

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

Facebook Search Profiles API Alpha

Integrate Facebook Search Profiles

JSON POST request example

Facebook Search Profiles parameters

Request parameters

Work with the complete JSON response

More Facebook APIs