Trustpilot API endpoint
Searches Trustpilot categories for the required `q`. `size` sets the maximum number of categories (default 20, from 1 to 100), `country` is a two-letter code (default US) and `locale` uses `ll-CC` format (default `en-US`). Each category has its `category_id`, `display_name` and `top_level_category_id`.
/trustpilot/categories/searchQuery parameters:
q: required. Search query. Example: openai.country: optional. Two-letter country code; defaults to US. Example: US.locale: optional. Locale in ll-CC format; defaults to en-US. Example: en-US.size: optional. Maximum number of categories; defaults to 20. Example: 3. Minimum: 1. Maximum: 100.| Field | Filled in, of 40 checked |
|---|---|
| category_id | 40 |
| display_name | 40 |
| top_level_category_id | 40 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| q | string | Yes | Search query | openai | |
| country | string | No | US | Two-letter country code; defaults to US | US |
| locale | string | No | en-US | Locale in ll-CC format; defaults to en-US | en-US |
| size | integer | No | 20 | Maximum number of categories; defaults to 20 Minimum: 1. Maximum: 100. | 3 |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/trustpilot/categories/search?q=openai&country=us" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"query": "software",
"country": "US",
"locale": "en-US",
"size": 3,
"categories": []
}
}Request schema
No body schema
Response schema
#/definitions/trustpilot.categorySearchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | trustpilot.CategorySearchResponse | No | ||||
| data.categories | array | No | Categories matching the query. | |||
| data.categories[].category_id | string | No | software_company | Trustpilot category id, such as `software_company`. | ||
| data.categories[].display_name | string | No | Software Company | Display name of the category. | ||
| data.categories[].top_level_category_id | string | No | electronics_technology | Id of the top-level category group the category belongs to. | ||
| data.country | string | No | US | Two-letter country code the search was run for. | ||
| data.locale | string | No | en-US | Locale the search was run for, such as `en-US`. | ||
| data.query | string | No | openai | Query that was run. | ||
| data.size | integer | No | 3 | Maximum number of categories requested. | ||
| msg | string | No | OK |
| 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 |
| 503 | Trustpilot upstream request failed | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/trustpilot/categories/search?q=openai&country=us" \
-H "x-api-key: $CRAWLORA_API_KEY"