Datasets

Search the Facebook Pages dataset

Searches public Facebook Page contact records stored in a search index — website, email, phone, WhatsApp, category and like count, discovered through business-search enumeration, domain-scoped scans, and Wikidata seeding, then hydrated from each Page's public About tab. Sort enum: relevance, likes_desc, likes_asc, hydrated_at_desc, hydrated_at_asc. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).

get/datasets/facebook-pages/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/datasets/facebook-pages/search
  • Auth: API key in header x-api-key

Query parameters

qstring

Full-text query over title and address, max 256 characters

page_idstring

Exact Facebook Page id filter, max 128 characters

identifierstring

Exact Page username/identifier filter (case-insensitive), max 128 characters

categorystring

Exact Page category filter (case-insensitive), max 128 characters

discovery_sourcestring

Exact filter for how the Page was discovered (e.g. business_search, warc_domain_scan, wikidata), max 128 characters

has_websiteboolean

Filter by a linked website

has_emailboolean

Filter by a public contact email

has_phoneboolean

Filter by at least one public phone number

has_whatsappboolean

Filter by a public WhatsApp contact

min_likesinteger

Minimum Page like count

max_likesinteger

Maximum Page like count

hydrated_afterstring

Records last refreshed on or after this date (RFC3339 or YYYY-MM-DD)

hydrated_beforestring

Records last refreshed on or before this date (RFC3339 or YYYY-MM-DD)

sort'relevance' | 'likes_desc' | 'likes_asc' | 'hydrated_at_desc' | 'hydrated_at_asc'

Sort enum: relevance, likes_desc, likes_asc, hydrated_at_desc, hydrated_at_asc

pageinteger

Page number, defaults to 1

page_sizeinteger

Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.