Company reviews endpoint

GEThttps://api.scrapereviews.com/v1/companies/{domain}/reviews1 credit per 5 reviews returned (min 1)

The reviews endpoint returns the reviews of a company: rating, title, text, language, the date of the experience and of publication, whether the review is verified and how, the number of likes, a pseudonymised author and the reply of the company when there is one.

Filters run on our side, so you only pay for what you keep: star ratings, language, a date range, verified reviews only, reviews with a company reply only and a full-text search on title and text. Sort by most recent (the default) or by relevance.

Trustpilot shows anonymous visitors at most 200 reviews per filter combination. The API splits your query by star rating and then by language to go further, so most companies can be read in full. When one star-and-language slice holds more than 200 reviews, the newest 200 plus the most relevant ones are returned and meta.complete is false; narrow the dates with since and until to read more of that slice.

Authors are pseudonymised: author.id is a stable HMAC of the reviewer id, so the same reviewer always has the same id, but names, avatars and profile URLs are never returned or stored.

Parameters

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.

Authenticate with your API key in the X-API-Key header or as Authorization: Bearer (see authentication).

Example request

curl "https://api.scrapereviews.com/v1/companies/www.monzo.com/reviews?stars=1,2&language=en&since=2026-10-01&limit=50" \
  -H "X-API-Key: sr_your_api_key"

Response

Shape
{ "company": CompanyRef, "data": Review[], "meta": ReviewsMeta }
Example (shortened)
{
  "company": { "id": "5130a5e4000064000525c7e9", "domain": "www.monzo.com", "name": "Monzo",
               "trust_score": 4.6, "review_count": 74600,
               "trustpilot_url": "https://www.trustpilot.com/review/www.monzo.com" },
  "data": [
    {
      "id": "6aff80ab97bf06512078aeb5",
      "rating": 1,
      "title": "Account frozen for two weeks",
      "text": "...",
      "language": "en",
      "experienced_at": "2026-11-19T00:00:00.000Z",
      "published_at": "2026-11-20T01:05:15.000Z",
      "updated_at": null,
      "is_verified": false,
      "verification_source": null,
      "source": "Organic",
      "likes": 0,
      "author": { "id": "u_03c1fd2a7b494fcd43a7", "country": "GB", "review_count": 2, "is_verified": false },
      "reply": { "text": "...", "published_at": "2026-11-20T09:12:00.000Z", "updated_at": null },
      "url": "https://www.trustpilot.com/reviews/6aff80ab97bf06512078aeb5"
    }
  ],
  "meta": { "credits_used": 10, "cache_hit": false, "count": 50, "total": 1204,
            "has_more": true, "next_cursor": "eyJ...", "complete": true }
}

Every field is described in the response models. Successful responses also carry the X-Credits-Used header.

Cost

Reviews are billed by volume: 1 credit per 5 reviews returned (min 1). A page of 100 reviews costs 20 credits, a page of 20 costs 4. If your balance cannot pay for the requested limit, the limit is lowered to what it covers instead of failing.

A response may hold fewer reviews than limit while meta.has_more is still true (the crawler skips reviews it already returned): keep following next_cursor until it is null.

Only successful calls are billed: every error costs 0 credits. You get 100 free credits every month; see pricing for credit packs.

Errors

Errors come with an HTTP status and this JSON body: branch on detail.error, show detail.message to humans.

Example error
{
  "detail": {
    "error": "invalid_cursor",
    "message": "cursor was created for a different request"
  }
}
HTTPerrorMeaning
400invalid_parameterA parameter is invalid: bad domain, stars, language or date, missing query, limit out of range...
401missing_api_keyNo API key in X-API-Key or Authorization: Bearer.
401invalid_api_keyThe key does not exist or has been revoked.
402insufficient_creditsYour credit balance is 0.
404company_not_foundNo company page exists for this domain.
422invalid_cursorThe cursor is malformed, tampered with, or was created for other filters.
429rate_limit_exceededToo many requests per minute.
429insufficient_credits_retry_laterThe balance ran out on recent calls and the key is cooling down.
502upstream_changedTrustpilot changed its page format and the response could not be read.
503upstream_blockedTrustpilot is temporarily blocking requests.
504upstream_timeoutTrustpilot did not answer in time.

What to do for each code: error handling.

Use cases

  • Export all the reviews of a company to CSV or a data warehouse for sentiment and topic analysis.
  • Track new one- and two-star reviews of your brand every day with since and stars=1,2.
  • Compare how competitors are reviewed in a given language or country.
  • Feed recent reviews to an LLM to summarise complaints and praise.

Related endpoints

  • Company profile GET /v1/companies/{domain}: The full profile of a company: TrustScore, star distribution, languages, categories, contacts, claim status and reply behavior.
  • Company search GET /v1/companies/search: Search companies by name or domain. An exact domain returns that company.

ScrapeReviews is an independent service and is not affiliated with or endorsed by Trustpilot.