Facebook Search Pages API
Scrape Facebook Search Pages data with one API call. Searches public Facebook pages by keyword and returns unified Author items: page id, display name, permalink, avatar, and verified flag. Follower counts are not on this search card; take a matching `author.url` to `/v1/facebook/profile` for the full page. About 7 pages a page. Forward `pagination.next_cursor` as `cursor`.
Last updated October 2026Maintained by the SocialCrawl team
Returns Facebook pages matching a keyword, each with page id, display name, permalink, avatar, and verified flag.
Use it to find pages by name; follower counts are not on this card, so take author.url to profile for the full page.
Searching 68 platforms in parallel
What can you do with the Search Pages API?
The Search Pages endpoint gives you structured Facebook data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/facebook/search/pages?query=NASA"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/facebook/search/pages",
params={
'query': 'NASA',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/facebook/search/pages?query=NASA",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| query | Yes | Keyword or phrase to search for. |
| cursor | No | Cursor from the previous response. |
| location_uid | No | Facebook location id to scope the search. |
What does the Facebook Search Pages API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "facebook",
"endpoint": "/v1/facebook/search/pages",
"data": {
"items": [
{
"author": {
"id": "user_9e601d",
"username": "user_06552e",
"display_name": "user_4da615",
"avatar_url": "https://example.com/avatars/user_293b8b.png",
"bio": null,
"verified": true,
"followers": null,
"following": null,
"posts_count": null,
"likes_count": null,
"url": "https://example.com/user_826270",
"private": null,
"joined_at": null
}
},
{
"author": {
"id": "user_f0f00a",
"username": "user_197696",
"display_name": "user_dc15e2",
"avatar_url": "https://example.com/avatars/user_4a0082.png",
"bio": null,
"verified": true,
"followers": null,
"following": null,
"posts_count": null,
"likes_count": null,
"url": "https://example.com/user_36cfd4",
"private": null,
"joined_at": null
}
}
],
"next_cursor": "{\"page_number\": 0, \"flow_cursors_serialized\": {\"INTERNAL_DEBUG_MODULE\": \"{}\", \"SEARCH_CONTROLS_INTERCEPT\": \"{}\", \"INTEGRITY\": \"{\\\"has_more_results\\\":false,\\\"processed_unicorn_ids\\\":[],\\\"is_end_of_serp\\\":false}\", \"SPELLER\": \"{}\", \"PAGES_TAB\": \"{\\\"has_more_results\\\": true, \\\"browse_cursor_serialized\\\": \\\"AbqxAahmcx3cc4Y7KYnlA9aWhvxtDhIaVO71jBE3ezPvA8BTckSxhagDuSlyKbefJXZ7cd1N7Gk77kq0VfMstgAqrCAAt9p2tqLXLDSVe-A1g9h315ZhiahhkqA31Tf5rMx40O_0-51muajDlSHF0Pu3svmhygILG9sN3I2l7S4J4h8H3P-l6k4jOFYWGvjNfvBbJLNLFPeBJgZ5fTg3eFw16f9CseueUmehW42esWjCP97u_o_oNPmjH6LLamA4XQlCxATKlaI11N9c98PpsXVdpbUqkh9NMQmusQPmZUmCsqnsC4zH4CJ-cNxqJjfYcZw0pH_zZWSNVoP3K8qEsTcbyYDwEpsLoiq1NzmnEnH_YF73LVBAOG25378WnKajOzPFP4IMabTun3SaJI--FWaLUNPNz6Qil9-TDf9sjTwCYIfsC-bWDKxajGVamA93nCGSyQVjAhm-J1r-Iypw8qOd37lqy8YaQ_0I5Pg6gSc3zmL3ZX2HIfVe4l0-MTMiKu0bQ9wQu7ufyqP344mmZkvJlIfrkvtnlNUkdDHKodX7_Q\\\", \\\"processed_unicorn_ids\\\": [], \\\"is_end_of_serp\\\": false}\"}, \"result_ids_shown\": [], \"unit_id_logging_fields\": {\"num_total_modules\": 1, \"num_total_results\": 7, \"num_total_vertical_results\": 7}, \"entity_ids_shown_by_type\": {}, \"processed_unicorn_ids\": [], \"completed_flows\": [\"INTERNAL_DEBUG_MODULE\", \"SEARCH_CONTROLS_INTERCEPT\", \"INTEGRITY\", \"SPELLER\"], \"custom_cursors_serialized\": {}}",
"total": null,
"dropped": 0
},
"credits_used": 1,
"request_id": "req_example000000",
"cached": false,
"pagination": {
"next_cursor": "sc.eyJ2IjoyLCJjIjoie1wicGFnZV9udW1iZXJcIjogMCwgXCJmbG93X2N1cnNvcnNfc2VyaWFsaXplZFwiOiB7XCJJTlRFUk5BTF9ERUJVR19NT0RVTEVcIjogXCJ7fVwiLCBcIlNFQVJDSF9DT05UUk9MU19JTlRFUkNFUFRcIjogXCJ7fVwiLCBcIklOVEVHUklUWVwiOiBcIntcXFwiaGFzX21vcmVfcmVzdWx0c1xcXCI6ZmFsc2UsXFxcInByb2Nlc3NlZF91bmljb3JuX2lkc1xcXCI6W10sXFxcImlzX2VuZF9vZl9zZXJwXFxcIjpmYWxzZX1cIiwgXCJTUEVMTEVSXCI6IFwie31cIiwgXCJQQUdFU19UQUJcIjogXCJ7XFxcImhhc19tb3JlX3Jlc3VsdHNcXFwiOiB0cnVlLCBcXFwiYnJvd3NlX2N1cnNvcl9zZXJpYWxpemVkXFxcIjogXFxcIkFicXhBYWhtY3gzY2M0WTdLWW5sQTlhV2h2eHREaElhVk83MWpCRTNlelB2QThCVGNrU3hoYWdEdVNseUtiZWZKWFo3Y2QxTjdHazc3a3EwVmZNc3RnQXFyQ0FBdDlwMnRxTFhMRFNWZS1BMWc5aDMxNVpoaWFoaGtxQTMxVGY1ck14NDBPXzAtNTFtdWFqRGxTSEYwUHUzc3ZtaHlnSUxHOXNOM0kybDdTNEo0aDhIM1AtbDZrNGpPRllXR3ZqTmZ2QmJKTE5MRlBlQkpnWjVmVGczZUZ3MTZmOUNzZXVlVW1laFc0MmVzV2pDUDk3dV9vX29OUG1qSDZMTGFtQTRYUWxDeEFUS2xhSTExTjljOThQcHNYVmRwYlVxa2g5Tk1RbXVzUVBtWlVtQ3NxbnNDNHpINENKLWNOeHFKamZZY1p3MHBIX3paV1NOVm9QM0s4cUVzVGNieVlEd0Vwc0xvaXExTnptbkVuSF9ZRjczTFZCQU9HMjUzNzhXbkthak96UEZQNElNYWJUdW4zU2FKSS0tRldhTFVOUE56NlFpbDktVERmOXNqVHdDWUlmc0MtYldES3hhakdWYW1BOTNuQ0dTeVFWakFobS1KMXItSXlwdzhxT2QzN2xxeThZYVFfMEk1UGc2Z1NjM3ptTDNaWDJISWZWZTRsMC1NVE1pS3UwYlE5d1F1N3VmeXFQMzQ0bW1aa3ZKbElmcmt2dG5sTlVrZERIS29kWDdfUVxcXCIsIFxcXCJwcm9jZXNzZWRfdW5pY29ybl9pZHNcXFwiOiBbXSwgXFxcImlzX2VuZF9vZl9zZXJwXFxcIjogZmFsc2V9XCJ9LCBcInJlc3VsdF9pZHNfc2hvd25cIjogW10sIFwidW5pdF9pZF9sb2dnaW5nX2ZpZWxkc1wiOiB7XCJudW1fdG90YWxfbW9kdWxlc1wiOiAxLCBcIm51bV90b3RhbF9yZXN1bHRzXCI6IDcsIFwibnVtX3RvdGFsX3ZlcnRpY2FsX3Jlc3VsdHNcIjogN30sIFwiZW50aXR5X2lkc19zaG93bl9ieV90eXBlXCI6IHt9LCBcInByb2Nlc3NlZF91bmljb3JuX2lkc1wiOiBbXSwgXCJjb21wbGV0ZWRfZmxvd3NcIjogW1wiSU5URVJOQUxfREVCVUdfTU9EVUxFXCIsIFwiU0VBUkNIX0NPTlRST0xTX0lOVEVSQ0VQVFwiLCBcIklOVEVHUklUWVwiLCBcIlNQRUxMRVJcIl0sIFwiY3VzdG9tX2N1cnNvcnNfc2VyaWFsaXplZFwiOiB7fX0iLCJlIjoiZmFjZWJvb2svc2VhcmNoL3BhZ2VzIiwicCI6ImN1cnNvciJ9",
"has_more": true,
"page_size": 7
},
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-02T12:42:37.076Z",
"redacted": true
}Live sample illustrating the unified response shape. Field values reflect the record you query.
How does the Facebook Search Pages API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 68 platforms covering 10B+ monthly active users.
One schema, every platform
Query 68 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Ready to scrape Facebook Search Pages data?
Get your API key and start pulling Facebook data in under 60 seconds.
