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

> Starts a job that collects up to `depth` reviews for one Trustpilot domain and returns a job id. Read a page with GET /v1/trustpilot/reviews/history/{job_id}?offset=&limit=. `depth` is an integer from 1 to 10000. 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}'
```

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