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

# Facet the Facebook Pages dataset

`GET /datasets/facebook-pages/facets`

## Request

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

Returns value counts for the Facebook Pages dataset, by the required `facet`: `category` or `discovery_source`. Search filters such as `q`, `min_likes` and `has_email` narrow the counts. Default order is most common first; `order=value_asc` pages alphabetically using `after` and `next_after`, with `limit` up to 200.

## Query parameters

- `limit` integer
- `order` 'count_desc' | 'value_asc'
- `after` string
- `facet` 'category' | 'discovery_source', required
- `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'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsFacebookPagesFacetResponseDoc
  - `code` integer
  - `data` DatasetsFacebookPageFacetResponse
    - `dataset` string
    - `facet` string
    - `items` EsFacebookPageDatasetFacetItem[]
      - `count` integer
      - `value` string
    - `next_after` string
  - `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)