Search and places

Apple Maps Reviews API

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.

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.

idtitlenameurlpositionthumbnailratingtextauthorauthor_urlauthor_imagedatedate_textpublished_atupdated_atlanguagephotosversionhelpful_votesvote_countsourceis_excerptfull_text_availablerating_maxdeveloper_response