{"uid":"cap_-jL8A-dwU6VrRVVfW5UIz","slug":"agents-litescrape-com-get-google-maps-reviews-for-a-place-a138a2d8","name":"Get Google Maps Reviews for a Place","description":"Returns reviews for one place identified by place_id or data_id (exactly one is required): each review carries the rating, snippet, date, and reviewer details, alongside the topics Google groups them into and pagination.next_page_token for the next page. Sort with sort_by, filter by free-text query or a topic_id, and set num for up to 100 reviews on an unfiltered first request (up to 20 on filtered or continuation requests). One call is one request.","url":"https://agents.litescrape.com/api/google/reviews","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"gl":{"type":"string","default":"us","maxLength":2,"minLength":2,"description":"Two-letter country code, lowercase."},"hl":{"type":"string","default":"en","description":"Language for review labels and place context."},"num":{"type":"integer","default":8,"maximum":100,"minimum":1,"description":"Number of reviews. 1 to 100 on an unfiltered first request, 1 to 20 on filtered or continuation requests."},"query":{"type":"string","description":"Only reviews matching this free-text query. Cannot be combined with topic_id."},"data_id":{"type":"string","description":"Hexadecimal Maps feature ID in the form 0x123:0x456. Required unless place_id is supplied."},"sort_by":{"enum":["qualityScore","newestFirst","ratingHigh","ratingLow"],"type":"string","default":"qualityScore","description":"Review order."},"place_id":{"type":"string","description":"Google place ID of the business. Required unless data_id is supplied."},"topic_id":{"type":"string","description":"Only reviews under this topic from the topics group. Cannot be combined with query."},"next_page_token":{"type":"string","description":"Continuation token from pagination.next_page_token, passed back unchanged. Continuation requests default to ten reviews."},"source_metadata":{"type":"boolean","default":false,"description":"Include review-provider icon and scale metadata when available."}}},"responseSchema":{"type":"object","properties":{"topics":{"type":"array","items":{"type":"object"},"description":"Review topics with the topic_id usable as a filter."},"reviews":{"type":"array","items":{"type":"object"},"description":"Reviews: rating, snippet, date, reviewer details."},"pagination":{"type":"object","description":"Present when more results exist: next (a ready-made URL for the next page) or next_page_token."},"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_wJwHMwnERMcORleT0U3b7","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":"Returns paginated Google Maps reviews for a specific place, including ratings, snippets, reviewer details, and topic groupings.","exampleAgentPrompt":"Pull me the 50 most recent Google Maps reviews for the place with ID ChIJN1t_tDeuEmsRUsoyG83frY4, sorted by newest first — I want the rating, snippet, and reviewer name for each one.","exampleUseCases":[{"title":"Restaurant reputation analysis","prompt":"Get me the top 100 Google Maps reviews for ChIJrTLr-GyuEmsRBfy61i59si0, sorted by quality score, so I can analyze what customers love and complain about most."},{"title":"Filtering reviews by topic","prompt":"Fetch Google Maps reviews for place ID ChIJN1t_tDeuEmsRUsoyG83frY4 that fall under the 'service' topic — I want to see what reviewers specifically say about customer service there."},{"title":"Monitoring newest negative reviews","prompt":"Show me the 20 newest one-star Google Maps reviews for our business at place ID ChIJ2eUgeAK6j4ARbn5u_wAGqWA so we can respond to recent complaints quickly."}],"resultDescription":"Returns an array of reviews each containing a star rating, text snippet, relative date, and reviewer profile details; a topics array with topic_id values usable as filters; a pagination object with next_page_token and a ready-made next URL when more results exist; and search_metadata with request status and timing.","failureModes":["Neither place_id nor data_id provided — returns 400 error with error_code indicating missing required parameter","Both query and topic_id supplied simultaneously — mutually exclusive, returns 400 error","next_page_token is invalid or expired — returns error indicating bad continuation token","num exceeds 20 on a filtered or continuation request — capped or error returned","Invalid place_id or data_id for a non-existent place — returns empty reviews array or 404-style error","Rate limiting or upstream Google Maps unavailability — retryable error with retryable:true in response body"],"whenToPreferThis":"Choose this endpoint when you need structured Google Maps review data for a specific known place (identified by place_id or data_id), want to filter or sort reviews, or need to paginate through large review sets. Prefer it over general web search when you specifically want Google Maps review content with reviewer metadata and topic groupings. Use it over Yelp or TripAdvisor review endpoints when Google Maps is the target review source.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T17:29:32.235Z","isFirstParty":false}