Endpoint Playground
Returns terms aggregation counts for the stored Apple Maps place directory. Facet enum: `category`, `country_code`, `state`, `city`, `price_symbol`, `catalog_country`. Accepts the same filter parameters as search to scope the aggregation. Use `facet=category` to discover the exact category names the `category` filter accepts. Dataset Playground requests query indexed data and do not apply proxy routing.
26 Oct 2026: Single record response; 2 fields had a value in every checked item; 1 field was empty in this sample.
curl 'https://api.crawlora.net/api/v1/datasets/apple-maps-places/facets?facet=category' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| facet | string | Yes | category | Facet enum: category, country_code, state, city, price_symbol, catalog_country |
| q | string | No | Full-text search over place name, category, city and address | |
| category | string | No | Exact Apple category name | |
| city | string | No | Exact city filter | |
| state | string | No | Exact state/region filter | |
| country_code | string | No | ISO 3166-1 alpha-2 country filter | |
| postal_code | string | No | Exact postal code filter | |
| min_rating | number | No | Minimum rating, from 0 through 5 | |
| min_rating_count | integer | No | Minimum number of ratings behind the rating | |
| has_website | boolean | No | Website presence filter | |
| has_phone | boolean | No | Phone presence filter | |
| lat | number | No | Latitude for radius filtering, requires lon | |
| lon | number | No | Longitude for radius filtering, requires lat | |
| radius_m | integer | No | Radius in meters, 1 through 50000; requires lat and lon |
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "apple-maps-places",
"facet": "category",
"items": [
{
"key": "Coffee Shop",
"count": 120
},
{
"key": "Restaurant",
"count": 95
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.