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

> Search and browse products from Currys.co.uk to find detailed specifications, current pricing, and real-time stock availability. Retrieve comprehensive product information across electronics categories to compare items and make informed purchasing decisions.

**Category:** E-commerce | **Website:** [currys.co.uk/](https://currys.co.uk/) | **Docs:** [parse.bot/marketplace/7169cc32-8f45-45ca-b8fd-1c8c7471c690/currys-co-uk-api](https://parse.bot/marketplace/7169cc32-8f45-45ca-b8fd-1c8c7471c690/currys-co-uk-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/currys/`
**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 specific product including full technical specifications, pricing, availability, and promotions. Searches for the product by ID via the search grid, then fetches the product detail page for specifications. If a URL is provided, skips the URL-construction step.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | The unique numeric product ID (e.g., '10290129'). |
| `url` | string | No | The full product page URL. If provided, fetches specifications directly from this URL instead of constructing it from search results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/currys/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>","url":"<string>"}'
```

### List mini pc products

Search for products on Currys.co.uk using the full search page with multi-page pagination. Returns product URLs, names, prices, savings, key specifications, and image URLs. Fetches 20 products per page. Use max_pages to limit the number of pages fetched (0 means fetch all).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `max_pages` | integer | No | Maximum number of pages to fetch (20 products per page). 0 means fetch all pages. |
| `query` | string | No | Search query term. General terms like 'laptop', 'headphones', or 'mini pc' work reliably. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/currys/list-mini-pc-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"max_pages":"<integer>","query":"<string>"}'
```

### List mobile phones

List products in the mobile phones category on Currys.co.uk. Returns paginated results with full product data including pricing, availability, payment options, and offers. Each product includes structured data from Currys' internal data layer. Paginate using the start offset; each page returns up to limit products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of products to return per page. |
| `start` | integer | No | The starting index (offset) for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/currys/list-mobile-phones \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","start":"<integer>"}'
```

### Search products

Search for products by keyword on Currys.co.uk. Returns paginated results across all product categories with full product data including pricing, availability, payment options, and offers. Paginate using the start offset; each page returns up to limit products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of products to return per page. |
| `query` | string | Yes | The search query keyword (e.g., 'samsung', 'iphone', 'laptop'). |
| `start` | integer | No | The starting index (offset) for pagination. |

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

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