# Trustpilot Reviews History API (https://www.socialcrawl.dev/platforms/trustpilot/reviews-history)

> Starts a background job (202) that collects up to `depth` reviews (1 to 10000) for one Trustpilot domain. The body takes only `domain` and `depth`; any other field is a free 400. The 202 returns `data.job_id`, `status`, `credits_hold` (depth + 5), `credits_charged` (null until the job settles) and `expires_at` (7 days). A run that cannot start is a refunded 502. On settlement you pay 5 plus 1 per review collected, even when the run stopped early; the rest is refunded. Read a page with GET /v1/trustpilot/reviews/history/{job_id}?offset=&limit=. GET /v1/trustpilot/reviews is unchanged and still returns at most 200 reviews.

TL;DR: `POST /v1/trustpilot/reviews/history` costs 1 credit per returned review, plus 5 credits to open. Submitting holds depth plus 5 credits and refunds the unused portion when the job settles. and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `domain` | yes | The business domain, for example booking.com. |
| `depth` | yes | How many reviews to collect, an integer from 1 to 10000. Page the result with GET /v1/trustpilot/reviews/history/{job_id}?offset=&limit=. |

## Code example

```bash
curl -X POST "https://www.socialcrawl.dev/v1/trustpilot/reviews/history" \
  -H "x-api-key: sc_YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"domain":"booking.com","depth":772}'
```

## FAQ

### What does the Trustpilot Reviews History API return?

Starts a background job that collects up to depth reviews (1 to 10,000) of one business on Trustpilot by its domain, and returns its job id right away, holding depth plus 5 credits. 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 Trustpilot Reviews History endpoint?

Use it when you need more of a company's review history than GET /v1/trustpilot/reviews returns (200 at most); read the reviews later by job id with offset and limit. Not for a quick look at a company's latest reviews (trustpilot/reviews) or reviews of one product (Amazon or Google Shopping reviews).

### How much does the Trustpilot Reviews History API cost?

The price depends on the request, from 6 to 10005 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 Trustpilot Reviews History API need?

The required parameters are domain (the business domain, for example booking.com), depth (how many reviews to collect, an integer from 1 to 10000).

### How do I call the Trustpilot Reviews History API?

Send a POST request to https://www.socialcrawl.dev/v1/trustpilot/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 Trustpilot API: https://www.socialcrawl.dev/platforms/trustpilot

## 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 Trustpilot Reviews History API return?
- How do I get Trustpilot Reviews History data with the SocialCrawl API?