{"uid":"cap_qsqtDYoHaRgM2PfyAnbvt","slug":"agents-openwebninja-com-business-reviews-google-maps-via-openweb-ninja-f628f84b","name":"Business Reviews (Google Maps via OpenWeb Ninja)","description":"Get all / paginate business reviews by Business Id using a pagination cursor.","url":"https://agents.openwebninja.com/local-business-data/business-reviews-v2?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["business_id"],"properties":{"limit":{"type":"string","default":20,"description":"Maximum number of business reviews to return.  \n\n  **Allowed values:** `1-100`"},"query":{"type":"string","description":"Return reviews matching a text query"},"cursor":{"type":"string","description":"Pagination cursor for fetching the next page of reviews. Pass the `cursor` value returned in the previous response's `data.cursor`. Omit on the first request to start from the most relevant reviews."},"fields":{"type":"string","description":"A comma separated list of review fields to include in the response (field projection).  \n  By default all fields are returned."},"region":{"type":"string","default":"us","description":"Query Google Maps from a particular region or country.  \n  For a list of supported region/country codes see *https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes (Alpha-2 code)*."},"sort_by":{"enum":["most_relevant","newest","highest_ranking","lowest_ranking"],"type":"string","default":"most_relevant","description":"How to sort the reviews in the results."},"language":{"type":"string","default":"en","description":"Set the language of the results. For a list of supported language codes see *https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes*."},"business_id":{"type":"string","example":"0x89c259b5a9bd152b:0x31453e62a3be9f76","description":"Unique Business Id. Accepts `google_id` / `business_id` or `place_id`.  \n\n  **Examples:**  \n  `0x880fd393d427a591:0x8cba02d713a995ed`  \n  `ChIJkaUn1JPTD4gR7ZWpE9cCuow`"},"translate_reviews":{"type":"boolean","description":"Whether to translate reviews to the language specified as the language parameter (defaults to false)."}}},"responseSchema":{"type":"object","required":["status","request_id","parameters","data"],"properties":{"data":{"type":"object","required":["reviews"],"properties":{"cursor":{"type":"string","nullable":true,"description":"Pagination cursor for the next page of reviews. Pass it back as the `cursor` query parameter to fetch the next page. `null` when there are no more reviews."},"reviews":{"type":"array","items":{"type":"object","required":["review_id","rating"],"properties":{"rating":{"type":"integer","description":"Star rating given in the review (1-5)."},"author_id":{"type":"string","nullable":true,"description":"Google Maps contributor ID of the review author."},"review_id":{"type":"string","description":"Unique Google identifier of the review."},"like_count":{"type":"integer","nullable":true,"description":"Number of likes the review received."},"author_link":{"type":"string","nullable":true,"description":"URL to the author's Google Maps contributor profile."},"author_name":{"type":"string","nullable":true,"description":"Display name of the review author."},"review_form":{"type":"object","nullable":true,"description":"Free-form structured questions the author answered (e.g. 'What kind of trip was it?').","additionalProperties":{"type":"string"}},"review_link":{"type":"string","nullable":true,"description":"Direct Google Maps URL to the review."},"review_text":{"type":"string","nullable":true,"description":"Full text content of the review."},"review_time":{"type":"string","nullable":true,"description":"Human-friendly relative time of the review (e.g. '4 months ago') as shown on Google Maps."},"review_photos":{"type":"array","items":{"type":"string"},"nullable":true,"description":"URLs of photos attached to the review."},"review_source":{"type":"string","nullable":true,"description":"Platform from which the review originates (e.g. 'Google', 'Tripadvisor')."},"review_language":{"type":"string","nullable":true,"description":"ISO 639 language code of the review text."},"service_quality":{"type":"string","nullable":true,"description":"Optional service-quality tag the author selected when reviewing."},"author_photo_url":{"type":"string","nullable":true,"description":"URL of the author's profile photo."},"review_timestamp":{"type":"integer","nullable":true,"description":"Unix epoch seconds matching review_datetime_utc."},"author_photo_count":{"type":"integer","nullable":true,"description":"Number of photos this author has posted."},"review_source_logo":{"type":"string","nullable":true,"description":"URL of the source platform logo."},"author_review_count":{"type":"integer","nullable":true,"description":"Number of reviews this author has posted."},"author_reviews_link":{"type":"string","nullable":true,"description":"URL to all reviews by this author."},"owner_response_text":{"type":"string","nullable":true,"description":"Text of the business owner's response."},"owner_response_time":{"type":"string","nullable":true,"description":"Human-friendly relative time of the owner response."},"review_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime when the review was posted."},"author_is_local_guide":{"type":"boolean","nullable":true,"description":"Whether the author is a Google Local Guide."},"hotel_rating_breakdown":{"type":"object","nullable":true,"description":"Hotel-only: per-aspect ratings (Rooms, Service, Location, etc.) selected by the author.","additionalProperties":{"type":"integer"}},"owner_response_language":{"type":"string","nullable":true,"description":"ISO 639 language code of the owner response."},"author_local_guide_level":{"type":"integer","nullable":true,"description":"Google Local Guide level (1-10) of the author."},"owner_response_timestamp":{"type":"integer","nullable":true,"description":"Unix epoch seconds matching owner_response_datetime_utc."},"owner_response_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime when the business owner responded to the review."},"review_text_translated_language":{"type":"string","nullable":true,"description":"ISO 639 language code the review was translated into (when translate_reviews=true)."}}},"description":"List of reviews returned."}},"description":"Reviews returned for the business, plus the pagination cursor."},"status":{"type":"string","description":"The status of the API response."},"parameters":{"type":"object","properties":{"limit":{"type":"integer","description":"Maximum number of reviews requested."},"cursor":{"type":"string","nullable":true,"description":"Pagination cursor used for this request (null on the first page)."},"region":{"type":"string","description":"Region code used for the request."},"sort_by":{"type":"string","description":"Sort order applied. Values: most_relevant, newest, highest_ranking, lowest_ranking."},"language":{"type":"string","description":"Language code used for the reviews."},"business_id":{"type":"string","description":"The business_id as received."},"translate_reviews":{"type":"boolean","description":"Whether reviews were translated into the requested language."}},"description":"The parameters the API received and used for this request, echoed back."},"request_id":{"type":"string","description":"A unique ID to trace the API request."}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","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":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_h06EwbKFijiVNxPwkwZe_","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Fetches and paginates real-time customer reviews for a specific business from Google Maps, with filtering, sorting, and translation options.","exampleAgentPrompt":"Can you pull the 20 most recent Google Maps reviews for the business with place ID ChIJkaUn1JPTD4gR7ZWpE9cCuow, sorted by newest first, in English?","exampleUseCases":[{"title":"Restaurant reputation monitoring","prompt":"Get me the 50 most recent Google Maps reviews for my restaurant — its place ID is ChIJkaUn1JPTD4gR7ZWpE9cCuow — sorted by newest first so I can see what customers are saying lately."},{"title":"Competitor sentiment analysis","prompt":"Fetch the lowest-rated Google Maps reviews for the business with ID 0x880fd393d427a591:0x8cba02d713a995ed — give me up to 100 sorted by lowest ranking so I can analyze where they're falling short."},{"title":"Multilingual review research","prompt":"Pull Google Maps reviews for the business with place ID ChIJN1t2tDTowoARAOXGo6q1M2w that mention 'parking', translate them all into English, and return up to 25 results."}],"resultDescription":"Returns a paginated list of Google Maps reviews for the specified business, each containing a review ID, star rating (1–5), review text, author name and profile link, relative timestamp, photo URLs, like count, service quality structured answers, review source platform, language code, and a cursor for fetching the next page of results. The cursor is null when no further pages exist.","failureModes":["Invalid or unrecognized business_id returns an empty reviews array or error status","Expired or tampered pagination cursor may return unexpected results or an error","Requesting reviews in an unsupported language code may fall back to default or return an error","Rate limiting or payment failure returns a 402 or 429 HTTP status","Region code mismatch may return fewer or different reviews than expected"],"whenToPreferThis":"Use this endpoint when you need to retrieve, paginate, or search through Google Maps customer reviews for a specific business by its Google place ID or business ID. Prefer this over general search endpoints when the business is already identified and you need structured review data including ratings, text, photos, and author info. It is the right choice when you need translation, text-query filtering, or a specific sort order (newest, highest, lowest).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:57.272Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-business-reviews-google-maps-via-openweb-ninja-0d41b8b4"}