{"uid":"cap_63B29B97lfKmHyIE_ae3A","slug":"api-direct-google-place-reviews-c7f5f741","name":"API Direct – Google Place Reviews","description":"Get user reviews for a place by `place_id`.","url":"https://x402.apidirect.io/v1/places/reviews?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["place_id"],"properties":{"limit":{"type":"integer","maximum":100,"minimum":1,"description":"Alternative to `pages`: maximum number of reviews, rounded up to whole pages of 10 (e.g. `limit=15` fetches 2 pages, so up to 20 reviews). Ignored when `pages` is also sent. Maximum 100"},"pages":{"type":"integer","default":1,"maximum":10,"minimum":1,"description":"Number of pages to fetch and merge. Each page returns up to 10 reviews and is billed as one request"},"country":{"type":"string","default":"us","maxLength":2,"minLength":2,"description":"2-letter ISO 3166-1 alpha-2 region code"},"sort_by":{"enum":["most_relevant","newest","highest_ranking","lowest_ranking"],"type":"string","default":"most_relevant","description":"Sort order for reviews"},"language":{"type":"string","default":"en","maxLength":2,"minLength":2,"description":"2-letter ISO 639-1 language code for the returned reviews. Set `translate_reviews=true` to translate the returned reviews into this language"},"place_id":{"type":"string","maxLength":200,"description":"Google `place_id`, as returned by the Places Search endpoint"},"get_sentiment":{"type":"boolean","default":false,"description":"Set to true to add AI emotion analysis to each review. Adds a `sentiment` object containing `emotions` (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), `dominant_emotion`, `emotional_intensity` (0-10), and `polarity` (positive, negative or neutral). Any revi"},"translate_reviews":{"type":"boolean","default":false,"description":"Set to `true` to translate the returned reviews into the requested `language`"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.011","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.011/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.011","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.011","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EVhqOKgIeeDUTzb14MVZR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.011","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches user-submitted reviews for a specific Google place by place_id, with optional sentiment analysis, translation, and sorting.","exampleAgentPrompt":"Can you pull the 20 most recent Google reviews for the place with ID ChIJN1t_tDeuEmsRUsoyG83frY4 and include AI sentiment analysis on each one?","exampleUseCases":[{"title":"Restaurant reputation monitoring","prompt":"Get me the 30 most relevant Google reviews for place ID ChIJrTLr-ItSkFQRmcMBlW_Xcts — I want to see how customers feel overall, so include sentiment analysis on each review."},{"title":"Competitor analysis for travel app","prompt":"Fetch the top 10 lowest-ranked Google reviews for place ID ChIJdd4hrwug2EcRmSrV3Vo6llI so I can understand what guests complain about most at this hotel."},{"title":"Multilingual review display","prompt":"Get the 20 most recent Google reviews for place ID ChIJLU7jZClu5kcR4PcOOO6p3I0, translate them all into French, and return them sorted by newest first."}],"resultDescription":"Returns a list of up to 100 user reviews for the specified place, each containing reviewer name, rating, review text, time, and optionally a sentiment object with emotions (joy, trust, fear, surprise, sadness, disgust, anger, anticipation scored 0–100), dominant_emotion, emotional_intensity (0–10), and polarity (positive/negative/neutral). Reviews may be translated into the requested language.","failureModes":["Invalid or missing place_id returns an error or empty result","place_id not found on Google Maps returns no reviews","Exceeding pages=10 or limit=100 caps are rejected with a validation error","Unsupported language or country code may return default language results","get_sentiment on very short reviews may produce low-confidence emotion scores","Rate limits or payment failures return 402 or 429 errors"],"whenToPreferThis":"Choose this endpoint when you need structured Google Maps user reviews for a known place_id, especially when you want optional AI-powered sentiment and emotion scoring or multilingual translation built in. Prefer it over raw scraping when you need clean, paginated review data without managing Google API credentials yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:06:22.550Z","isFirstParty":false,"canonicalSlug":"api-direct-google-place-reviews-c7f5f741"}