datasets_google_map_search
Search stored Google Maps business records by query, location, category, rating, review count, and closure status, then sort and filter results for lead or market research.
Instructions
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).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | 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) | |
| lat | No | Latitude for radius filtering or distance sort | |
| lon | No | Longitude for radius filtering or distance sort | |
| city | No | Exact city filter, max 128 characters | |
| page | No | Page number, defaults to 1 | |
| sort | No | Sort enum: relevance, updated_at_desc, rating_desc, review_count_desc, distance_asc | |
| town | No | Exact town filter, max 128 characters | |
| state | No | Exact state filter, max 128 characters | |
| county | No | Exact county filter, max 128 characters | |
| country | No | Country filter. Accepts the full English name (\ | |
| has_geo | No | Filter by location presence: true keeps only mappable businesses with coordinates; false isolates locationless service-area businesses that have no map location | |
| category | No | Exact locale-specific Google Maps category label; use the category facet to discover values, max 128 characters | |
| radius_m | No | Radius in meters, 1 through 50000; requires lat and lon when supplied | |
| has_phone | No | Filter by phone presence | |
| page_size | No | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 | |
| min_rating | 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. | |
| state_code | 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 | 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 | |
| has_website | No | Filter by website presence | |
| min_review_count | No | Minimum review count | |
| permanently_closed | 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. |