Search Apple Maps places near a coordinate
Returns Apple Maps places matching a keyword, business name, category, or street address near a coordinate. Each place carries its Apple place ID (the value the place endpoint takes), name, category, coordinates, formatted and structured address, phone, website, rating and review count, price level, weekly opening hours, and a hero photo. Apple returns a bounded set per viewport (around 25 places for the default span) with no pagination; widen the span or move the center to cover more area. When nothing matches near the center Apple may relocate the search to a default region, reported by relocated=true and the region bounds. The response's filters block lists the refinement chips Apple offers for this query and area (open now, top rated, in guides, cuisines, price bands, amenities, accolades, sort); pass their keys back as filters and sort to refine the same search.
Request
- Base URL: https://api.crawlora.net/api/v1
- URL: https://api.crawlora.net/api/v1/apple-maps/search
- Auth: API key in header x-api-key
Query parameters
Keyword, business name, category, or street address to search for
Search center latitude
Search center longitude
Search viewport size in degrees of latitude/longitude around the center. Defaults to 0.05 (roughly a 5km box); minimum 0.001, maximum 5.
Max places returned. Defaults to 25, maximum 100.
Display language as a BCP 47 tag, e.g. en-US, ja-JP, de-DE. Defaults to en-US.
Two-letter ISO 3166-1 country code selecting Apple's regional catalog. Defaults to US.
Comma-separated filter keys from the filters block of an unfiltered search for the same query and area, e.g. OPEN_NOW, TOP_RATED, FEATURED_IN_GUIDES, PRICE_RANGE_MODERATE, modern_pizza_restaurant, ACCEPTS_CREDIT_CARDS. Unknown keys return 400 listing the available keys. Costs a second upstream search.
Result order. Costs a second upstream search.
Headers
API key required
Response
OK
Changes
No recorded changes to this operation across all 2 revisions of this API.