POST /api/trustpilot/lists — Trustpilot companies with TrustScore, reviews, reply rate, the owner and key people, emails, phones and socials. Give at least one of categories, searchQueries or urls.
| Field | Type | Notes |
|---|---|---|
categories | string[] or string | Category IDs from trustpilot.com/categories/ |
searchQueries | string[] or string | Trustpilot company search keywords. Up to 20. |
urls | string[] or string | Trustpilot review / category / search pages, or plain company domains (example.com). Up to 50. |
maxPerSource | integer | 1–1000 per category, keyword and category/search link. Default 50. At most 5,000 per search. |
filters.country | string | US, GB, CA, AU, IE, NZ, DE, FR, ES, IT, NL, BE, DK, SE, NO, FI, AT, CH, PL, PT, IN, ZA, SG, AE. Default US. |
filters.city | string | Optional, categories only. |
filters.minTrustScore | string | "0" (any), "3", "4" or "4.5". Default "0". |
filters.onlyClaimed | boolean | Claimed profiles only (categories). Default false. |
filters.minReviewCount | integer | Default 0. |
filters.sort | string | most_relevant, reviews_count or latest_review. Default most_relevant. |
curl -X POST https://prospectcheap.com/api/trustpilot/lists \
-H "Authorization: Bearer pc_live_your_key" \
-H "Content-Type: application/json" \
-d '{"categories":["roofing_contractor"],"filters":{"country":"US","minTrustScore":"4","onlyClaimed":true},"maxPerSource":100}'Then
The response has list.id. Poll GET /api/trustpilot/lists/{id} until list.status is completed (or failed); the results are under businesses. See Search Status, Filter & Paginate and Export CSV.
Credits: one per result found. The most the search could cost is reserved when it starts; what isn't used comes back when it finishes.