---
title: "Search the Facebook Pages dataset"
method: GET
path: "/datasets/facebook-pages/search"
tags: ["Datasets"]
---

# Search the Facebook Pages dataset

`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`

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).

## Query parameters

- `q` string
- `page_id` string
- `identifier` string
- `category` string
- `discovery_source` string
- `has_website` boolean
- `has_email` boolean
- `has_phone` boolean
- `has_whatsapp` boolean
- `min_likes` integer
- `max_likes` integer
- `hydrated_after` string
- `hydrated_before` string
- `sort` 'relevance' | 'likes_desc' | 'likes_asc' | 'hydrated_at_desc' | 'hydrated_at_asc'
- `page` integer
- `page_size` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsFacebookPagesSearchResponseDoc
  - `code` integer
  - `data` DatasetsFacebookPageSearchResponse
    - `dataset` string
    - `items` EsFacebookPageDatasetItem[]
      - `address` string
      - `category` string
      - `contact_observed_at` object
      - `discovered_at` string
      - `discovery_source` string
      - `email` string
      - `hydrated_at` string
      - `identifier` string
      - `likes` integer
      - `page_id` string
      - `phones` string[]
      - `source_url` string
      - `status` string
      - `title` string
      - `website` string
      - `whatsapp` string
    - `page` integer
    - `page_size` integer
    - `sort` string
    - `total` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)