Datasets

Facet stored Google Maps businesses

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.

get/datasets/google-map-businesses/facets

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/datasets/google-map-businesses/facets
  • Auth: API key in header x-api-key

Query parameters

facet'category' | 'country' | 'state' | 'state_code' | 'county' | 'county_code' | 'city' | 'town' | 'website_status' required

Facet enum: category, country, state, state_code, county, county_code, city, town, website_status

qstring

Full-text business search query, max 256 characters

categorystring

Exact locale-specific Google Maps category label; use the category facet to discover values, max 128 characters

countrystring

Country filter. Accepts the full English name (\

statestring

Exact state filter, max 128 characters

countystring

Exact county filter, max 128 characters

state_codestring

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_codestring

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

citystring

Exact city filter, max 128 characters

townstring

Exact town filter, max 128 characters

min_ratingnumber

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_countinteger

Minimum review count

has_websiteboolean

Filter by website presence

has_phoneboolean

Filter by phone presence

has_geoboolean

Filter by location presence: true keeps only mappable businesses with coordinates; false isolates locationless service-area businesses that have no map location

permanently_closedboolean

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.

latnumber

Latitude for radius filtering

lonnumber

Longitude for radius filtering

radius_minteger

Radius in meters, 1 through 50000; requires lat and lon when supplied

sort'relevance' | 'updated_at_desc' | 'rating_desc' | 'review_count_desc' | 'distance_asc'

Sort enum: relevance, updated_at_desc, rating_desc, review_count_desc, distance_asc

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.