Search and places

Apple Maps Reviews API

Apple Maps Reviews API returning Apple's attributed reviews for a place, with full publisher text for linked Yelp and Tripadvisor reviews when available.

Return Apple Maps' attributed review selection. Exact linked Yelp and Tripadvisor reviews include complete publisher text when available; other rows remain marked excerpts. Apple provides no additional review pages.

Try in the request builder API reference Connect with MCP

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/reviews

curl 'https://api.prismcrawl.com/v1/apple/maps/reviews' \
  --request POST \
  --header 'content-type: application/json' \
  --header 'x-api-key: <PRISMCRAWL_API_KEY>' \
  --data '{
  "id": "I15FF30DE01EC121F"
}'

Supported parameters

Parameter	Usage
`id`Required	The provider's identifier, as returned by its search results.
`language`	Provider-supported language code, such as en.
`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

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.

Apple publishes a limited selection of attributed reviews. When an exact linked Yelp or Tripadvisor review is available, its complete publisher text is returned with full_text_available: true and is_excerpt: false. Other items retain Apple's excerpt and report the opposite flags. Search metadata reports full_text_available: true only when every returned item has complete text. pagination_limited: true still applies; Apple provides no additional review pages.

If the source explicitly reports that it cannot find the requested place, the API returns a billable HTTP 200 empty result with place_not_found: true andsource_result_count: 0 in search metadata. No continuation is returned.

authorauthor_imageauthor_urldatedate_textdeveloper_responseenginefull_text_availablehelpful_votesidis_excerptlanguagenamephotosplace_idpositionpublished_atrankratingrating_maxsourcetextthumbnailtitletypeupdated_aturlversionvote_count

SDKs 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