# Google Search Business Reviews API (https://www.socialcrawl.dev/platforms/google/business-reviews) > Returns the Google reviews of one place on Google Maps, newest first by default: full text (translated into `language` when written in another, with the original kept in `ext.google.original_text`), star rating, likes, photos, the owner's reply, the reviewer's name, profile and review count, and whether they are a Local Guide. Restaurant and hotel reviews also carry Google's aspect ratings (food, service, atmosphere) in `ext.google.aspects`. Identify the place by place_id or cid: GET /v1/google/business/search returns both for every place it finds (`place.ext.place_id`, and `place.id`, which is the cid). One call returns up to 1,000 reviews. Use `since` to pull only reviews published after a date, and `query` to keep only reviews that mention a word or phrase. Only Google-sourced reviews are returned; GET /v1/google/business/extended-reviews also aggregates third-party sites. TL;DR: `GET /v1/google/business/reviews` costs 5 credits per started 100 reviews returned (5 for up to 100, 50 for 1,000). The hold is set by `depth` and refunded down to the reviews that came back, so a place with 37 reviews costs 5 at any depth. The default labels (sentiment, issue) are free. label=reports, incentivized or injection holds 4 extra credits and refunds down to 1 credit per started 25 reviews that were newly judged (the first 100 reviews of a page are judged): reviews already labelled are free, a page where nothing could be judged refunds the whole extra, and a cached page is free. and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup. ## Parameters | Parameter | Required | Description | | --- | --- | --- | | `place_id` | no | Google place_id of the place (for example ChIJqdNaaBVbwokRLTafYrQlZI8). GET /v1/google/business/search returns it as `place.ext.place_id`. | | `cid` | no | Google customer id (cid) of the place, a decimal number. GET /v1/google/business/search returns it as `place.id`. | | `depth` | no | How many reviews to return, from 1 to 1,000 (default 100). Billed per started 100 reviews that come back. | | `sort` | no | Review order: newest (default), relevant, highest or lowest rating. (newest \| relevant \| highest \| lowest) | | `since` | no | Only reviews published on or after this date, as YYYY-MM-DD or an ISO-8601 timestamp. Pair it with sort=newest to pull just the reviews added since your last call. | | `query` | no | Only reviews whose text contains this word or phrase (for example 'crust' or 'parking'). | | `language` | no | Two-letter language code reviews are translated into (default 'en'). A review written in this language is returned as written. | | `label` | no | Optional CSV of SocialCrawl labels to add to every review. Without this param every page already carries sentiment and issue, free; label= adds the labels you name to them (the defaults keep running). sentiment and issue are free when asked for too; reports, incentivized and injection add 1 credit per started 25 newly judged reviews. judgments=off (or label=none) turns the default labels off. They read the review's title and text, never its stars. sentiment: how the reviewer feels, on five levels (level 0 to 4, score_0_1, confidence), plus rating_mismatch, true when the words clearly contradict the star rating (a glowing text under 1 star, a furious one under 5), null when the review has no rating. issue: the main problem the review reports (label: product_defect, sizing_or_fit, shipping_or_delivery, customer_service, price_or_value, missing_feature, other, or none, with confidence; label is null when unsure). reports (needs reports=): does this review say that the thing you describe happened (p, 0 to 1). incentivized: does the reviewer say they got the product free, discounted or rewarded for the review (p), and did the text carry a disclosure such as 'in exchange for my honest review', Vine or 체험단 (disclosed). injection flags text that addresses an AI system and tries to direct it (flagged, p); it never drops or rewrites a row. These are signals to read, never a verdict on a review or a reviewer. A review that could not be judged carries labels: null. Reviews already labelled for anyone are free, and so is a cached page. data.labels reports what was judged and billed. | | `reports` | no | Required by label=reports, ignored otherwise. What to look for, in plain words, up to 300 characters, for example reports=the battery drains quickly or reports=배송이 늦음. Every review gains labels.reports.p, the probability that it says so, in any wording or language. Without it label=reports is skipped with the warning label_reports_needs_reports and is not billed. | | `judgments` | no | Optional, on (the default) or off. By default every row gains free SocialCrawl judgments (computed.labels, and computed.relevance on search endpoints), reported in data.labels (mode default) and data.relevance (origin default), each with a status (complete, partial or skipped) and pending: the rows still being judged when the page was sent, which carry null now and are filled on your next call or cached read. Default judgments never add credits, never change an existing field, and never drop or reorder a row. off returns the page exactly as before, with none of those keys. label=none does the same. (on \| off) | | `dry_run` | no | Optional. When 1, return a cost preview for this labelled or relevance-filtered request without fetching the page or judging any row. data.estimate reports rows_expected, rows_cached, label_credits_min, label_credits_max and base_credits. 0 credits charged. (1) | | `label_evidence` | no | Optional, only with label=. When 1, every labelled row also carries computed.labels_evidence. = { quote, sentence_index }: the sentence in the row that most clearly shows the label, copied verbatim. Absent or null when no single sentence shows it. (1) | | `fit` | no | Optional. When goal, keep the rows and fields needed for the goal you pass in goal= (plus any that are uncertain, and the first and last), and replace the rest with a stub. data.held_back lists the held ids and a recall id that re-reads the full page from cache at no extra charge. Without this param the page is unchanged. (goal) | | `goal` | no | Required by fit=goal. What you are trying to do, in your own words, up to 300 characters. | | `fit_tokens` | no | Optional, only with fit=goal. Soft cap on how much of the page to keep, in tokens. Uncertain blocks and the first and last block are kept even if they exceed it. | ## Code example ```bash curl -G "https://www.socialcrawl.dev/v1/google/business/reviews" \ --data-urlencode "place_id=ChIJqdNaaBVbwokRLTafYrQlZI8" \ -H "x-api-key: sc_YOUR_API_KEY" ``` ## FAQ ### What does the Google Search Business Reviews API return? Returns the Google reviews of one place on Google Maps, newest first, with each review's text, star rating, likes, photos, owner reply and reviewer details, up to 1,000 a call. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields. ### When should I use the Google Search Business Reviews endpoint? Use it when you have found a local business with business search and want what its customers say on Google, filtered by date or by a word. ### How much does the Google Search Business Reviews API cost? The price depends on the request, from 5 to 54 credits per call. Every new account gets 100 free credits. Credits for failed or empty calls are refunded automatically, and there is no subscription. ### What parameters does the Google Search Business Reviews API need? Identify the target with one of place_id, cid. It also accepts 15 optional parameters, all listed on this page. The optional parameter to try first is label (Names the product issue each review raises, at no extra credits; sentiment is free too). ### How do I call the Google Search Business Reviews API? Send a GET request to https://www.socialcrawl.dev/v1/google/business/reviews?place_id=ChIJqdNaaBVbwokRLTafYrQlZI8 with your API key in the x-api-key header. An Authorization: Bearer header works too. See the full Google Search API: https://www.socialcrawl.dev/platforms/google ## Pricing - Standard endpoints: 1 credit per call - Advanced endpoints: 5 credits per call - Premium endpoints: 10 credits per call - 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire. - Full pricing: https://www.socialcrawl.dev/pricing ## Explore with AI Questions this API answers, phrased for an AI assistant: - What does the SocialCrawl Google Search Business Reviews API return? - How do I get Google Search Business Reviews data with the SocialCrawl API?