Company profile endpoint
https://api.scrapereviews.com/v1/companies/{domain}2 creditsThe company profile endpoint returns everything Trustpilot publishes about a business on its review page, as one JSON object: the TrustScore and the star rating, the total number of reviews and the reviews of the last 12 months, the distribution of reviews by star, the languages they are written in, the categories, the description and the public contact details.
It also tells you how the company behaves on Trustpilot: whether the profile is claimed and since when, whether the company pays for Trustpilot features, how often it replies to reviews, how many days a reply takes on average and when it last answered a negative review. Closed companies and consumer alerts are flagged.
The domain is flexible: a bare domain, a domain with www, a full URL of the company website or a Trustpilot review URL all work. When Trustpilot redirects a domain to another one (after a rebrand, for example) the redirect is followed and data.domain holds the canonical domain to use in later calls.
Parameters
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) |
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?include_similar=true" \
-H "X-API-Key: sr_your_api_key"Response
{ "data": Company, "meta": BaseMeta }{
"data": {
"id": "5130a5e4000064000525c7e9",
"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 }],
"country": "GB",
"is_claimed": 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" },
"similar": [ /* CompanySummary */ ],
"trustpilot_url": "https://www.trustpilot.com/review/www.monzo.com"
},
"meta": { "credits_used": 2, "cache_hit": false }
}Every field is described in the response models. Successful responses also carry the X-Credits-Used header.
Cost
A company profile costs 2 credits, with or without include_similar. Profiles are cached for 24 hours; a cached answer costs the same and is marked meta.cache_hit = true.
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": "company_not_found",
"message": "No Trustpilot profile found for 'example-shop.com'"
}
}| 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. |
| 404 | company_not_found | No company page exists for this domain. |
| 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
- Show the TrustScore and the review count of merchants or partners in your own dashboard.
- Monitor how your competitors answer negative reviews with reply_behavior.
- Enrich lead lists with the category, country and contact details of each company.
Related endpoints
- Company reviews GET /v1/companies/{domain}/reviews: The reviews of a company, with filters and cursor pagination.
- 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.