# Argos Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/argos/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/argos-search |

## Description

Search the Argos UK product catalogue by keyword and get real-time prices, was-prices, availability, ratings, promotions, and images from argos.co.uk as structured JSON.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/argos/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search for air fryer

```json
{
  "meta": {
    "query": "air fryer",
    "total_pages": 11,
    "current_page": 1,
    "has_next_page": true,
    "total_results": 312
  },
  "products": [
    {
      "id": "9471832",
      "sku": "9471832",
      "url": "https://www.argos.co.uk/product/9471832",
      "brand": "Ninja",
      "price": 179.99,
      "title": "Ninja Foodi AF300UK 7.6L Dual Zone Air Fryer",
      "rating": 4.7,
      "category": "Air Fryers",
      "currency": "GBP",
      "was_price": 249.99,
      "availability": "in_stock",
      "discount_pct": 28,
      "review_count": 3842,
      "thumbnail_url": "https://media.very.co.uk/i/very/9471832_sq.jpg",
      "is_on_promotion": true,
      "promotion_label": "Save £70",
      "delivery_available": true,
      "click_collect_available": true
    },
    {
      "id": "8472910",
      "sku": "8472910",
      "url": "https://www.argos.co.uk/product/8472910",
      "brand": "Philips",
      "price": 99.99,
      "title": "Philips Essential XL HD9270/90 6.2L Air Fryer",
      "rating": 4.5,
      "category": "Air Fryers",
      "currency": "GBP",
      "was_price": null,
      "availability": "in_stock",
      "discount_pct": null,
      "review_count": 1271,
      "thumbnail_url": "https://media.very.co.uk/i/very/8472910_sq.jpg",
      "is_on_promotion": false,
      "promotion_label": null,
      "delivery_available": true,
      "click_collect_available": true
    },
    {
      "id": "7983401",
      "sku": "7983401",
      "url": "https://www.argos.co.uk/product/7983401",
      "brand": "Tower",
      "price": 39.99,
      "title": "Tower Vortx T17082 4L Compact Air Fryer - Black",
      "rating": 4.3,
      "category": "Air Fryers",
      "currency": "GBP",
      "was_price": 59.99,
      "availability": "limited_stock",
      "discount_pct": 33,
      "review_count": 784,
      "thumbnail_url": "https://media.very.co.uk/i/very/7983401_sq.jpg",
      "is_on_promotion": true,
      "promotion_label": "Save £20",
      "delivery_available": true,
      "click_collect_available": false
    }
  ]
}
```

## Documentation

## Overview

Argos is the UK's largest general merchandise retailer with over 60,000 products. The site runs Cloudflare bot protection. Piloterr handles the bypass and returns a structured product list with live prices, was-prices, availability, ratings, and promotion labels for any keyword search.

## Quickstart

```
GET https://api.piloterr.com/v2/argos/search?query=air+fryer
```

## Main use cases

- Track current and was-prices across Argos product categories daily to power a UK retail price intelligence dashboard
- Monitor availability changes to trigger restock alerts for consumers or purchasing teams
- Collect promotion labels and discount percentages to analyze UK retailer promotional cycle timing
- Benchmark Argos customer ratings against competing UK retailers for the same product categories in real time
- Build a deals feed surfacing the best Argos discounts by percentage across electronics or toys