All APIs

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.

POST /v1/apple/maps/search
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

ParameterUsage
queryRequiredText to search for on the selected service.
countryTwo-letter country or storefront code, such as us or gb.
languageProvider-supported language code, such as en.
locationLocation to search around, such as Austin, TX.
coordinatesLatitude and longitude for location targeting.
limitMaximum number of items to return. The provider may return fewer.
deviceDevice presentation for the source request.

desktop, mobile, tablet

htmlReturn the encoded original response rather than parsed JSON.
zero_traceDo not archive source or parsed response artifacts.
localeApple 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

centerSearch center as latitude,longitude; use exactly one of center, coordinates, or location.
spanRegion size as latitudeDelta,longitudeDelta; both must be positive, at most 180 and 360 respectively.
sort_byThe provider's supported sort order.

default, distance, ratings

togglesComma-separated toggle keys returned in filters.
multi_select_optionsComma-separated multi-select option keys returned in filters.
open_atFuture 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_countsnippetthumbnailtitletypeurlwebsite

SDKs and guides

The official SDKs cover this endpoint with typed parameters, automatic retries, and pagination helpers.