Trustpilot API endpoint

Search Trustpilot business units

Returns normalized business-unit search results from Trustpilot's JSON business-unit search API.

GETapiKey3 credits/requesttrustpilot.businessSearchResponseDoc/trustpilot/business-units/search

Parameters

Name	In	Type	Required	Example	Description
q	query	string	Yes	openai	Search query
country	query	string	No	US	Two-letter country code; defaults to US
page	query	integer	No	1	1-based page number; defaults to 1
page_size	query	integer	No	5	Results per page; defaults to 20, maximum 100
x-api-key	header	string	Yes		API key required

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost: 3 credits/request
Charged response: Successful 2xx responses

Plan	Price	Included credits	Daily cap	Rate limit	Overage
Free	$0/mo	2,000	500 daily credits	5/min	No overage
Starter	$9/mo	20,000	5,000 daily credits	15/min	$0.75/1,000 overage credits when enabled
Growth	$29/mo	100,000	25,000 daily credits	45/min	$0.45/1,000 overage credits when enabled
Pro	$79/mo	400,000	No daily cap	120/min	$0.30/1,000 overage credits
Business	$199/mo	1,200,000	No daily cap	300/min	$0.20/1,000 overage credits
Enterprise	$499/mo	5,000,000	No daily cap	1,000/min	$0.12/1,000 overage credits

Failure responses

Status	Description	Schema
400	Missing or invalid query parameters	#/definitions/app.Response
404	No results found	#/definitions/app.Response
429	Rate limit exceeded	#/definitions/app.Response
500	Internal server error	#/definitions/app.Response
502	Trustpilot upstream request failed	#/definitions/app.Response

Example response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "openai",
    "country": "US",
    "page": 1,
    "page_size": 5,
    "items": []
  }
}

Request schema

No body schema

Response schema

#/definitions/trustpilot.businessSearchResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	trustpilot.SearchResponse	No
data.country	string	No	US
data.items	array	No
data.items[].address	trustpilot.SearchAddress	No
data.items[].address.approximate_area	trustpilot.SearchAreaBounds	No
data.items[].address.approximate_area.north_west	trustpilot.SearchCoordinates	No
data.items[].address.approximate_area.north_west.lat	number	No	39.7837304
data.items[].address.approximate_area.north_west.lon	number	No	-100.445882
data.items[].address.approximate_area.south_east	trustpilot.SearchCoordinates	No
data.items[].address.approximate_area.south_east.lat	number	No	39.7837304
data.items[].address.approximate_area.south_east.lon	number	No	-100.445882
data.items[].address.city	string	No	San Francisco
data.items[].address.coordinates	trustpilot.SearchCoordinates	No
data.items[].address.coordinates.lat	number	No	39.7837304
data.items[].address.coordinates.lon	number	No	-100.445882
data.items[].address.country	string	No	United States
data.items[].address.country_code	string	No	US
data.items[].address.postcode	string	No	94105
data.items[].address.street	string	No	1 Market St
data.items[].business_unit_id	string	No	630f21bc9f08b0302a52590d
data.items[].categories	array	No
data.items[].categories[].id	string	No	software_company
data.items[].categories[].name	string	No	Software Company
data.items[].categories[].primary	boolean	No	true
data.items[].country_code	string	No	FR
data.items[].display_name	string	No	OpenAI
data.items[].email	string	No	[email protected]
data.items[].identifying_name	string	No	openai.com
data.items[].logo_url	string	No	https://s3-eu-west-1.amazonaws.com/tpd/logos/example/0x0.png
data.items[].phone	string	No	+1-555-555-5555
data.items[].predicted_top_category	trustpilot.SearchCategory	No
data.items[].predicted_top_category.id	string	No	software_company
data.items[].predicted_top_category.name	string	No	Software Company
data.items[].predicted_top_category.primary	boolean	No	true
data.items[].review_count	integer	No	984
data.items[].stars	number	No	1.5
data.items[].trust_score	number	No	1.3
data.items[].trustpilot_url	string	No	https://www.trustpilot.com/review/openai.com
data.items[].verified	boolean	No	false
data.items[].website_url	string	No	https://openai.com
data.page	integer	No	1
data.page_size	integer	No	5
data.query	string	No	openai
data.search_mode	string	No	keyword
data.total_hits	integer	No	147
data.total_pages	integer	No	30
msg	string	No	OK

Example request

curl -X GET "https://api.crawlora.net/api/v1/trustpilot/business-units/search?q=openai&country=US&page=1&page_size=5" -H "x-api-key: <api-key>"

TypeScript fetch

const url = new URL("https://api.crawlora.net/api/v1/trustpilot/business-units/search");
url.searchParams.set("q", "openai");
url.searchParams.set("country", "US");
url.searchParams.set("page", "1");
url.searchParams.set("page_size", "5");
const headers = new Headers();
headers.set("x-api-key", "<api-key>");
const response = await fetch(url, {
  method: "GET",
  headers,
});
const payload = await response.json();

Open in Playground Back to group