Business search
1 credit/v1/trustpilot/business-searchSearch Trustpilot businesses by name or keyword. Returns domains and review counts. Matches companies, not products. First calls can take ~15-45s. Standard tier (1 credit).
query, depth
Fetch Trustpilot business search and company reviews as structured JSON with one SocialCrawl API key. Shared review schema. Reads are priced in credits.
2 active endpoints. Search then reviews.
Two live read endpoints for Trustpilot. Find a company domain, then pull reputation reviews. Company reviews only. Not product SKU reviews.
/v1/trustpilot/business-searchSearch Trustpilot businesses by name or keyword. Returns domains and review counts. Matches companies, not products. First calls can take ~15-45s. Standard tier (1 credit).
query, depth
/v1/trustpilot/reviewsCustomer reviews for a business domain from search. Stars, text, verified flags, owner responses. Company reputation, not product SKUs. Advanced tier (5 credits).
domain, depth, sort
Returns Trustpilot businesses matching a keyword: company name, its Trustpilot domain, its own website, its review page URL, and total review count.
Use it to find a company's Trustpilot domain, which the reviews endpoint needs. It matches businesses, not products.
1 credit
query · Business name or keyword (e.g. 'nike'). Matches companies, not products; do not pass a bare domain.
$ curl https://www.socialcrawl.dev/v1/trustpilot/business-search?query=nike&depth=20 \
-H "x-api-key: sc_YOUR_API_KEY"// Running this live needs your own API key. Hit "Try it" to see an example responseTrustpilot is a normal SocialCrawl data surface. You call GET /v1/trustpilot/… with an API key, spend credits on live misses, and get a single JSON envelope back.
Send your key in the x-api-key header. No Trustpilot OAuth app for public reads. The same key works across SocialCrawl platforms.
All Trustpilot routes are GET. Pass query, domain, depth, sort as query strings. We validate formats before charging.
business-search costs 1 credit. reviews costs 5 credits. A cold task can take 15-45s, then cache.
Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Lists also carry pagination when the route pages.
Most products discover entities first, then deepen detail and reviews only when needed.
GET /v1/trustpilot/business-search?query=…AuthorList of businesses with domain ids
Reviews require a Trustpilot domain, not a product ASIN.
GET /v1/trustpilot/reviews?domain=…ReviewList for the company domain
Brand reputation text for VoC.
GET /v1/trustpilot/reviews?domain=…&sort=relevanceSame ReviewList ordered by relevance or recency
Pick recency for monitoring, relevance for research.
GET /v1/trustpilot/reviews?domain=…&depth=100Larger review window up to platform max
Depth controls rows in one call; no infinite cursor.
GET /v1/trustpilot/business-search?query=nike&depth=20
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/trustpilot/reviews?domain=www.nike.com&depth=20&sort=recency{
"success": true,
"data": {
"items": [
{
"author": {
"id": "www.nike.com",
"username": "www.nike.com",
"display_name": "Nike",
"posts_count": 12000,
"url": "https://www.trustpilot.com/review/www.nike.com"
}
}
]
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}Field names match the rest of SocialCrawl where archetypes align. Parse once, reuse across platforms.
business display name, domain id, review count, Trustpilot url
items[] with rating, text, verified, responses[], published_at
depth-capped single page, max 200
no reviews domain returns 404 and refunds
Same request lifecycle as every other /v1 platform endpoint. Trustpilot is not a sidecar.
Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).
Registry lookup finds trustpilot/business-search (or reviews). Required params and format checks run first. Invalid input returns 400 with no charge. Valid calls debit the tier cost atomically before upstream work.
A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0. Miss: Trustpilot tasks are spin-polled server-side. Retries on 5xx/network with a circuit breaker if the source is unhealthy.
Upstream JSON is mapped to commerce archetypes (Product, ProductList, ReviewList, SellerList, App, PlaceList as applicable), validated against the canonical Zod schema, then wrapped in the success envelope and logged for billing audit.
Billing rules that matter in production
Trustpilot is public read data. We normalize it into the SocialCrawl schema so your code does not learn a second vendor SDK.
Public company profiles and customer reviews about the business. Not product pages.
Business profile and review reads run as server-side tasks. The async lifecycle stays server-side.
AuthorList for businesses and ReviewList for domain reviews.
No invite-to-review, reply-as-business, or private analytics.
The jobs this API is most often used for.
Brand reputation and support-quality monitoring
Callers concentrate on search or taxonomy, then deepen detail and reviews for shortlisted entities. Company-level Trustpilot reviews by domain with a flat 5-credit pull after 1-credit search. No Trustpilot partner OAuth.
Live misses are typically a few seconds. Some routes can take longer on cold cache.
The jobs Trustpilot data is most often used for. Each one is a full recipe with the endpoint chain and pricing.
Common ways teams put this data to work, and the stack each one tends to run.
business-search for domains, reviews for recency monitoring.
reviews by domain with depth for language mining.
search peer brands, sample review volume and tone.
Search is 1 credit. Reviews are 5. Cache hits are free.
curl "https://www.socialcrawl.dev/v1/trustpilot/business-search?query=nike&depth=20" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/trustpilot/reviews?domain=www.nike.com&depth=20&sort=recency" \
-H "x-api-key: sc_your_api_key_here"Same key as the rest of the catalog
Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.
Same Trustpilot data, two very different paths. Auth, rate limits, schema, and cost, side by side.
| Feature | SocialCrawl | DIY scraping |
|---|---|---|
| Authentication | One x-api-key, sign up and call | None, but you manage proxies and anti-bot evasion yourself |
| Setup | Two GET requests: business-search, then reviews | Headless browser, proxy pool, HTML parsers, and retry logic to build |
| Response schema | Unified ReviewList JSON shared with 64 other platforms | Raw HTML you parse. Selectors break when Trustpilot redesigns |
| Pricing | 1 credit per search, 5 per review pull; 100 free credits, no card | Proxy and compute costs plus ongoing engineering time |
| Data coverage | Star ratings, full text, verified flags, language, and owner replies, up to 200 reviews per call | Whatever your parser extracts before the markup changes |
| Maintenance | Upstream changes absorbed by SocialCrawl | You fix the scraper every time the page structure shifts |
Authentication
Setup
Response schema
Pricing
Data coverage
Maintenance
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usAsk AI about SocialCrawl