# Google Search Business Reviews History API (https://www.socialcrawl.dev/platforms/google/business-reviews-history) > Starts a background job (202) that collects up to `depth` Google reviews (1 to 10,000) of one place, newest first. Use it when a place has more reviews than the 1,000 one GET /v1/google/business/reviews call returns. The body takes exactly one of `place_id` or `cid` (both from GET /v1/google/business/search) and `depth`; any other field is a free 400. The 202 returns `data.job_id`, `status`, `credits_hold`, `credits_charged` (null until the job settles) and `expires_at` (7 days). A run that cannot start is a refunded 502. Read the reviews 100 at a time with GET /v1/google/business/reviews/history/{job_id}?offset=&limit=, which costs 0 credits and returns the same review objects as GET /v1/google/business/reviews. Until the job settles that read returns the job alone; after it, each page also carries `data.job` with the final `status` and `credits_charged`. TL;DR: `POST /v1/google/business/reviews/history` costs 5 credits per started 100 reviews collected, the same rate as GET /v1/google/business/reviews. Submitting holds the price of `depth` and refunds down to the reviews collected when the job settles; a job that collects none is refunded in full. and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup. ## Parameters | Parameter | Required | Description | | --- | --- | --- | | `depth` | yes | How many reviews to collect, an integer from 1 to 10,000. Page the result with GET /v1/google/business/reviews/history/{job_id}?offset=&limit=. | | `place_id` | no | Google place_id of the place. 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`. | ## Code example ```bash curl -X POST "https://www.socialcrawl.dev/v1/google/business/reviews/history" \ -H "x-api-key: sc_YOUR_API_KEY" \ -H "content-type: application/json" \ -d '{"depth":7366,"place_id":"ChIJqdNaaBVbwokRLTafYrQlZI8"}' ``` ## FAQ ### What does the Google Search Business Reviews History API return? Starts a background job that collects up to 10,000 Google reviews of one place, newest first, and returns a job id you read 100 reviews at a time. 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 History endpoint? Use it when a place has more reviews than the 1,000 one business reviews call returns and you need every one of them. ### How much does the Google Search Business Reviews History API cost? The price depends on the request, from 5 to 500 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 History API need? The one required parameter is depth (how many reviews to collect, an integer from 1 to 10,000). Identify the target with one of place_id, cid. It also accepts 2 optional parameters, all listed on this page. ### How do I call the Google Search Business Reviews History API? Send a POST request to https://www.socialcrawl.dev/v1/google/business/reviews/history with a JSON body and 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 History API return? - How do I get Google Search Business Reviews History data with the SocialCrawl API?