# Social Fetch API - Trustpilot endpoints # Base URL: https://api.socialfetch.dev # Auth: x-api-key header (sfk_...) # Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json # Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json 3 documented Trustpilot operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported. ## GET /v1/trustpilot/search Search Trustpilot businesses Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/trustpilot/search/get.mdx SDK: client.trustpilot.searchBusinesses({ query: "coffee" }) Parameters: - query (required, string) - Business name or keyword, e.g. `coffee` or `nike`, up to 100 characters. A domain such as `amazon.com` answers with that business. - minTrustScore (optional, string, enum: 3 | 4 | 4.5) - Only businesses with at least this TrustScore: `3`, `4` or `4.5`. - minReviews (optional, string, enum: 25 | 50 | 100 | 250 | 500) - Only businesses with at least this many reviews: `25`, `50`, `100`, `250` or `500`. - claimed (optional, boolean) - `true`: only businesses that have claimed their profile. - location (optional, string) - Only businesses in this place, e.g. `London`. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same parameters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. curl "https://api.socialfetch.dev/v1/trustpilot/search?query=coffee" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/trustpilot/business Get Trustpilot business Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/trustpilot/business/get.mdx SDK: client.trustpilot.getBusiness({ domain: "www.amazon.com" }) Parameters: - domain (required, string) - The business's Trustpilot domain, e.g. `www.amazon.com` (`domain` in search results), or its Trustpilot page URL. Trustpilot moves a domain to the form it lists, so `amazon.com` answers as `www.amazon.com`. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/trustpilot/business?domain=www.amazon.com" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/trustpilot/business/reviews List Trustpilot business reviews Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/trustpilot/business/reviews/get.mdx SDK: client.trustpilot.listBusinessReviews({ domain: "www.amazon.com", stars: "1,2" }) Parameters: - domain (required, string) - The business's Trustpilot domain, e.g. `www.amazon.com` (`domain` in search results), or its Trustpilot page URL. Trustpilot moves a domain to the form it lists, so `amazon.com` answers as `www.amazon.com`. - sort (optional, string, enum: recency | relevance) - `recency` (default): newest first. `relevance`: the order the site shows first. - language (optional, string) - Only reviews written in this language, e.g. `en` or `de`. Omit for every language. The business endpoint's `languages` lists the codes with counts. - stars (optional, array) - Only reviews with these star ratings, e.g. `5` or `1,2`. Omit for every rating. - date (optional, string, enum: last30days | last3months | last6months | last12months) - Only reviews from this period: `last30days`, `last3months`, `last6months` or `last12months`. Omit for all time. - query (optional, string) - Only reviews that mention this text, e.g. `refund`. - topic (optional, string) - Only reviews about this topic, e.g. `delivery_service`: an `id` from the business endpoint's `topics`. - verified (optional, boolean) - `true`: only reviews Trustpilot verified as from a real customer. - withReplies (optional, boolean) - `true`: only reviews the business replied to. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same parameters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/trustpilot/business/reviews?domain=www.amazon.com" \ -H "x-api-key: YOUR_API_KEY"