Trustpilot

Trustpilot Category Businesses API

Businesses ranked in one Trustpilot category for one country, 20 per page, each with its TrustScore, star rating, review count, categories, website, location, and the email and phone it published. Sort by relevance, review count or latest review, set a minimum star rating, or keep claimed profiles only. Costs 2 credits per request.

POST/api/v1/trustpilot/category

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

category_idstringrequired

A category id from the Categories endpoint (lowercase letters, digits and underscores).

Example: vpn_service

countrystringdefault:US

2-letter country code.

Example: GB

sortenum<string>default:most_relevant

Ranking order.

Example: reviews_count

most_relevant — Trustpilot's default ranking.
reviews_count — Most reviews first.
latest_review — Most recently reviewed first.

min_trust_scorenumber

Minimum star rating: 3, 4 or 4.5. Trustpilot rounds the TrustScore to stars before filtering, so 4 also includes businesses with a TrustScore of 3.8 or 3.9 (shown as 4 stars). Filter on trust_score yourself for an exact floor.

Example: 4

claimed_onlybooleandefault:false

Only businesses that have claimed their Trustpilot profile.

Example: true

pageintegerdefault:1

Results page, 1-based (1-1000), 20 businesses per page. Stop at total_pages.

Example: 2

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.trustpilot.category("vpn_service", sort="reviews_count", claimed_only=True)

# The star filter is a floor only; find low-rated businesses client-side.
for b in res["data"]["businesses"]:
    if b["trust_score"] is not None and b["trust_score"] < 3:
        print(b["name"], b["trust_score"], b["email"], b["phone"])

Response

"category_id": "vpn_service",

"name": "VPN Service",

"parent_id": "internet_software",

"business_count": 1046,

"subcategories": [],

"country": "US",

"page": 1,

"per_page": 20,

"total_results": 755,

"total_pages": 38,

"count": 20,

"response_time": 2014

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.trustpilot.category("vpn_service", sort="reviews_count", claimed_only=True) # The star filter is a floor only; find low-rated businesses client-side. for b in res["data"]["businesses"]: if b["trust_score"] is not None and b["trust_score"] < 3: print(b["name"], b["trust_score"], b["email"], b["phone"])