API Reference

Every endpoint, parameter and response model of the ScrapeReviews API.

Base URL

https://api.scrapereviews.com/v1

Authentication

X-API-Key or Authorization: Bearer

All responses are JSON. See Authentication and Errors.

Endpoints

EndpointCost
GET/v1/companies/search1 credit per 10 results (min 1)
GET/v1/companies/{domain}2 credits
GET/v1/companies/{domain}/reviews1 credit per 5 reviews returned (min 1)
GET/v1/categories1 credit
GET/v1/categories/{category_id}/companies1 credit per 10 companies (min 1)
GET/healthfree, 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:

WhereDescription
X-Credits-UsedResponse header: credits charged for this request
meta.credits_usedThe same value in the JSON body
meta.cache_hitWhether the data came from our cache (the price is the same)
X-RateLimit-Limit / -Remaining / -ResetRate 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.

Pagination loop
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 }
GET/v1/companies/{domain}2 credits

The 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

ParameterTypeDescription
domainstringexample.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

ParameterTypeDefaultDescription
include_similarbooleanfalseAdd similar: a list of similar companies (CompanySummary)

Example

GET /v1/companies/www.monzo.com?include_similar=true

Response

{ "data": Company, "meta": BaseMeta }
GET/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

ParameterTypeDescription
domainstringCompany domain, same formats as the company profile

Query parameters

ParameterTypeDefaultDescription
starsstringallComma-separated ratings, e.g. 1,2
languagestringallall or an ISO 639-1 code (en, it, ...)
sincedate-Published on or after: YYYY-MM-DD or ISO 8601
untildate-Published on or before
verifiedbooleanfalseOnly verified reviews
with_replybooleanfalseOnly reviews the company replied to
searchstring ≤ 100-Full-text filter on title and text
sortrecent | relevantrecentOrder of the reviews
limitinteger 1-10020Reviews per response
cursorstring-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=50

Response

{ "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.

GET/v1/categories1 credit

The full category tree. Use the ids with the category companies endpoint.

Category tree: full guide with examples, errors and use cases →

Example

GET /v1/categories

Response

{ "data": Category[], "meta": BaseMeta }
GET/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

ParameterTypeDescription
category_idstringA category id from /v1/categories, e.g. bank

Query parameters

ParameterTypeDefaultDescription
countrystringrequiredISO 3166-1 alpha-2, e.g. IT
sortrelevant | reviews_countrelevantOrder of the companies
min_trust_score3.0 | 4.0 | 4.5-Only companies with at least this TrustScore
locationstring ≤ 100-City, e.g. Milano
limitinteger 1-10020Companies per response
cursorstring-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_count

Response

{ "category": { "id": "bank", "name": "Bank", "country": "GB" }, "data": CompanySummary[], "meta": ListMeta }
GET/healthfree, no authentication

Service status. No API key needed, no credits charged.

Response
{ "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.