Company profile endpoint

GEThttps://api.scrapereviews.com/v1/companies/{domain}2 credits

The 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

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)

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

Shape
{ "data": Company, "meta": BaseMeta }
Example (shortened)
{
  "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.

Example error
{
  "detail": {
    "error": "company_not_found",
    "message": "No Trustpilot profile found for 'example-shop.com'"
  }
}
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.
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

  • 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.