# Trustpilot Category Companies Listing

> Trustpilot Category Companies Listing is a paid API for AI agents from x402.apidirect.io, paid per call via x402, $0.006/call, status unknown (last checked 2026-10-30).

List companies within a Trustpilot category, ranked and paginated (20 per page), with category size and subcategory info.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/trustpilot/category/companies?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/trustpilot-category-companies-listing-a99a75dc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yY6QBFkqYSQDf3MrBQxWl

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability trustpilot-category-companies-listing-a99a75dc
```

Example prompt: Show me the top-rated banks on Trustpilot — use category 'bank', filter to companies with at least a 4.5 TrustScore, and show me the first page of results.

## When to prefer this

Use this endpoint when you need to discover or compare companies within a specific Trustpilot category, especially for market research, competitive analysis, or vetting vendors by reputation. Prefer this over general web search when you need structured, sortable, filterable Trustpilot data including TrustScores, rankings, and category metadata in a machine-readable format.

## Known failure modes

- Invalid or unknown category_id returns an error or empty result
- Page number out of range (above 500) returns a validation error
- Invalid country code returns a bad request error
- Unsupported min_rating value returns a validation error
- Network or upstream Trustpilot service unavailability returns a 5xx error
- Payment not completed results in a 402 Payment Required response

## How this service works

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

## Output

Returns a paginated list of up to 20 companies in the specified Trustpilot category, including company names, TrustScores, ratings, and ranking positions, along with the total category size and any available subcategories.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "category_id"
     ],
     "properties": {
      "page": {
       "type": "integer",
       "default": 1,
       "maximum": 500,
       "minimum": 1,
       "description": "Page number, 1-500 (default: 1). Each page returns up to 20 companies"
      },
      "claimed": {
       "type": "boolean",
       "default": false,
       "description": "Set to true to return only companies that have claimed their Trustpilot profile"
      },
      "country": {
       "type": "string",
       "description": "2-letter ISO 3166-1 country code (e.g. us, gb, de). Default: all countries"
      },
      "sort_by": {
       "enum": [
        "recommended",
        "recently_reviewed"
       ],
       "type": "string",
       "default": "recommended",
       "description": "recommended (default), recently_reviewed"
      },
      "min_rating": {
       "enum": [
        "3",
        "3.5",
        "4",
        "4.5"
       ],
       "type": "string",
       "description": "Only companies with at least this TrustScore: 3, 3.5, 4, 4.5"
      },
      "category_id": {
       "type": "string",
       "description": "Category slug, e.g. bank or electronics_technology. See Category IDs (https://apidirect.io/docs/trustpilot-category-ids). A trustpilot.com/categories/... URL also works"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/trustpilot-category-companies-listing-a99a75dc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.apidirect.io](https://www.zero.xyz/host/x402.apidirect.io/llms.txt)
