API Reference
Every endpoint, parameter and response model of the ScrapeReviews API.
https://api.scrapereviews.com/v1
X-API-Key or Authorization: Bearer
All responses are JSON. See Authentication and Errors.
Endpoints
| Endpoint | Cost |
|---|---|
| GET/v1/companies/search | 1 credit per 10 results (min 1) |
| GET/v1/companies/{domain} | 2 credits |
| GET/v1/companies/{domain}/reviews | 1 credit per 5 reviews returned (min 1) |
| GET/v1/categories | 1 credit |
| GET/v1/categories/{category_id}/companies | 1 credit per 10 companies (min 1) |
| GET/health | free, no authentication |
Credits and headers
1 credit = $0.001. Only successful calls are billed: errors cost 0 credits. Every successful response tells you what it cost, in a header and in the body:
| Where | Description |
|---|---|
| X-Credits-Used | Response header: credits charged for this request |
| meta.credits_used | The same value in the JSON body |
| meta.cache_hit | Whether the data came from our cache (the price is the same) |
| X-RateLimit-Limit / -Remaining / -Reset | Rate limit window: 300 requests per minute per IP address |
Credit packs and the free monthly credits are on the pricing page.
Pagination
List endpoints (search, reviews, category companies) use cursor pagination. When meta.has_more is true, pass meta.next_cursor as cursor with the same filters to get the next page. A cursor created for other filters is rejected with 422 invalid_cursor. The SDKs do this for you with iter_reviews / iterReviews.
GET /v1/companies/www.monzo.com/reviews?stars=1&limit=100
→ meta: { "has_more": true, "next_cursor": "eyJhIjo..." }
GET /v1/companies/www.monzo.com/reviews?stars=1&limit=100&cursor=eyJhIjo...
→ meta: { "has_more": false, "next_cursor": null }/v1/companies/search1 credit per 10 results (min 1)Search companies by name or domain. An exact domain returns that company.
Company search: full guide with examples, errors and use cases →Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| query | string | required | Company name or domain (1-200 characters) |
| limit | integer 1-50 | 10 | Results per response |
| cursor | string | - | meta.next_cursor of the previous response, with the same filters |
Example
GET /v1/companies/search?query=monzo&limit=5Response
{ "data": CompanySummary[], "meta": ListMeta }/v1/companies/{domain}2 creditsThe full profile of a company: TrustScore, star distribution, languages, categories, contacts, claim status and reply behavior.
Company profile: full guide with examples, errors and use cases →Path parameters
| Parameter | Type | Description |
|---|---|---|
| domain | string | example.com, www.example.com, https://example.com/... or a Trustpilot review URL. Redirects to the canonical domain are followed: data.domain is always canonical. |
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| include_similar | boolean | false | Add similar: a list of similar companies (CompanySummary) |
Example
GET /v1/companies/www.monzo.com?include_similar=trueResponse
{ "data": Company, "meta": BaseMeta }/v1/companies/{domain}/reviews1 credit per 5 reviews returned (min 1)The reviews of a company, with filters and cursor pagination.
Company reviews: full guide with examples, errors and use cases →Path parameters
| Parameter | Type | Description |
|---|---|---|
| domain | string | Company domain, same formats as the company profile |
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| stars | string | all | Comma-separated ratings, e.g. 1,2 |
| language | string | all | all or an ISO 639-1 code (en, it, ...) |
| since | date | - | Published on or after: YYYY-MM-DD or ISO 8601 |
| until | date | - | Published on or before |
| verified | boolean | false | Only verified reviews |
| with_reply | boolean | false | Only reviews the company replied to |
| search | string ≤ 100 | - | Full-text filter on title and text |
| sort | recent | relevant | recent | Order of the reviews |
| limit | integer 1-100 | 20 | Reviews per response |
| cursor | string | - | meta.next_cursor of the previous response, with the same filters |
If your balance cannot pay for limit reviews, limit is lowered to what the balance covers instead of failing: check meta.count and meta.credits_used.
Example
GET /v1/companies/www.monzo.com/reviews?stars=1,2&language=en&since=2026-10-01&limit=50Response
{ "company": CompanyRef, "data": Review[], "meta": ReviewsMeta }Coverage: how many reviews you get
Trustpilot shows at most 200 reviews per filter combination to anonymous visitors. The API splits your query by star rating and language to go further, so most companies can be read in full.
When a single (star, language) slice holds more than 200 reviews, the newest 200 plus the most relevant ones are returned and meta.complete is false. Narrow the query with since / until to read more of that slice.
When the query is split, results come grouped by star rating (5 → 1) and then by language, each group in the requested sort order. Filter by stars and language if you need a single ordered stream.
Pseudonymised authors
author.id is a stable HMAC of the reviewer's id: the same reviewer always has the same id, so you can group reviews by author. Names, avatars and profile URLs are never returned or stored.
/v1/categories1 creditThe full category tree. Use the ids with the category companies endpoint.
Category tree: full guide with examples, errors and use cases →Example
GET /v1/categoriesResponse
{ "data": Category[], "meta": BaseMeta }/v1/categories/{category_id}/companies1 credit per 10 companies (min 1)The companies of a category in a country.
Category companies: full guide with examples, errors and use cases →Path parameters
| Parameter | Type | Description |
|---|---|---|
| category_id | string | A category id from /v1/categories, e.g. bank |
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| country | string | required | ISO 3166-1 alpha-2, e.g. IT |
| sort | relevant | reviews_count | relevant | Order of the companies |
| min_trust_score | 3.0 | 4.0 | 4.5 | - | Only companies with at least this TrustScore |
| location | string ≤ 100 | - | City, e.g. Milano |
| limit | integer 1-100 | 20 | Companies per response |
| cursor | string | - | meta.next_cursor of the previous response, with the same filters |
Example
GET /v1/categories/bank/companies?country=GB&min_trust_score=4.0&sort=reviews_countResponse
{ "category": { "id": "bank", "name": "Bank", "country": "GB" }, "data": CompanySummary[], "meta": ListMeta }/healthfree, no authenticationService status. No API key needed, no credits charged.
{ "status": "healthy" }Response models
Meta: BaseMeta, ListMeta, ReviewsMeta
// BaseMeta (every response)
{ "credits_used": 2, "cache_hit": false }
// ListMeta = BaseMeta + pagination (search, category companies)
{ "credits_used": 1, "cache_hit": false,
"count": 10, "total": 167, "has_more": true, "next_cursor": "eyJ..." }
// ReviewsMeta = ListMeta + coverage flag (reviews)
{ "credits_used": 4, "cache_hit": false,
"count": 20, "total": 74600, "has_more": true, "next_cursor": "eyJ...", "complete": true }CompanySummary
Returned by search, category companies and similar.
{
"id": "4e806c830000640005111892",
"domain": "zalando.it",
"name": "Zalando",
"trust_score": 1.9,
"stars": 2.0,
"review_count": 13683,
"logo_url": "https://s3-eu-west-1.amazonaws.com/tpd/logos/.../0x0.png",
"categories": [{ "id": "shoe_store", "name": "Shoe Store", "is_primary": false }],
"contact": {
"website": "https://zalando.it", "email": null, "phone": "+39 ...",
"address": "Tamara-Danz-Str. 1", "city": "Berlin", "zip_code": "10243", "country": "Germany"
},
"trustpilot_url": "https://www.trustpilot.com/review/zalando.it"
}Company
Returned by the company profile.
{
"id": "...",
"domain": "www.monzo.com",
"name": "Monzo",
"website": "https://www.monzo.com",
"trust_score": 4.6,
"stars": 4.5,
"review_count": 74600,
"review_count_last_12_months": 9000,
"star_distribution": { "one": 7462, "two": 856, "three": 1069, "four": 4380, "five": 60833 },
"languages": [{ "language": "en", "count": 70000 }],
"categories": [{ "id": "bank", "name": "Bank", "is_primary": true }],
"description": "...",
"country": "GB",
"contact": { "website": "...", "email": "...", "phone": "...", "address": "...", "city": "...", "zip_code": "...", "country": "United Kingdom" },
"is_claimed": true,
"claimed_at": "2015-02-18T19:08:43.000Z",
"is_closed": false,
"is_temporarily_closed": false,
"is_using_paid_features": true,
"reply_behavior": {
"reply_rate": 51.07,
"average_days_to_reply": 2.9,
"negative_reviews_count": 979,
"negative_reviews_with_reply_count": 500,
"last_reply_to_negative_review_at": "2026-11-20 15:40:54 UTC"
},
"verified": false,
"consumer_alert": null,
"logo_url": "https://...",
"similar": [ /* CompanySummary, only with include_similar=true */ ],
"trustpilot_url": "https://www.trustpilot.com/review/www.monzo.com"
}CompanyRef
The company field of a reviews response.
{
"id": "...",
"domain": "www.monzo.com",
"name": "Monzo",
"trust_score": 4.6,
"review_count": 74600,
"trustpilot_url": "https://www.trustpilot.com/review/www.monzo.com"
}Review
{
"id": "6aff80ab97bf06512078aeb5",
"rating": 1,
"title": "...",
"text": "...",
"language": "it",
"experienced_at": "2026-11-19T00:00:00.000Z",
"published_at": "2026-11-20T01:05:15.000Z",
"updated_at": null,
"is_verified": false,
"verification_source": "invitation",
"source": "Organic",
"likes": 0,
"author": { "id": "u_03c1fd2a7b494fcd43a7", "country": "IT", "review_count": 2, "is_verified": false },
"reply": { "text": "...", "published_at": "...", "updated_at": null }, // or null
"url": "https://www.trustpilot.com/reviews/6aff80ab97bf06512078aeb5"
}Category
{
"id": "animals_pets",
"name": "Animals & Pets",
"subcategories": [
{ "id": "animal_health", "name": "Animal Health", "subcategories": [] }
]
}ScrapeReviews is an independent service and is not affiliated with or endorsed by Trustpilot.