List category companies
Returns one page of a Trustpilot category directory: 20 companies with TrustScore, rating, review count, location and claim status, in Trustpilot's own ranking. Requires slug. data is null when Trustpilot has no page for that slug.
1 credit / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
slug*string
The category slug from a Trustpilot URL — the bank in /categories/bank. Lowercase words joined by underscores, so travel_insurance_company is one too. A pasted category URL is accepted and reduced to the slug for you.
page?integer
Which page of the directory. Read total_hits to size the walk — the sampled category reported 1,713 companies.
Range
1 <= value <= 10000Default
1country?string
Two-letter country code to filter the directory, e.g. US. Omit it to let Trustpilot choose.
curl -X GET "https://example.com/v1/trustpilot/category?slug=bank" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "slug": "bank", "page": 1, "requested_page": 1, "page_clamped": false, "country": "US", "count": 20, "total_hits": 1713, "filters": { "country": "US", "sort": "recommended" }, "results": [ { "business_unit_id": "5060f52a00006400051bf99f", "identifying_name": "happen.com", "display_name": "Happen Bank", "url": "https://www.trustpilot.com/review/happen.com", "trust_score": 4.7, "stars": 4.5, "rating_scale_max": 5, "review_count": 14357, "location": { "address": "88 Kearny Street", "city": "San Francisco" }, "categories": [ { "id": "shoe_store", "name": "Shoe Store", "is_primary": false } ], "is_claimed": true, "logo_url": "https://s3-eu-west-1.amazonaws.com/tpd/x/198x149.png", "contact": { "property1": null, "property2": null } } ], "usage_note": "Each result's `identifying_name` is the exact value `/trustpilot/company` takes as `domain` — walk a category and fetch every company on it without constructing a URL." }}