# Yelp Business Reviews History API (https://www.socialcrawl.dev/platforms/yelp/business-reviews-history) > Starts a background job (202) that collects every review of one Yelp business, newest first, including businesses that have closed. The body takes exactly one of `id` (the business id or alias) or `url` (a yelp.com/biz/ link), and optionally `since` and `until` (YYYY-MM-DD, whole UTC days), `languages` (`all` by default, or a comma list such as `en,fr`) and `max_reviews` (1 to 100,000). Any other field is a free 400. The 202 returns `data.job_id`, `status`, `pages_read`, `reviews_collected`, `credits_hold`, `credits_charged` (null until the job settles) and `expires_at` (7 days). A business that cannot be read is a free 502. Read the reviews 100 at a time with GET /v1/yelp/business/reviews/history/{job_id}?offset=&limit=, which costs 0 credits and returns the same review objects as GET /v1/yelp/business/reviews. Send an `Idempotency-Key` header to make a retried submit return the same job without a second hold. TL;DR: `POST /v1/yelp/business/reviews/history` costs 1 credit per started 4 pages of up to 49 reviews, at least 1. Submitting holds the most the request can read, set by the request alone: 52 credits for each language asked for (`languages=all`, the default, is held as 3 languages, 154 credits), or less when `max_reviews` is set. The job settles to the pages it read and refunds the rest; a business that cannot be read 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 | | --- | --- | --- | | `id` | no | The Yelp business id or alias, for example la-folie-san-francisco-2. Send this or `url`. | | `url` | no | A Yelp business link, for example https://www.yelp.com/biz/la-folie-san-francisco-2. Send this or `id`. | | `since` | no | Only reviews on or after this UTC day, as YYYY-MM-DD. | | `until` | no | Only reviews on or before this UTC day, as YYYY-MM-DD. | | `languages` | no | `all` (the default: every language the business has reviews in) or a comma list of language codes, such as `en,fr`. Sets the hold: 52 credits per language listed, and `all` is held as 3 languages (154 credits) whatever the business lists; every language is still collected. | | `max_reviews` | no | Stop after this many reviews, an integer from 1 to 100,000. Lowers the hold to the pages it needs (49 reviews a page, plus one per language). | ## Code example ```bash curl -X POST "https://www.socialcrawl.dev/v1/yelp/business/reviews/history" \ -H "x-api-key: sc_YOUR_API_KEY" \ -H "content-type: application/json" \ -d '{"id":"la-folie-san-francisco-2"}' ``` ## FAQ ### What does the Yelp Business Reviews History API return? Starts a background job that collects every review of one Yelp business, closed businesses included, newest first and in every language, 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 Yelp Business Reviews History endpoint? Use it when you need a business's whole review history or a dated window of it, such as the last two years, rather than one page. ### How much does the Yelp Business Reviews History API cost? The price depends on the request, from 1 to 154 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 Yelp Business Reviews History API need? Identify the target with one of id, url. It also accepts 6 optional parameters, all listed on this page. The optional parameter to try first is since (Returns only posts after this date, so a daily poll pays only for the pages with new posts). ### How do I call the Yelp Business Reviews History API? Send a POST request to https://www.socialcrawl.dev/v1/yelp/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 Yelp API: https://www.socialcrawl.dev/platforms/yelp ## 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 Yelp Business Reviews History API return? - How do I get Yelp Business Reviews History data with the SocialCrawl API?