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 ISO 3166-2 codes populated today only for Canadian provinces and territories (e.g. `CA-ON`) and Irish counties (e.g. `IE-D`); every other record, including all US rows, carries no code and is 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; every term must match the name, address, headline or category (filler words such as in, near and the are ignored) | |
| 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. CA-ON, max 128 characters. Only Canadian provinces and territories carry a code today, so US codes such as US-NV return no rows; filter other countries by state, county or city. Use facet=state_code to list values | |
| county_code | string | No | Exact ISO 3166-2 county/district code filter, e.g. IE-D, max 128 characters. Only Irish counties carry a code today; filter other countries by county or city. Use facet=county_code to list 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.