Trustpilot

Search Trustpilot businesses

Search Trustpilot for businesses by name or keyword, with each one's domain, TrustScore, review count, location and contact details.

GET/v1/trustpilot/search
x-api-keystringheader

API key (`sfk_...`)

Parameters
6
querystringrequiredquery

Business name or keyword, e.g. `coffee` or `nike`, up to 100 characters. A domain such as `amazon.com` answers with that business.

min 1 chars · max 100 chars

minTrustScorestringoptionalquery

Only businesses with at least this TrustScore: `3`, `4` or `4.5`.

one of: 3, 4, 4.5

minReviewsstringoptionalquery

Only businesses with at least this many reviews: `25`, `50`, `100`, `250` or `500`.

one of: 25, 50, 100, 250, 500

claimedbooleanoptionalquery

`true`: only businesses that have claimed their profile.

locationstringoptionalquery

Only businesses in this place, e.g. `London`.

min 1 chars · max 100 chars

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
38

Endpoint-specific response payload.

dataquery
string

The query searched for.

datatotalResults
integernullable

Businesses that match, across every page.

Businesses on this page, best match first.

databusinesses[]id
string

Trustpilot business id.

databusinesses[]domain
string

Trustpilot domain, e.g. `www.amazon.com`: pass it as `domain` to the business and review endpoints.

databusinesses[]name
stringnullable

Business name.

databusinesses[]url
string

The business's Trustpilot page.

databusinesses[]logoUrl
stringnullable

Logo image.

databusinesses[]trustScore
numbernullable

TrustScore, 1 to 5; null with too few reviews.

databusinesses[]stars
numbernullable

Star rating the site shows, 1 to 5 in half stars.

databusinesses[]reviewCount
integernullable

Reviews on Trustpilot, every language.

databusinesses[]websiteUrl
stringnullable

The business's own website.

databusinesses[]email
stringnullable

Contact email the business lists.

databusinesses[]phone
stringnullable

Contact phone the business lists.

The business's address as listed on Trustpilot.

databusinesses[]locationaddress
stringnullable

Street address.

databusinesses[]locationcity
stringnullable

City.

databusinesses[]locationzipCode
stringnullable

Postal code.

databusinesses[]locationcountry
stringnullable

Country, as the site shows it, e.g. `United States`.

The business's categories, when the site shows them.

databusinesses[]categories[]id
string

Category id, e.g. `coffee_shop`.

databusinesses[]categories[]name
stringnullable

Category name.

databusinesses[]isRecommended
booleannullable

Whether Trustpilot recommends it in its categories.

Categories that match the query, on the first page only (empty after it).

datacategories[]id
string

Category id, e.g. `coffee_shop`.

datacategories[]name
stringnullable

Category name, e.g. `Coffee Shop`.

datacategories[]parentName
stringnullable

Top-level category, e.g. `Food, Beverages & Tobacco`.

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/search?query=coffee" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Trustpilot businesses matching a query.