# Very — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/very/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/very/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/very/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","query":"<string>","sort":"<string>"}'
```

## Next steps

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