Datasets

Search stored Google Maps businesses

Searches Google Maps business records stored in a search index. Sort enum: relevance, updated_at_desc, rating_desc, review_count_desc, distance_asc. category is the exact Google Maps category label returned for the business locale; it can be localized, non-ASCII, or contain punctuation, so use the category facet to discover exact filter values. A rating of null means no aggregate rating is available. A review_count of null means Google did not return a count; numeric 0 means Google confirmed zero reviews. rating_desc sorts unrated businesses last, and min_rating above 0 excludes them. Use has_geo=false to isolate locationless service-area businesses (which have a null geo). A permanently_closed of true means Google marks the business permanently closed; false means a crawl confirmed it does not; null means the business has not been status-checked since capture shipped on 2026-08-31 and is UNKNOWN, not open — so any total computed from this dataset includes an unknown number of closed businesses. Use permanently_closed=false to exclude the confirmed-closed ones. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).

get/datasets/google-map-businesses/search

Request

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

Query parameters

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 or distance sort

lonnumber

Longitude for radius filtering or distance sort

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

pageinteger

Page number, defaults to 1

page_sizeinteger

Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Changes

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