# SocialCrawl API — trustpilot endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/trustpilot

## GET /v1/trustpilot/business-search
Search Trustpilot businesses
Credit cost: 1 (standard)
Parameters:
- query (required) — Business name or keyword (e.g. 'nike'). Matches companies, not products; do not pass a bare domain.
- depth (optional, integer) — Number of business results to retrieve (default 20, multiples of 10, max 140). More results = longer task time.
curl "https://www.socialcrawl.dev/v1/trustpilot/business-search?query=nike" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/trustpilot/reviews
Get Trustpilot reviews for a business
Credit cost: 5 (advanced)
Parameters:
- domain (required) — The business's domain on Trustpilot (e.g. 'www.nike.com' or 'booking.com'), from business-search.
- depth (optional, integer) — Number of reviews to retrieve (default 20, multiples of 20, max 200). There is no pagination beyond 200.
- sort (optional, enum: recency | relevance) — Review ordering: `recency` (newest first, default) or `relevance`.
curl "https://www.socialcrawl.dev/v1/trustpilot/reviews?domain=www.nike.com" \
  -H "x-api-key: sc_your_api_key_here"