{"uid":"cap_FICsjo6bTSOC43RPtflXT","slug":"agdata-google-maps-reviews-api-e2a8a91b","name":"agdata Google Maps Reviews API","description":"Google Maps reviews API for AI agents: send a place_id or a Google Maps place URL and get up to 50 reviews as JSON: stars, text and its translation, date, likes, the owner's reply, plus the place's name, address and rating. Sort by newest, relevant, highest or lowest. Reviewer names, profiles and photos are not returned. A place with no reviews is not charged; reviews you paid for but did not get are refunded.","url":"https://agdata.shveik.dev/x402/google-maps-reviews?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"enum":["newest","relevant","highest","lowest"],"type":"string"},"limit":{"type":"integer","maximum":50,"minimum":1},"place":{"type":"string","maxLength":2048},"language":{"type":"string"}}},"responseSchema":{"type":"json","example":{"text":"there is…","place":{},"stars":5,"origin":"Google","context":{},"reviewId":"Ci9DQUlR…","imageCount":0,"likesCount":0,"publishedAt":"2026-10-…","publishedAgo":"3 hours…","ownerResponse":null,"detailedRating":{},"textTranslated":null,"originalLanguage":"en","translatedLanguage":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01505","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.01505/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01505","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01505","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tYWfNkUbL_vc0RA6o7L_k","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01505","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetch up to 50 Google Maps reviews for a place by place_id or URL, returning stars, review text, translations, dates, likes, and owner replies as JSON","exampleAgentPrompt":"Pull the 20 most recent Google Maps reviews for ChIJN1t_tDeuEmsRUsoyG83frY4 — include the owner replies and translate any non-English reviews to English.","exampleUseCases":[{"title":"Restaurant reputation monitoring","prompt":"Get the 50 newest Google Maps reviews for my restaurant — its place ID is ChIJrTLr-GyuEmsRBfy61i59si0 — and show me the star rating, review text, and any owner replies so I can see what customers are saying this week."},{"title":"Competitive analysis for a hotel","prompt":"Fetch the 20 lowest-rated Google Maps reviews for this hotel listing — https://maps.google.com/?cid=12345678 — so I can understand the most common complaints guests have about the property."},{"title":"Multilingual review aggregation","prompt":"Get up to 30 relevant Google Maps reviews for place ID ChIJd8BlQ2BZwokRAFUEcm_qrcA, translate them all to English, and return the stars, text, and date for each one so I can summarize customer sentiment."}],"resultDescription":"A JSON object containing the place's name, address, and overall rating, plus an array of up to 50 reviews each with: star rating, review text, translated text, review date, like count, and owner reply (if any). Places with no reviews are not billed; missing paid reviews are refunded.","failureModes":["Invalid or unresolvable place_id returns an error or empty result","Place URL that cannot be parsed returns a bad request error","Place exists but has zero reviews — call is not charged","Requested limit exceeds 50 — validation error","Unsupported language code may result in untranslated text","Rate limiting or upstream Google Maps unavailability returns a 5xx error"],"whenToPreferThis":"Choose this endpoint when you need structured review data from Google Maps — star ratings, review text with translations, dates, likes, and owner replies — for a specific place identified by place_id or Google Maps URL. It is ideal for reputation monitoring, competitive analysis, sentiment aggregation, or surfacing customer feedback for a known location. Prefer it over generic web scraping when you need clean, consistently structured review JSON rather than raw HTML, and when the place is already identified (no search needed).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T17:08:11.952Z","isFirstParty":false,"canonicalSlug":"agdata-google-maps-reviews-api-e2a8a91b"}