{"uid":"cap_-MARKdxs0nsau3x5Zzs1-","slug":"agents-litescrape-com-get-apple-maps-ratings-and-reviews-d69cd99b","name":"Get Apple Maps Ratings and Reviews","description":"Returns the ratings and written reviews Apple attributes to one place identified by its MUID: rating_summary, the ratings breakdown, and reviews with rating, text, and date. Set locale for the language and regional formatting. Allow up to 120 seconds for a response. One call is one request.","url":"https://agents.litescrape.com/api/apple/maps/reviews","method":"GET","headers":{},"bodySchema":{"type":"object","required":["muid"],"properties":{"muid":{"type":"string","description":"Exactly one Apple Maps place ID."},"locale":{"type":"string","default":"en-US","description":"Language-region locale such as en-US or en-GB."}}},"responseSchema":{"type":"object","properties":{"ratings":{"type":"array","items":{"type":"object"},"description":"Ratings breakdown."},"reviews":{"type":"array","items":{"type":"object"},"description":"Written reviews: rating, text, date."},"pagination":{"type":"object","description":"Present when more results exist: next (a ready-made URL for the next page) or next_page_token."},"rating_summary":{"type":"object","description":"Overall rating and counts."},"search_metadata":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"total_time_taken":{"type":"number"}}},"search_parameters":{"type":"object","description":"The request parameters as normalized by the API."}},"description":"Successful responses carry request metadata, the normalized parameters, and the result groups available for the operation. Optional groups are omitted when the source does not provide them. Errors are a JSON body with error, error_code, status_code, request_id, retryable, and the echoed search_parameters."},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000150","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.000150/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.000150","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.000150","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EM2Gq8vH-3HEoqEPk4XmZ","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000150","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.litescrape.com","brandSlug":"agents-litescrape-com-mpp","brandBaseUrl":"https://agents.litescrape.com","brandDocsUrl":null,"whatItDoes":"Fetches the overall rating summary, star-breakdown, and written user reviews for a specific Apple Maps place identified by its MUID.","exampleAgentPrompt":"Pull all the Apple Maps ratings and reviews for the place with MUID 1234567890 — I need the overall rating summary, the star breakdown, and the written reviews in English (en-US).","exampleUseCases":[{"title":"Restaurant reputation monitoring","prompt":"Can you grab the Apple Maps ratings and reviews for the restaurant with MUID 9876543210? I want to see the overall score, the star breakdown, and the actual written reviews so I can track what customers are saying."},{"title":"Hotel due diligence before booking","prompt":"Look up the Apple Maps reviews for this hotel — its MUID is 1122334455. Get me the rating summary and all the written reviews in en-GB so I can decide whether to book it."},{"title":"Competitor analysis for local business","prompt":"Fetch the Apple Maps ratings and written reviews for our competitor's coffee shop, MUID 5544332211, and give me the full breakdown including each reviewer's score and comment — use en-US locale."}],"resultDescription":"Returns a JSON object containing: a rating_summary with overall score and total count, a ratings array with per-star breakdown, a reviews array each with rating, text, and date, optional pagination info (next URL or next_page_token) when more results exist, plus search_metadata (request ID, status, time taken) and search_parameters echoing the normalized inputs.","failureModes":["Invalid or unknown MUID returns a JSON error body with error, error_code, and status_code 404","Apple Maps has no reviews for this place — reviews array is empty or omitted","Timeout after 120 seconds if Apple Maps is slow to respond","Malformed locale string may cause normalization errors or fallback to default","Rate limiting or upstream Apple Maps unavailability returns a retryable error with retryable:true","Payment failure returns HTTP 402 before the request reaches Apple Maps"],"whenToPreferThis":"Use this endpoint when you specifically need Apple Maps user reviews and ratings (not Google Maps, Yelp, or Tripadvisor) for a place you already have the Apple MUID for. It is the right choice when your workflow targets Apple ecosystem data or when you want to compare review sentiment across platforms and need the Apple Maps side. If you need to first find the MUID, use the companion 'Get Apple Maps places' endpoint first.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T17:29:29.763Z","isFirstParty":false}