{"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":"Get reviews for a Google 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/google/reviews?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"gl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gl","default":null,"description":"Lowercase two-letter country code used for regional localization.","x-litescrape":{"id":"reviews-sort-localization-gl","group":1,"label":"Country","summary":"Lowercase two-letter country code used for regional localization.","formGroup":3,"placeholder":"us"}},"hl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hl","default":null,"description":"Language used for returned review labels and place context.","x-litescrape":{"id":"reviews-sort-localization-hl","group":1,"label":"Language","summary":"Language used for returned review labels and place context.","formGroup":3,"placeholder":"en"}},"num":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Num","default":null,"description":"Requested number of unique reviews to return.\n\nInitial unfiltered requests accept 1 through 100; the default remains eight. Requests return one response with up to the requested number of available reviews. Filtered and continuation requests accept 1 through 20.","x-litescrape":{"id":"reviews-filters-num","kind":"number","group":2,"label":"Number of reviews","notes":["Initial unfiltered requests accept 1 through 100; the default remains eight.","Requests return one response with up to the requested number of available reviews.","Filtered and continuation requests accept 1 through 20."],"summary":"Requested number of unique reviews to return.","formGroup":1,"placeholder":"10"}},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","default":null,"description":"Returns reviews matching a free-text query.\n\nCannot be combined with topic_id.","x-litescrape":{"id":"reviews-filters-query","group":2,"label":"Review query","notes":["Cannot be combined with topic_id."],"summary":"Returns reviews matching a free-text query.","formGroup":1,"placeholder":"parking"}},"data_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Id","default":null,"description":"Hexadecimal Google Maps feature identifier.\n\nFormat: 0x123:0x456 Exactly one of data_id or place_id is required.","x-litescrape":{"id":"reviews-place-data_id","group":0,"label":"data_id","notes":["Format: 0x123:0x456","Exactly one of data_id or place_id is required."],"summary":"Hexadecimal Google Maps feature identifier.","formGroup":0,"conditional":true,"placeholder":"0x123:0x456"}},"sort_by":{"anyOf":[{"enum":["qualityScore","newestFirst","ratingHigh","ratingLow"],"type":"string"},{"type":"null"}],"title":"Sort By","default":null,"description":"Controls the order of returned reviews.","x-litescrape":{"id":"reviews-sort-localization-sort_by","kind":"select","group":1,"label":"Sort order","options":[{"label":"Most relevant (default)","value":""},{"label":"Most relevant","value":"qualityScore"},{"label":"Newest","value":"newestFirst"},{"label":"Highest rating","value":"ratingHigh"},{"label":"Lowest rating","value":"ratingLow"}],"summary":"Controls the order of returned reviews.","formGroup":1}},"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},"place_id":{"type":"string","anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Id","default":null,"description":"Google place identifier for the business whose reviews should be returned.\n\nExactly one of place_id or data_id is required.","x-litescrape":{"id":"reviews-place-place_id","group":0,"label":"place_id","notes":["Exactly one of place_id or data_id is required."],"summary":"Google place identifier for the business whose reviews should be returned.","formGroup":0,"conditional":true,"placeholder":"ChIJT2h1HKZZwokR0kgzEtsa03k"}},"topic_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic Id","default":null,"description":"Returns reviews associated with a topic ID from the topics response group.\n\nCannot be combined with query.","x-litescrape":{"id":"reviews-filters-topic_id","group":2,"label":"Topic ID","notes":["Cannot be combined with query."],"summary":"Returns reviews associated with a topic ID from the topics response group.","formGroup":1,"placeholder":"/m/… or fused topic ID"}},"next_page_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Page Token","default":null,"description":"Opaque continuation token from pagination.next_page_token.\n\nPass the token back unchanged. Continuation requests default to ten reviews unless num is provided.","x-litescrape":{"id":"reviews-pagination-next_page_token","kind":"textarea","group":3,"label":"Next page token","notes":["Pass the token back unchanged.","Continuation requests default to ten reviews unless num is provided."],"summary":"Opaque continuation token from pagination.next_page_token.","formGroup":2,"placeholder":"Opaque token from the previous response"}},"source_metadata":{"anyOf":[{"type":"string"},{"type":"boolean"},{"type":"null"}],"title":"Source Metadata","default":null,"description":"Includes additional review-provider icon and scale metadata when available.","x-litescrape":{"id":"reviews-filters-source_metadata","kind":"select","group":2,"label":"Source metadata","options":[{"label":"Default (false)","value":""},{"label":"true","value":"true"},{"label":"false","value":"false"}],"summary":"Includes additional review-provider icon and scale metadata when available.","formGroup":3}}}},"responseSchema":{"type":"object","title":"Response","properties":{"topics":{"anyOf":[{"type":"array","items":{"type":"object","title":"Topic","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","default":null},"keyword":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Keyword","default":null},"mentions":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Mentions","default":null}},"additionalProperties":{}}},{"type":"null"}],"title":"Topics","default":null},"reviews":{"anyOf":[{"type":"array","items":{"type":"object","title":"Review","properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date","default":null},"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"user":{"anyOf":[{"type":"object","title":"User","properties":{"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","default":null},"photos":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Photos","default":null},"reviews":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reviews","default":null},"thumbnail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail","default":null},"local_guide":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Local Guide","default":null},"contributor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contributor Id","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_3c5e89013625acfc_ref1"}},{"type":"null"}],"default":null},"likes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Likes","default":null},"images":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Images","default":null},"rating":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Rating","default":null},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","default":null},"details":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}],"title":"Details","default":null},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet","default":null},"iso_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Iso Date","default":null},"position":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Position","default":null},"response":{"anyOf":[{"type":"object","title":"OwnerResponse","properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date","default":null},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet","default":null},"iso_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Iso Date","default":null},"extracted_snippet":{"anyOf":[{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_3c5e89013625acfc_ref5"},{"type":"null"}],"default":null},"iso_date_of_last_edit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Iso Date Of Last Edit","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_3c5e89013625acfc_ref1"}},{"type":"null"}],"default":null},"review_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Review Id","default":null},"subratings":{"anyOf":[{"type":"object","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"}]}},{"type":"null"}],"title":"Subratings","default":null},"source_icon":{},"rating_scale":{},"extracted_snippet":{"anyOf":[{"type":"object","title":"Snippet","properties":{"original":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original","default":null},"translated":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Translated","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_3c5e89013625acfc_ref1"}},{"type":"null"}],"default":null},"translated_details":{"anyOf":[{"type":"object","additionalProperties":{"type":"string"}},{"type":"null"}],"title":"Translated Details","default":null},"source_review_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Source Review Count","default":null},"iso_date_of_last_edit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Iso Date Of Last Edit","default":null}},"additionalProperties":{}}},{"type":"null"}],"title":"Reviews","default":null},"pagination":{"anyOf":[{"type":"object","title":"Pagination","properties":{"next":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next","default":null},"next_page_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Page Token","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"place_info":{"anyOf":[{"type":"object","title":"PlaceInfo","properties":{"type":{},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null},"rating":{},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address","default":null},"reviews":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reviews","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"search_metadata":{"anyOf":[{"type":"object","title":"Metadata","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},"google_maps_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Google Maps Url","default":null},"total_time_taken":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Time Taken","default":null},"google_maps_reviews_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Google Maps Reviews Url","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"source_summaries":{"anyOf":[{"type":"array","items":{"type":"object","title":"SourceSummary","properties":{"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","default":null},"rating":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Rating","default":null},"source_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Key","default":null},"provider_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Provider Id","default":null},"source_icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Icon","default":null},"rating_scale":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Rating Scale","default":null},"source_review_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Source Review Count","default":null}},"additionalProperties":{}}},{"type":"null"}],"title":"Source Summaries","default":null},"search_parameters":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}],"title":"Search Parameters","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_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-x402","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-11-03T06:30:31.443Z","isFirstParty":false,"canonicalSlug":"agents-litescrape-com-get-google-maps-reviews-for-a-place-a138a2d8"}