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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-currys-co-uk-api-7169cc32/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-currys-co-uk-api-7169cc32/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-currys-co-uk-api-7169cc32/list_mini_pc_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-currys-co-uk-api-7169cc32/list_mobile_phones \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-currys-co-uk-api-7169cc32/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>","start":"<integer>"}'
```