---
title: "Trustpilot Category Companies"
method: GET
path: "/v1/trustpilot/category/companies"
tags: ["Trustpilot"]
---

# Trustpilot Category Companies

`GET /v1/trustpilot/category/companies`

## Request

- Base URL: `https://apidirect.io`
- URL: `https://apidirect.io/v1/trustpilot/category/companies`
- Auth: API key in header `X-API-Key`

List the companies in a Trustpilot category, ranked, 20 per page, along with the category's size and subcategories.

**Price:** $0.005 per request. **Free tier:** 50 requests/month.

## Query parameters

- `category_id` string, required
- `page` integer
- `sort_by` 'recommended' | 'recently_reviewed'
- `country` string
- `min_rating` '3' | '3.5' | '4' | '4.5'
- `claimed` boolean

## Response `200`

Successful response

- TrustpilotCategoryCompaniesResponse: Inferred from a live response. Any field can be null or absent, and new fields may be added at any time.
  - `companies` object[], nullable
    - `business_unit_id` string, nullable
    - `name` string, nullable
    - `domain` string, nullable
    - `website` string, nullable
    - `url` string, nullable
    - `logo` string, nullable
    - `rating` number, nullable
    - `stars` number, nullable
    - `review_count` number, nullable
    - `categories` object[], nullable
      - `category_id` string, nullable
      - `name` string, nullable
      - `is_primary` boolean, nullable
    - `city` string, nullable
    - `country` string, nullable
    - `address` string, nullable
    - `zipcode` string, nullable
    - `is_recommended` boolean, nullable
  - `count` number, nullable
  - `page` number, nullable
  - `total_pages` number, nullable
  - `total_companies` number, nullable
  - `category` object, nullable
    - `category_id` string, nullable
    - `name` string, nullable
    - `business_count` number, nullable
    - `parent_id` unknown
    - `url` string, nullable
    - `subcategories` object[], nullable
      - `category_id` string, nullable
      - `name` string, nullable
      - `business_count` number, nullable

## Other responses

- `400`: Bad request: missing or invalid parameters
- `401`: Unauthorized: invalid or missing API key
- `402`: Free tier used up for this endpoint and no payment method on file (`payment_required`).
- `403`: Account blocked after a failed payment (`account_blocked`).
- `404`: Category not found
- `429`: Rate limit exceeded or too many concurrent requests
- `500`: Internal server error
- `502`: Temporary failure retrieving Trustpilot data. Please retry shortly.
- `503`: Service temporarily unavailable. Please retry shortly.
- `504`: The request timed out

---

[API](https://skmtc.dev/apidirect/apis/api-direct.md) · [All operations](https://skmtc.dev/apidirect/apis/api-direct/llms.txt) · [OpenAPI document](https://skmtc.dev/apidirect/apis/api-direct/revisions/fa8c68d70bd0?raw)