Trustpilot

List Trustpilot business reviews

List a business's Trustpilot reviews with text, rating, dates, reviewer and the business's reply, filtered by stars, language, period, topic or text.

GET/v1/trustpilot/business/reviews
x-api-keystringheader

API key (`sfk_...`)

Parameters
10
domainstringrequiredquery

The business's Trustpilot domain, e.g. `www.amazon.com` (`domain` in search results), or its Trustpilot page URL. Trustpilot moves a domain to the form it lists, so `amazon.com` answers as `www.amazon.com`.

min 1 chars · max 500 chars

sortstringoptionalquery

`recency` (default): newest first. `relevance`: the order the site shows first.

one of: recency, relevance

languagestringoptionalquery

Only reviews written in this language, e.g. `en` or `de`. Omit for every language. The business endpoint's `languages` lists the codes with counts.

pattern: ^[a-z]{2}$

starsarrayoptionalquery

Only reviews with these star ratings, e.g. `5` or `1,2`. Omit for every rating.

datestringoptionalquery

Only reviews from this period: `last30days`, `last3months`, `last6months` or `last12months`. Omit for all time.

one of: last30days, last3months, last6months, last12months

querystringoptionalquery

Only reviews that mention this text, e.g. `refund`.

min 1 chars · max 100 chars

topicstringoptionalquery

Only reviews about this topic, e.g. `delivery_service`: an `id` from the business endpoint's `topics`.

pattern: ^[a-z0-9_]{1,64}$

verifiedbooleanoptionalquery

`true`: only reviews Trustpilot verified as from a real customer.

withRepliesbooleanoptionalquery

`true`: only reviews the business replied to.

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page. It only works with the same parameters.

min 1 chars · max 1024 chars · pattern: ^[A-Za-z0-9_-]+$

Response fields
41

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when Trustpilot has no business with this domain; a business with no reviews (or none that match) is `found` with an empty list.

one of: found, not_found

datadomain
string

The domain asked for, or the one Trustpilot moved it to (`www.amazon.com` for `amazon.com`).

databusinessId
stringnullable

Trustpilot business id; null when not found.

databusinessName
stringnullable

Business name.

datatotalResults
integernullable

Reviews that match the parameters, across every page. Only the first 200 of them can be listed: see `page.truncated`.

Reviews on this page.

datareviews[]id
string

Review id.

datareviews[]url
string

The review's own page on Trustpilot.

datareviews[]title
stringnullable

Review title.

datareviews[]text
stringnullable

The review.

datareviews[]rating
integernullable

Stars given, 1 to 5.

datareviews[]language
stringnullable

Language, e.g. `en`.

datareviews[]publishedAt
stringnullable

When it was posted, ISO 8601.

datareviews[]experiencedAt
stringnullable

When the reviewer's experience took place, ISO 8601.

datareviews[]updatedAt
stringnullable

When it was last edited, ISO 8601; null if never.

datareviews[]likes
integernullable

Readers who marked it useful.

datareviews[]isVerified
booleannullable

Whether Trustpilot verified it as from a real customer.

datareviews[]verificationLevel
stringnullable

How Trustpilot labels it, e.g. `verified`, `invited` or `not-verified`.

datareviews[]source
stringnullable

How it was collected, e.g. `Organic` (written unprompted) or an invitation channel.

Who wrote it.

datareviews[]authorid
stringnullable

Reviewer's Trustpilot id.

datareviews[]authorname
stringnullable

Reviewer's display name.

datareviews[]authorcountryCode
stringnullable

Reviewer's country, e.g. `GB`.

datareviews[]authorreviewCount
integernullable

Reviews the reviewer has written on Trustpilot.

datareviews[]authorimageUrl
stringnullable

Reviewer's picture.

datareviews[]authorisVerified
booleannullable

Whether Trustpilot verified the reviewer.

The business's public reply; null when it has not replied.

datareviews[]replytext
stringnullable

The business's reply.

datareviews[]replypublishedAt
stringnullable

When it replied, ISO 8601.

datareviews[]replyupdatedAt
stringnullable

When it last edited the reply, ISO 8601.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

datapagetruncated
boolean

True when more rows exist than this list can reach: it stops here before its end, and `totalResults` gives the true total.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/trustpilot/business/reviews?domain=www.amazon.com" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Trustpilot reviews of a business.