Trustpilot API endpoint
Returns a Trustpilot category by `slug` (for example `software_company`), with the companies listed on one page; `page` is 1-based and defaults to 1. Each company has its display name, `identifying_name`, `trust_score`, `stars`, `review_count`, location, contact details, categories and Trustpilot URL. Also returns breadcrumbs, newest companies and `pagination.has_next_page`.
/trustpilot/category/{slug}Path parameters:
slug: required. Trustpilot category slug. Example: software_company.Query parameters:
page: optional. 1-based page number; defaults to 1. Example: 1. Minimum: 1.| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| business_unit_id | 20 | |
| display_name | 20 | |
| identifying_name | 20 | “lifelock.norton.com” and 19 other values |
| trustpilot_url | 20 | trustpilot.com |
| website_url | 20 | lifelock.norton.com and 19 other hosts |
| logo_url | 20 | s3-eu-west-1.amazonaws.com |
| review_count | 20 | 8,818 to 139,915, median 17,396 |
| trust_score | 20 | 4.2 to 5, median 4.5 |
| stars | 20 | 4 to 5, median 4.5 |
| recommended | 20 | true in 9 of 20 |
| location | 20 | |
| categories | 20 | median 1 entry |
| 12 | ||
| phone | 9 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| slug (path) | string | Yes | Trustpilot category slug | software_company | |
| page | integer | No | 1 | 1-based page number; defaults to 1 Minimum: 1. | 1 |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/trustpilot/category/software_company?page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"slug": "software_company",
"name": "Software Company",
"page": 1,
"items": []
}
}Request schema
No body schema
Response schema
#/definitions/trustpilot.categoryResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | trustpilot.CategoryResponse | No | ||||
| data.breadcrumbs | array | No | Parent categories leading to this category. | |||
| data.breadcrumbs[].name | string | No | Software Company | Display name of the category. | ||
| data.breadcrumbs[].slug | string | No | software_company | Category slug. Use it with the category endpoint. | ||
| data.breadcrumbs[].url | string | No | https://www.trustpilot.com/categories/software_company | URL of the category page on Trustpilot. | ||
| data.country | string | No | US | Country the listing is filtered to, as Trustpilot reports it. | ||
| data.items | array | No | Businesses listed on this page of the category. | |||
| data.items[].business_unit_id | string | No | 5e18c99abe863e0001b6ff0c | Trustpilot id of the business. | ||
| data.items[].categories | array | No | Categories the business is tagged with. | |||
| data.items[].categories[].category_id | string | No | software_company | Trustpilot category id, such as `software_company`. | ||
| data.items[].categories[].display_name | string | No | Software Company | Display name of the category. | ||
| data.items[].categories[].is_predicted | boolean | No | false | Whether Trustpilot predicted this category for the business. | ||
| data.items[].categories[].is_primary | boolean | No | true | Whether this is the business's primary category. | ||
| data.items[].display_name | string | No | Houzeo | Display name of the business on Trustpilot. | ||
| data.items[].email | string | No | support@houzeo.com | Contact email address of the business. | ||
| data.items[].identifying_name | string | No | www.houzeo.com | Business slug used in the Trustpilot profile URL, usually the website domain. Use it with the business endpoint. | ||
| data.items[].location | object | No | Location of the business. Omitted when Trustpilot lists none. | |||
| data.items[].location.address | string | No | Street address of the business. | |||
| data.items[].location.city | string | No | City of the business. | |||
| data.items[].location.country | string | No | Country of the business. | |||
| data.items[].location.zip_code | string | No | Postal code of the business. | |||
| data.items[].logo_url | string | No | https://s3-eu-west-1.amazonaws.com/tpd/screenshotlogo-domain/example/198x149.png | URL of the business's logo. | ||
| data.items[].phone | string | No | (844) 448-0110 | Contact phone number of the business. | ||
| data.items[].recommended | boolean | No | true | Whether Trustpilot recommends the business in its categories. | ||
| data.items[].review_count | integer | No | 3473 | Total number of reviews the business has on Trustpilot. | ||
| data.items[].stars | number | No | 5 | Star rating of the business, out of 5. | ||
| data.items[].trust_score | number | No | 4.8 | Trustpilot TrustScore of the business, as a decimal number. | ||
| data.items[].trustpilot_url | string | No | https://www.trustpilot.com/review/www.houzeo.com | URL of the business profile on Trustpilot. | ||
| data.items[].website_url | string | No | https://www.houzeo.com | Website address of the business. | ||
| data.name | string | No | Software Company | Display name of the category. | ||
| data.newest_companies | array | No | Businesses recently added to the category. | |||
| data.newest_companies[].business_unit_id | string | No | 5e18c99abe863e0001b6ff0c | Trustpilot id of the business. | ||
| data.newest_companies[].categories | array | No | Categories the business is tagged with. | |||
| data.newest_companies[].categories[].category_id | string | No | software_company | Trustpilot category id, such as `software_company`. | ||
| data.newest_companies[].categories[].display_name | string | No | Software Company | Display name of the category. | ||
| data.newest_companies[].categories[].is_predicted | boolean | No | false | Whether Trustpilot predicted this category for the business. | ||
| data.newest_companies[].categories[].is_primary | boolean | No | true | Whether this is the business's primary category. | ||
| data.newest_companies[].display_name | string | No | Houzeo | Display name of the business on Trustpilot. | ||
| data.newest_companies[].email | string | No | support@houzeo.com | Contact email address of the business. | ||
| data.newest_companies[].identifying_name | string | No | www.houzeo.com | Business slug used in the Trustpilot profile URL, usually the website domain. Use it with the business endpoint. | ||
| data.newest_companies[].location | object | No | Location of the business. Omitted when Trustpilot lists none. | |||
| data.newest_companies[].location.address | string | No | Street address of the business. | |||
| data.newest_companies[].location.city | string | No | City of the business. | |||
| data.newest_companies[].location.country | string | No | Country of the business. | |||
| data.newest_companies[].location.zip_code | string | No | Postal code of the business. | |||
| data.newest_companies[].logo_url | string | No | https://s3-eu-west-1.amazonaws.com/tpd/screenshotlogo-domain/example/198x149.png | URL of the business's logo. | ||
| data.newest_companies[].phone | string | No | (844) 448-0110 | Contact phone number of the business. | ||
| data.newest_companies[].recommended | boolean | No | true | Whether Trustpilot recommends the business in its categories. | ||
| data.newest_companies[].review_count | integer | No | 3473 | Total number of reviews the business has on Trustpilot. | ||
| data.newest_companies[].stars | number | No | 5 | Star rating of the business, out of 5. | ||
| data.newest_companies[].trust_score | number | No | 4.8 | Trustpilot TrustScore of the business, as a decimal number. | ||
| data.newest_companies[].trustpilot_url | string | No | https://www.trustpilot.com/review/www.houzeo.com | URL of the business profile on Trustpilot. | ||
| data.newest_companies[].website_url | string | No | https://www.houzeo.com | Website address of the business. | ||
| data.page | integer | No | 2 | Page number returned. | ||
| data.pagination | object | No | Paging details for the category listing. | |||
| data.pagination.has_next_page | boolean | No | true | Whether another page of businesses follows this one. | ||
| data.pagination.next_page | integer | No | 3 | Number of the next page. Omitted on the last page. | ||
| data.pagination.page | integer | No | 2 | Page number returned. | ||
| data.pagination.per_page | integer | No | 20 | Number of businesses per page. | ||
| data.pagination.total_hits | integer | No | 7963 | Total number of businesses in the category. | ||
| data.pagination.total_pages | integer | No | 399 | Total number of pages in the category. | ||
| data.recently_reviewed_companies | array | No | Businesses in the category that were reviewed recently. | |||
| data.recently_reviewed_companies[].business_unit_id | string | No | 5e18c99abe863e0001b6ff0c | Trustpilot id of the business. | ||
| data.recently_reviewed_companies[].categories | array | No | Categories the business is tagged with. | |||
| data.recently_reviewed_companies[].categories[].category_id | string | No | software_company | Trustpilot category id, such as `software_company`. | ||
| data.recently_reviewed_companies[].categories[].display_name | string | No | Software Company | Display name of the category. | ||
| data.recently_reviewed_companies[].categories[].is_predicted | boolean | No | false | Whether Trustpilot predicted this category for the business. | ||
| data.recently_reviewed_companies[].categories[].is_primary | boolean | No | true | Whether this is the business's primary category. | ||
| data.recently_reviewed_companies[].display_name | string | No | Houzeo | Display name of the business on Trustpilot. | ||
| data.recently_reviewed_companies[].email | string | No | support@houzeo.com | Contact email address of the business. | ||
| data.recently_reviewed_companies[].identifying_name | string | No | www.houzeo.com | Business slug used in the Trustpilot profile URL, usually the website domain. Use it with the business endpoint. | ||
| data.recently_reviewed_companies[].location | object | No | Location of the business. Omitted when Trustpilot lists none. | |||
| data.recently_reviewed_companies[].location.address | string | No | Street address of the business. | |||
| data.recently_reviewed_companies[].location.city | string | No | City of the business. | |||
| data.recently_reviewed_companies[].location.country | string | No | Country of the business. | |||
| data.recently_reviewed_companies[].location.zip_code | string | No | Postal code of the business. | |||
| data.recently_reviewed_companies[].logo_url | string | No | https://s3-eu-west-1.amazonaws.com/tpd/screenshotlogo-domain/example/198x149.png | URL of the business's logo. | ||
| data.recently_reviewed_companies[].phone | string | No | (844) 448-0110 | Contact phone number of the business. | ||
| data.recently_reviewed_companies[].recommended | boolean | No | true | Whether Trustpilot recommends the business in its categories. | ||
| data.recently_reviewed_companies[].review_count | integer | No | 3473 | Total number of reviews the business has on Trustpilot. | ||
| data.recently_reviewed_companies[].stars | number | No | 5 | Star rating of the business, out of 5. | ||
| data.recently_reviewed_companies[].trust_score | number | No | 4.8 | Trustpilot TrustScore of the business, as a decimal number. | ||
| data.recently_reviewed_companies[].trustpilot_url | string | No | https://www.trustpilot.com/review/www.houzeo.com | URL of the business profile on Trustpilot. | ||
| data.recently_reviewed_companies[].website_url | string | No | https://www.houzeo.com | Website address of the business. | ||
| data.related_categories | array | No | Categories related to this one. | |||
| data.related_categories[].name | string | No | Software Company | Display name of the category. | ||
| data.related_categories[].slug | string | No | software_company | Category slug. Use it with the category endpoint. | ||
| data.related_categories[].url | string | No | https://www.trustpilot.com/categories/software_company | URL of the category page on Trustpilot. | ||
| data.slug | string | No | software_company | Category slug, such as `software_company`. | ||
| data.sort | string | No | recommended | Sort order of the listing, as Trustpilot reports it, such as `recommended`. | ||
| data.trustpilot_url | string | No | https://www.trustpilot.com/categories/software_company | URL of the category page on Trustpilot. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Missing or invalid path/query parameters | #/definitions/app.Response |
| 404 | Category not 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/category/software_company?page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"