# Trustpilot — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access company reviews, ratings, and user profiles from Trustpilot to research businesses, compare ratings across categories, and analyze customer feedback and company responses. Find detailed company overviews and review summaries to make informed decisions about products and services.

**Category:** Reviews & Ratings | **Website:** [trustpilot.com/](https://trustpilot.com/) | **Docs:** [parse.bot/marketplace/430e0263-d131-4f29-9cd1-146a20b35e69/trustpilot-com-api](https://parse.bot/marketplace/430e0263-d131-4f29-9cd1-146a20b35e69/trustpilot-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/trustpilot/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get categories

Retrieve all top-level categories and their sub-categories available on Trustpilot.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/trustpilot/get-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get companies by category

List companies within a specific category with pagination. Returns companies sorted by trust score.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number |
| `slug` | string | Yes | Category slug from get_categories (e.g. 'bank', 'animals_pets', 'insurance_agency') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/trustpilot/get-companies-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","slug":"<string>"}'
```

### Get company overview

Get full company profile overview including TrustScore, rating distribution, AI summary, and initial reviews.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `domain` | string | Yes | Company domain/identifying name as used on Trustpilot (e.g. 'www.amazon.com') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/trustpilot/get-company-overview \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"domain":"<string>"}'
```

### Get company responses

Retrieve reviews that have company replies/responses. Paginates through reviews to find those with company responses.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `domain` | string | Yes | Company domain/identifying name as used on Trustpilot |
| `limit` | integer | No | Maximum number of responses to return |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/trustpilot/get-company-responses \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"domain":"<string>","limit":"<integer>"}'
```

### Get company review summary

Get AI summary, review topics, and rating breakdown for a company.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `domain` | string | Yes | Company domain/identifying name as used on Trustpilot |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/trustpilot/get-company-review-summary \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"domain":"<string>"}'
```

### Get company reviews

Fetch paginated reviews for a company with optional star filtering, sort order, and keyword search.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `domain` | string | Yes | Company domain/identifying name as used on Trustpilot |
| `keyword` | string | No | Search keyword within reviews |
| `page` | integer | No | Page number |
| `sort` | string | No | Sort order for reviews |
| `stars` | string | No | Filter by star rating (1-5) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/trustpilot/get-company-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"domain":"<string>","keyword":"<string>","page":"<integer>","sort":"<string>","stars":"<string>"}'
```

### Get user profile

Get public user profile and their reviews across different companies. User IDs can be obtained from reviewer.id in review results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `user_id` | string | Yes | Trustpilot user ID (alphanumeric string from reviewer.id in review results) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/trustpilot/get-user-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"user_id":"<string>"}'
```

### Search companies

Search for companies by name or keyword. Returns basic company info including domain, trust score, star rating, and review count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Results per page (max 20) |
| `page` | integer | No | Page number |
| `query` | string | Yes | Search keyword or company name |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/trustpilot/search-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.