datasets_apple_maps_places_search
Search stored Apple Maps places by name, category, location, rating, contact details, and sort results to find businesses without live scraping.
Instructions
Search stored Apple Maps places. Searches the stored Apple Maps place directory (dataset id apple-maps-places), built by tiling populated areas and running category searches over each tile. Each place has its Apple place id, name, category path, address, coordinates, phone, website, opening hours, rating and price level where Apple shows them. Coverage is observed, not complete: Apple answers each search with at most 25 places, so very dense areas can hold places the directory has not reached, and a place missing from the results is not evidence that it does not exist or has closed. A rating of null means Apple shows no rating for the place (never a zero-star score); ratings and rating counts come from third-party review partners that Apple shows (for example Yelp and Foursquare), so they are not comparable across places and a few places carry a rating with no count. Supports full-text q, category/city/state/country_code/postal_code filters, min_rating, min_rating_count, has_website, has_phone, lat/lon/radius_m radius filtering, and sort (relevance, rating_desc, review_count_desc, updated_at_desc, distance_asc). Does not trigger live scraping. 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 search over place name, category, city and address; every term must match. Max 256 characters | |
| lat | No | Latitude for radius filtering or distance sort, requires lon | |
| lon | No | Longitude for radius filtering or distance sort, requires lat | |
| city | No | Exact city filter, max 128 characters | |
| page | No | Page number, defaults to 1 | |
| sort | No | Sort enum: relevance, rating_desc, review_count_desc, updated_at_desc, distance_asc. Defaults to relevance with q, otherwise updated_at_desc | |
| state | No | Exact state/region filter, max 128 characters | |
| category | No | Exact Apple category name, max 128 characters, e.g. Coffee Shop; use facet=category to discover values | |
| radius_m | No | Radius in meters, 1 through 50000; requires lat and lon | |
| has_phone | No | true keeps only places with a phone number; false keeps only places without one | |
| page_size | No | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 | |
| min_rating | No | Minimum rating, from 0 through 5; any value above 0 excludes unrated places | |
| has_website | No | true keeps only places with a website; false keeps only places without one | |
| postal_code | No | Exact postal code filter, max 128 characters | |
| country_code | No | ISO 3166-1 alpha-2 country filter, e.g. US, GB, JP | |
| min_rating_count | No | Minimum number of ratings behind the rating, 0 or greater |