Endpoint Playground
Returns terms aggregation counts for Google Maps businesses. Facet enum: `category`, `country`, `state`, `state_code`, `county`, `county_code`, `city`, `town`, `website_status`. Category facet values are exact locale-specific Google Maps labels and can be localized, non-ASCII, or contain punctuation; pass a returned value unchanged to the category filter. `state` and `county` keep each country's own administrative vocabulary (e.g. `Provincia de Madrid`, `Département du Nord`); `state_code` and `county_code` are the matching ISO 3166-2 codes (e.g. `ES-MD`, `FR-59`) and are the stable cross-country grouping key. Rows not yet resolved carry no code and are absent from the code facets. Dataset Playground requests query indexed data and do not apply proxy routing.
14 Oct 2026: 50 items; 2 fields had a value in every checked item.
Sample value profiles: count: 443,789 to 20,087,280, median 1,093,078.
curl "https://api.crawlora.net/api/v1/datasets/google-map-businesses/facets?facet=category&sort=relevance" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| facet | string | Yes | category | Facet enum: category, country, state, state_code, county, county_code, city, town, website_status |
| q | string | No | Full-text business search query, max 256 characters | |
| category | string | No | Exact locale-specific Google Maps category label; use the category facet to discover values, max 128 characters | |
| country | string | No | Country filter. Accepts the full English name (\ | |
| state | string | No | Exact state filter, max 128 characters | |
| county | string | No | Exact county filter, max 128 characters | |
| state_code | string | No | Exact ISO 3166-2 state/region code filter, e.g. US-CA or FR-HDF, max 128 characters; use facet=state_code to discover values | |
| county_code | string | No | Exact ISO 3166-2 county/district code filter, e.g. FR-59 or IT-RM, max 128 characters; use facet=county_code to discover values | |
| city | string | No | Exact city filter, max 128 characters | |
| town | string | No | Exact town filter, max 128 characters | |
| min_rating | number | No | Minimum rating, 0 through 5. Businesses with no aggregate Google rating are returned with rating null, so any min_rating above 0 excludes them. | |
| min_review_count | integer | No | Minimum review count | |
| has_website | boolean | No | Filter by website presence | |
| has_phone | boolean | No | Filter by phone presence | |
| has_geo | boolean | No | Filter by location presence: true keeps only mappable businesses with coordinates; false isolates locationless service-area businesses that have no map location | |
| permanently_closed | boolean | No | Closure filter. true keeps only businesses Google marks Permanently closed; false excludes them, keeping every business not known to be closed. Most rows have never been status-checked and are returned with permanently_closed null, which means unknown, not open. | |
| lat | number | No | Latitude for radius filtering | |
| lon | number | No | Longitude for radius filtering | |
| radius_m | integer | No | Radius in meters, 1 through 50000; requires lat and lon when supplied | |
| sort | string | No | relevance | Sort enum: relevance, updated_at_desc, rating_desc, review_count_desc, distance_asc |
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "google-map-businesses",
"facet": "city",
"items": [
{
"value": "San Francisco",
"count": 42
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.