Trustpilot API — Company Profile & TrustScore
Documentation menu
FetchLayer FetchLayer API

Get a company’s rating summary

Read a company’s Trustpilot profile in one call: TrustScore, total review count, reviews in the last twelve months, and the full one-to-five star distribution. It also returns the category breadcrumb, location and contact details, whether the company has claimed the profile and is still collecting reviews, how often and how fast it replies to negative reviews, any consumer alert Trustpilot has published against it, and the review count per language — which is what tells you how to split a reviews pull that would otherwise hit the 200-review ceiling.

POST /company-profile Companies
https://api.fetchlayer.dev/trustpilot/company-profile
OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

company string required

Company domain (for example hellofresh.com), or a Trustpilot company URL.

format string optional

json or markdown. (default: json)

timeoutMs number optional

Per-request time limit in milliseconds (max 600000).

Response Fields

company-profile

Get a company’s rating summary

blocked boolean

Always false on a successful response.

requestedUrl string

The Trustpilot URL this result corresponds to.

scrapedAt string

ISO 8601 timestamp of when the data was collected.

transport string

The upstream source this data came from. Always "trustpilot".

notes string[]

Caveats about this particular result — a list that hit a cap, a filter that narrowed it, a walk that stopped early. Read it: it is where a truncated or incomplete answer announces itself.

resultType string

Which shape this response is: company-search, company-profile, company-reviews, or review-detail.

profile object

The company’s full profile record.

profile.domain string

The company’s identifier on Trustpilot.

profile.displayName string

Company name as shown on the profile.

profile.trustScore number

TrustScore from 0 to 5, to one decimal place.

profile.reviewCount number

Total reviews the company has.

profile.reviewCountLast12Months number

Reviews published in the last twelve months.

profile.ratingDistribution object

How many reviews sit at each star rating. The five buckets sum to total — use them to plan a per-rating partition of a reviews pull.

profile.reviewLanguages object[]

Review count per language, with its two-letter code. The other axis to partition a reviews pull on.

profile.categories object[]

Categories the company is listed under, with which one is primary.

profile.categoryBreadcrumb string[]

The company’s position in the category tree, broadest level first.

profile.standing object

Whether the profile is claimed, closed, merged or still collecting reviews, plus verification flags.

profile.standing.consumerAlerts string[]

Warnings Trustpilot has published about this company.

profile.standing.replyPercentage number

Share of negative reviews the company replied to, 0-100.

profile.standing.averageDaysToReply number

How long the company typically takes to answer a negative review.

profile.location object

Address, city, zip code and country, where published.

profile.contact object

Website, email and phone, where published.

profile.locationsCount number

How many locations the company lists on Trustpilot.

Request

curl -X POST "https://api.fetchlayer.dev/trustpilot/company-profile" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"company":"hellofresh.com"}'

Response

{
  "resultType": "company-profile",
  "notes": [],
  "profile": {
    "domain": "hellofresh.com",
    "displayName": "HelloFresh",
    "trustScore": 4.2,
    "reviewCount": 97539,
    "reviewCountLast12Months": 21408,
    "ratingDistribution": {
      "total": 97539,
      "oneStar": 9211,
      "twoStar": 3044,
      "threeStar": 4102,
      "fourStar": 15880,
      "fiveStar": 65302
    },
    "standing": {
      "isClaimed": true,
      "isCollectingReviews": true,
      "replyPercentage": 92.4,
      "consumerAlerts": []
    },
    "reviewLanguages": [
      {
        "isoCode": "en",
        "displayName": "English",
        "reviewCount": 74120
      }
    ]
  }
}