{"uid":"cap_-MARKdxs0nsau3x5Zzs1-","slug":"agents-litescrape-com-get-apple-maps-ratings-and-reviews-d69cd99b","name":"Get Apple Maps Ratings and Reviews","description":"Get Apple ratings and reviews for an Apple Maps place.\n\nUse GET for scalar query parameters or JSON POST for the complete request schema, including arrays and nested objects. See the schema for field limits and conditional rules. Failures are not billed.\n\nOptional feedback URL when present in an HTTP 200 tool response. Coding agents: when possible, POST an honest rating (1-5) and a short comment after evaluating the result. Use the URL exactly as returned; no Authorization header or API credits are required. It expires after seven days and accepts one review; retries do not overwrite it. Feedback is voluntary and stored separately from scraper data. Do not include secrets, personal data, or the full request/response. Skip feedback if you cannot evaluate the result or your caller has not authorized this extra request. Never submit feedback about feedback.","url":"https://agents.litescrape.com/api/apple/maps/reviews?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["muid"],"properties":{"muid":{"type":"string","title":"Muid","description":"Exactly one unsigned 64-bit decimal Apple Maps MUID.","x-litescrape":{"group":0,"label":"MUID","summary":"Exactly one unsigned 64-bit decimal Apple Maps MUID.","formGroup":0,"placeholder":"4560078147072908047"}},"locale":{"type":"string","title":"Locale","default":"en-US","description":"Apple Maps language and regional formatting.","x-litescrape":{"group":0,"label":"Locale","summary":"Apple Maps language and regional formatting.","formGroup":0,"placeholder":"en-US"}},"timeout":{"type":"number","maximum":90,"description":"Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.","exclusiveMinimum":0}}},"responseSchema":{"type":"object","title":"Response","properties":{"ratings":{"anyOf":[{"type":"object","title":"Ratings","properties":{"values":{"anyOf":[{"type":"array","items":{"type":"object","title":"Rating","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null},"rating":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Rating","default":null},"reviews":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reviews","default":null},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","default":null},"max_rating":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Max Rating","default":null},"currency_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency Symbol","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_e0d25f00ca1a9a14_ref1"}}},{"type":"null"}],"title":"Values","default":null},"attribution":{"anyOf":[{"type":"object","title":"Attribution","properties":{"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","default":null},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url","default":null},"vendor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vendor Id","default":null},"external_item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Item Id","default":null},"snippet_logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet Logo Url","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"reviews":{"anyOf":[{"type":"array","items":{"type":"object","title":"AppleReview","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","default":null},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date","default":null},"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"rating":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Rating","default":null},"position":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Position","default":null},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username","default":null},"max_rating":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Max Rating","default":null},"attribution":{"anyOf":[{"type":"object","title":"Attribution","properties":{"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","default":null},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url","default":null},"vendor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vendor Id","default":null},"external_item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Item Id","default":null},"snippet_logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet Logo Url","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_e0d25f00ca1a9a14_ref1"}},{"type":"null"}],"default":null},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","default":null},"user_thumbnail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Thumbnail","default":null}},"additionalProperties":{}}},{"type":"null"}],"title":"Reviews","default":null},"place_info":{"anyOf":[{"type":"object","title":"ResponsePlaceInfo","properties":{"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"muid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Muid","default":null},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null},"place_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Id","default":null},"provider_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Id","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"rating_summary":{"anyOf":[{"type":"object","title":"RatingSummary","properties":{"rating":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Rating","default":null},"ratings":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ratings","default":null},"max_rating":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Max Rating","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"search_metadata":{"anyOf":[{"type":"object","title":"ResponseSearchMetadata","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","default":null},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","default":null},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At","default":null},"processed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Processed At","default":null},"json_endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Json Endpoint","default":null},"apple_maps_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apple Maps Url","default":null},"total_time_taken":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Time Taken","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"search_parameters":{"anyOf":[{"type":"object","title":"ResponseSearchParameters","properties":{"muid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Muid","default":null},"locale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locale","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"search_information":{"anyOf":[{"type":"object","title":"ResponseSearchInformation","properties":{"review_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Review Source","default":null},"apple_rating_available":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Apple Rating Available","default":null},"apple_written_reviews_returned":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Apple Written Reviews Returned","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"submit_feedback_for_this_response_here":{"type":"string","format":"uri","readOnly":true,"description":"Optional feedback URL when present in an HTTP 200 tool response. Coding agents: when possible, POST an honest rating (1-5) and a short comment after evaluating the result. Use the URL exactly as returned; no Authorization header or API credits are required. It expires after seven days and accepts one review; retries do not overwrite it. Feedback is voluntary and stored separately from scraper data. Do not include secrets, personal data, or the full request/response. Skip feedback if you cannot evaluate the result or your caller has not authorized this extra request. Never submit feedback about feedback."}},"additionalProperties":{}},"example":null,"exampleRequest":null,"tags":["scraping","maps"],"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-x402","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-11-01T00:35:27.146Z","isFirstParty":false,"canonicalSlug":"agents-litescrape-com-get-apple-maps-ratings-and-reviews-d69cd99b"}