Endpoint Playground
Returns up to 50 creator-facet buckets ordered by count, using the same filters as `datasets_creators_search`. Page and page_size do not change the aggregation. Deleted/private accounts remain excluded unless include_inactive=true. Contact-email values are never returned. Facet enum: `niche`, `country`, `verified`. Dataset Playground requests query indexed data and do not apply proxy routing.
curl 'https://api.crawlora.net/api/v1/datasets/creators/facets?facet=niche&sort=followers_desc' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| facet | string | Yes | niche | Facet field |
| q | string | No | Full-text query over handle, nickname and bio | |
| handle | string | No | Exact creator handle | |
| niche | string | No | Exact content niche | |
| country | string | No | Exact creator country/region | |
| verified | boolean | No | Verified badge filter | |
| min_followers | integer | No | Minimum follower count | |
| has_email | boolean | No | Contact-email presence filter | |
| include_inactive | boolean | No | Include deleted/private accounts | |
| sort | string | No | followers_desc | Validated search sort; bucket order stays count-desc, and time-series date_desc keeps its search history scope |
| page | integer | No | Result page, 1-based | |
| page_size | integer | No | Page size, default 20 and max 100 |
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "creators",
"facet": "niche",
"items": [
{
"value": "gaming",
"count": 500
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.