# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-trustpilot-com-api-430e0263/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-trustpilot-com-api-430e0263/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-trustpilot-com-api-430e0263/get_companies_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-trustpilot-com-api-430e0263/get_company_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-trustpilot-com-api-430e0263/get_company_responses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-trustpilot-com-api-430e0263/get_company_review_summary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-trustpilot-com-api-430e0263/get_company_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-trustpilot-com-api-430e0263/get_user_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-trustpilot-com-api-430e0263/search_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```