# Uk 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 Trustpilot reviews, company ratings, and performance insights by searching companies, filtering reviews by date range, and discovering top mentions and similar businesses. Browse categories, find the best-reviewed companies, and stay updated with Trustpilot's latest blog content.

**Category:** Reviews & Ratings | **Website:** [uk.trustpilot.com/](https://uk.trustpilot.com/) | **Docs:** [parse.bot/marketplace/1ed26b92-3824-472c-8ea6-e9486fdde0e4/uk-trustpilot-com-api](https://parse.bot/marketplace/1ed26b92-3824-472c-8ea6-e9486fdde0e4/uk-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-uk-trustpilot-com-api-1ed26b92/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_blog_posts

Get recent blog posts from the Trustpilot blog, organized by pillar categories.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uk-trustpilot-com-api-1ed26b92/get_blog_posts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_categories

Get the hierarchical category structure of Trustpilot including all top-level categories and their subcategories.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uk-trustpilot-com-api-1ed26b92/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_category_companies

Get companies listed under a specific category. Returns paginated list of businesses in the category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Category ID slug (e.g. 'bank', 'department_store') |
| `page` | integer | No | Page number |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uk-trustpilot-com-api-1ed26b92/get_category_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","page":"<integer>"}'
```

### get_company_overview

Get the summary/overview for a company by its domain. Includes trust score, star rating, total review count, AI-generated summary, and similar companies.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `domain` | string | Yes | Company domain (e.g. 'www.johnlewis.com') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uk-trustpilot-com-api-1ed26b92/get_company_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"<string>"}'
```

### get_company_reviews

Get paginated reviews for a company with optional filtering by star rating, date, and language. Returns reviews sorted by recency or relevance.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date filter: last30days, last3months, last6months, last12months |
| `domain` | string | Yes | Company domain (e.g. 'www.johnlewis.com') |
| `language` | string | No | ISO language code (e.g. 'en') |
| `page` | integer | No | Page number |
| `sort` | string | No | Sort order: recency, relevance |
| `stars` | string | No | Filter by star rating (1, 2, 3, 4, 5) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uk-trustpilot-com-api-1ed26b92/get_company_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","domain":"<string>","language":"<string>","page":"<integer>","sort":"<string>","stars":"<string>"}'
```

### get_company_top_mentions

Get top mention tags/topics extracted from reviews for a company. Either domain or business_unit_id must be provided.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `business_unit_id` | string | No | Business Unit ID hash (e.g. '46d5517e000064000500ceba'). Available from search_companies results. |
| `domain` | string | No | Company domain (e.g. 'www.johnlewis.com'). Will be resolved to business unit ID. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uk-trustpilot-com-api-1ed26b92/get_company_top_mentions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"business_unit_id":"<string>","domain":"<string>"}'
```

### get_reviews_for_month

Retrieve all reviews posted in a specific month and year by paginating through reviews sorted by recency.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `domain` | string | Yes | Company domain (e.g. 'www.johnlewis.com') |
| `max_pages` | integer | No | Max pages to scan |
| `month` | integer | No | Target month (1-12). Defaults to current month. |
| `year` | integer | No | Target year. Defaults to current year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uk-trustpilot-com-api-1ed26b92/get_reviews_for_month \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"<string>","max_pages":"<integer>","month":"<integer>","year":"<integer>"}'
```

### get_similar_companies

Get similar companies that users also viewed for a given company domain.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `domain` | string | Yes | Company domain (e.g. 'www.johnlewis.com') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uk-trustpilot-com-api-1ed26b92/get_similar_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"<string>"}'
```

### search_companies

Search for companies by name or keyword. Returns list of matching companies with basic info, trust score, and review count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results per page |
| `page` | integer | No | Page number |
| `query` | string | Yes | Search keyword (e.g. 'John Lewis') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uk-trustpilot-com-api-1ed26b92/search_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```