# Very — 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.

> Monitor and browse product information from Very.co.uk with full search capabilities including pagination and sorting options. Access detailed product pages to view comprehensive specifications and pricing for items available on the platform.

**Category:** E-commerce | **Website:** [www.very.co.uk/](https://www.very.co.uk/) | **Docs:** [parse.bot/marketplace/05ef57e9-2148-4fc9-a845-22ab1a5a1e26/very-co-uk-api](https://parse.bot/marketplace/05ef57e9-2148-4fc9-a845-22ab1a5a1e26/very-co-uk-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-very-co-uk-api-05ef57e9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_details

Get detailed information for a single Very.co.uk product by its numeric product ID (from search_products results). Returns brand, full description, pricing, stock status, rating, review count, and delivery availability. Makes two requests internally: a warmup search page to establish session trust with the site's protection, then the product detail page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Numeric product ID from search_products results (e.g. '1600861627'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-very-co-uk-api-05ef57e9/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### search_products

Search Very.co.uk products by keyword. Returns paginated results with up to 30 products per page (site constraint). Supports sorting by price, rating, newest, discount, and bestseller. Pagination uses the page parameter; each page returns a fixed maximum of 30 items regardless of page_size (page_size limits the number returned when lower than 30).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `page_size` | integer | No | Maximum number of products to return. The site serves at most 30 products per page; values above 30 still return 30. |
| `query` | string | Yes | Search query text (e.g. 'headphones', 'laptop', 'dress'). |
| `sort` | string | No | Sort order for results. When omitted or set to 'relevance', results are in the site's default relevance order. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-very-co-uk-api-05ef57e9/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","query":"<string>","sort":"<string>"}'
```