Look up companies on Trustpilot by name, brand or keyword. Each match comes back with its domain, TrustScore, star rating, review count, categories, location and published contact details. The domain on a result is the identifier every other Trustpilot endpoint takes, so this is the route that turns a brand name into something you can fetch a profile or reviews for.

POST /search-companies Companies

https://api.fetchlayer.dev/trustpilot/search-companies

OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

query string required

Company name, brand, or keyword to look up.

limit number optional

Maximum companies returned (max 1000), or -1 for everything available. (default: 10)

pages number optional

Pages of results to collect in one request (max 100), or -1 for the maximum allowed.

cursor string optional

Resume from a previous response's nextCursor.

delayMs number optional

Milliseconds to wait between pages (max 30000).

format string optional

json or markdown. (default: json)

timeoutMs number optional

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

Response Fields

search-companies

Find companies by name

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.

query string

The search term this response answers.

companies object[]

The matching companies.

companies[].domain string

The company’s identifier on Trustpilot — the handle for company-profile and company-reviews.

companies[].companyId string

Trustpilot’s internal company id.

companies[].displayName string

Company name as shown on the profile.

companies[].profileUrl string

Public Trustpilot profile URL.

companies[].trustScore number

TrustScore from 0 to 5, to one decimal place.

companies[].stars number

The score rounded to the nearest half star.

companies[].reviewCount number

Total reviews the company has.

companies[].categories object[]

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

companies[].location object

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

companies[].contact object

Website, email and phone, where published.

companyCount number

Number of companies in this response.

totalMatchCount number

Matches Trustpilot reports across every page. Capped upstream on broad queries.

pagesScraped number

Pages actually collected. Each page counts as one request against your plan.

pagesRequested number

Pages this request asked for. Lower than pagesScraped means the walk stopped early — notes says why.

nextCursor string

Pass back as cursor to continue, or null when there is nothing further to collect.

hasNextPage boolean

Whether more results are available beyond this response.

Request

curl -X POST "https://api.fetchlayer.dev/trustpilot/search-companies" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"query":"meal kit delivery","limit":10}'

Response

{
  "resultType": "company-search",
  "query": "meal kit delivery",
  "companyCount": 10,
  "totalMatchCount": 184,
  "hasNextPage": true,
  "notes": [],
  "companies": [
    {
      "domain": "hellofresh.com",
      "displayName": "HelloFresh",
      "trustScore": 4.2,
      "stars": 4,
      "reviewCount": 97539,
      "profileUrl": "https://www.trustpilot.com/review/hellofresh.com"
    }
  ]
}

{
  "error": "Invalid API key"
}