Black Falcon Data

Posted on Aug 21 Edited on Aug 24

Trustpilot API schema: fields, filters, and what is missing

#webscraping #api

The Trustpilot API is best evaluated through its schema. Below are all 96 fields, organized by what they describe, along with the filters that narrow a run before it costs anything.

Here is what our own Trustpilot Actor returns, what it costs, and where its coverage ends.

Every field

Each record contains 96 fields, divided into these groups:

company — companyDomain, companyName, companyTrustScore, companyStars, companyTotalReviews, companyWebsite, companyIsClaimed, companyCategories, companyCity, companyCountry, companyContactEmail, companyContactPhone, +31 more
is — isVerified, isComplaint, isFiltered, isPending, isRepost
reviewer — reviewerName, reviewerCountry, reviewerTotalReviews, reviewerIsVerified, reviewerImageUrl
review — reviewId, reviewUrl, reviewSource, reviewSourceName
reply — replyText, replyDate, replyUpdatedDate, replyDelayDays
language — language, languageDistribution
verification — verificationLevel, verificationSource
reviews — reviewsOnSameDomain, reviewsOnSameLocation
has — hasCompanyReply, hasUnhandledReports
repost — repostOfId, repostDetectedAt

These are the first fields from one row in a real dataset:

{
 "type": "review",
 "reviewId": "6a8b92e1f308e437698f500f",
 "reviewUrl": "https://www.trustpilot.com/reviews/6a8b92e1f308e437698f500f",
 "companyDomain": "booking.com",
 "companyName": "Booking.com",
 "rating": 1,
 "title": "Leaving people stranded in airports is...",
 "text": "Leaving people stranded in airports is atrocious. ",
 "contentHash": "47a65723c28306618b3373155d889d04c9b1b73f7c9581b1c6a2a48fcdc9c32c",
 "language": "en",
 "reviewSource": "Organic",
 "likes": 1,
 "publishedDate": "2026-08-24T02:40:01.000Z",
 "experiencedDate": "2026-08-05T00:00:00.000Z"
}

Filters that narrow a run

The input accepts 51 options, including mode, companyDomain, companyDomains, companyName, startUrls, searchQuery, searchCountry, searchMaxPages, categoryUrl, maxResults, stars, languages, date, lookbackDays, topics, verified, withReplies, sort, countryOfReviewer, search, and more.

These filters run server-side. You pay for the records you requested instead of producing a larger dataset and filtering it afterwards.

What it costs

Pricing is per event, with no subscription:

$0.005 per actor start
$0.00025 per result

Here is a measured run, not an estimate:

25 records in 2.9 seconds
cost: $0.00035 — about $0.01 per 1,000 records

What people use it for

Reputation monitoring. Ratings and review text reveal movement over time that a single page view cannot show.
Lead lists. Company-level fields let you isolate the relevant segment before anyone opens a CRM.
Change detection. Timestamps make it possible to diff runs and act on new records instead of re-reading everything.
Geographic analysis. Location fields allow market-by-market comparisons without another data source.

The honest caveats

An empty field means the source showed nothing. Values are never inferred or filled in from elsewhere.
The schema follows Trustpilot's markup. A redesign can add, rename or drop fields.
Anything Trustpilot puts behind a login is absent from every field below, by design.

Coverage and behavior

Not every field is populated. Fields are not guessed: when the source leaves one blank, it comes back blank. An empty value therefore means Trustpilot did not show one, not that extraction failed.

For market-specific runs, searchCountry narrows the request before any records are produced. You pay for the market you requested instead of filtering the results afterwards.

The source-level filters include searchMaxPages, categoryUrl, maxResults, and date. This affects cost as well as convenience. Filtered-out records are never produced, so they are never billed.

Every run reads Trustpilot when it runs, with no cached copy in between. Two runs a week apart provide two snapshots, enabling change detection.

To fetch only recent changes, use lookbackDays. Without it, a re-run returns the full set again, leaving deduplication to your side.

There is no public bulk export or API. The field list above comes from parsing pages rather than a documented schema.

Try it

If these fields match your requirements, the Trustpilot API, maintained against the live site produces them. New accounts get $5 of free platform credit each month, enough to cover a real run of this size several times over.

Disclosure: we build and maintain this Actor, and the link above is an affiliate link.

DEV Community