Search and places
Apple Maps Search API
Apple Maps Places API for local business search. Query by location or coordinates and get place names, addresses, categories, and ratings as JSON.
Search Apple Maps places with a location or coordinates, regional localization and native search refinements.
Make a request
Use your existing PrismCrawl API key and credit balance. A completed request consumes one credit, including recognized empty or unavailable results and source changes found during a valid continuation. Validation and operational errors remain uncharged. Each completed continuation request is billed separately.
curl 'https://api.prismcrawl.com/v1/apple/maps/search' \
--request POST \
--header 'content-type: application/json' \
--header 'x-api-key: <PRISMCRAWL_API_KEY>' \
--data '{
"location": "Austin, TX",
"query": "coffee"
}'Supported parameters
| Parameter | Usage |
|---|---|
queryRequired | Text to search for on the selected service. |
country | Two-letter country or storefront code, such as us or gb. |
language | Provider-supported language code, such as en. |
location | Location to search around, such as Austin, TX. |
coordinates | Latitude and longitude for location targeting. |
limit | Maximum number of items to return. The provider may return fewer. |
device | Device presentation for the source request. desktop, mobile, tablet |
html | Return the encoded original response rather than parsed JSON. |
zero_trace | Do not archive source or parsed response artifacts. |
locale | Apple Maps language and region, such as en-US or fr-FR. ar-SA, bn-BD, ca-ES, cs-CZ, da-DK, de-DE, el-GR, en-AU, en-GB, en-US, es-ES, es-MX, fi-FI, fr-CA, fr-FR, gu-IN, he-IL, hi-IN, hr-HR, hu-HU, id-ID, it-IT, ja-JP, kn-IN, ko-KR, ml-IN, mr-IN, ms-MY, nb-NO, nl-NL, or-IN, pa-IN, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, sk-SK, sl-SI, sv-SE, ta-IN, te-IN, th-TH, tr-TR, uk-UA, ur-PK, vi-VN, zh-CN, zh-HK, zh-TW |
center | Search center as latitude,longitude; use exactly one of center, coordinates, or location. |
span | Region size as latitudeDelta,longitudeDelta; both must be positive, at most 180 and 360 respectively. |
sort_by | The provider's supported sort order. default, distance, ratings |
toggles | Comma-separated toggle keys returned in filters. |
multi_select_options | Comma-separated multi-select option keys returned in filters. |
open_at | Future Unix timestamp no more than 24 hours from the current time. |
Structured results
Read items from data.content.results. The response also includes the search metadata, pagination state, and any extracted SERP features. Optional fields appear when supplied by the provider.
addressaddress_linescategorycoordinatesdescriptionenginehoursidlatitudelongitudenamephonepositionrankratingrating_maxrating_sourcereview_countsnippetthumbnailtitletypeurlwebsiteSDKs and guides
The official SDKs cover this endpoint with typed parameters, automatic retries, and pagination helpers.
- Python SDK:
pip install prismcrawl - Node.js SDK:
npm install prismcrawl