Company search endpoint
https://api.scrapereviews.com/v1/companies/search1 credit per 10 results (min 1)The company search endpoint finds Trustpilot business profiles by name or by domain. It is usually the first call of a workflow: you know a brand name, you need the domain that identifies the company in every other endpoint.
Each result is a CompanySummary: the domain, the display name, the TrustScore and star rating, the number of reviews, the categories and the public contact details of the company. Pass an exact domain such as monzo.com and the matching company comes first; pass a name and you get the companies Trustpilot ranks as the best matches.
Results are paginated with an opaque cursor. When meta.has_more is true, send meta.next_cursor back as cursor with the same query to read the next page.
Parameters
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 |
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/search?query=monzo&limit=5" \
-H "X-API-Key: sr_your_api_key"Response
{ "data": CompanySummary[], "meta": ListMeta }{
"data": [
{
"id": "5130a5e4000064000525c7e9",
"domain": "www.monzo.com",
"name": "Monzo",
"trust_score": 4.6,
"stars": 4.5,
"review_count": 74600,
"logo_url": "https://s3-eu-west-1.amazonaws.com/tpd/logos/.../0x0.png",
"categories": [{ "id": "bank", "name": "Bank", "is_primary": true }],
"contact": { "website": "https://www.monzo.com", "email": null, "phone": null,
"address": null, "city": "London", "zip_code": null, "country": "United Kingdom" },
"trustpilot_url": "https://www.trustpilot.com/review/www.monzo.com"
}
],
"meta": { "credits_used": 1, "cache_hit": false, "count": 5, "total": 23,
"has_more": true, "next_cursor": "eyJ..." }
}Every field is described in the response models. Successful responses also carry the X-Credits-Used header.
Cost
Search is billed by volume: 1 credit per 10 results (min 1). A search with limit=10 costs 1 credit, a search with limit=50 costs 5 credits. You pay for the results returned, so an empty result page costs nothing.
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.
{
"detail": {
"error": "invalid_parameter",
"message": "query: String should have at least 1 character"
}
}| HTTP | error | Meaning |
|---|---|---|
| 400 | invalid_parameter | A parameter is invalid: bad domain, stars, language or date, missing query, limit out of range... |
| 401 | missing_api_key | No API key in X-API-Key or Authorization: Bearer. |
| 401 | invalid_api_key | The key does not exist or has been revoked. |
| 402 | insufficient_credits | Your credit balance is 0. |
| 422 | invalid_cursor | The cursor is malformed, tampered with, or was created for other filters. |
| 429 | rate_limit_exceeded | Too many requests per minute. |
| 429 | insufficient_credits_retry_later | The balance ran out on recent calls and the key is cooling down. |
| 502 | upstream_changed | Trustpilot changed its page format and the response could not be read. |
| 503 | upstream_blocked | Trustpilot is temporarily blocking requests. |
| 504 | upstream_timeout | Trustpilot did not answer in time. |
What to do for each code: error handling.
Use cases
- Turn a list of brand names from a CRM or a spreadsheet into Trustpilot domains before reading their reviews.
- Autocomplete a company picker in your own product with names, logos and TrustScores.
- Check whether a supplier or a merchant has a Trustpilot profile at all before onboarding it.
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 reviews GET /v1/companies/{domain}/reviews: The reviews of a company, with filters and cursor pagination.
ScrapeReviews is an independent service and is not affiliated with or endorsed by Trustpilot.