Argos API & Scraper
The Argos API turns argos.co.uk into clean JSON in six actions: search, product/detail, product/reviews, product/questions, category and deals.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
search takes a keyword, sorts by price or rating and filters by brand, category, special offers, new in or minimum rating, 1 to 60 products a page; when a misspelling returns nothing it re-runs Argos's own spelling correction (iphnoe becomes iphone) and reports it. Each row carries the catalogue number, title, brand, URL, price in GBP, the was-price, saving and offer text of a price drop, the clearance flag, delivery and click & collect flags, the delivery cost, the seller type (Argos, Tu or marketplace) and the variant options, plus the search index's rating and review count. product/detail adds everything on the product page: the multi-buy offers the product belongs to (for example 2 for £15), kept apart from the price, the Nectar points it earns, the page's own rating and review count, the EAN where Argos publishes one, images and videos, description, feature list and specifications, breadcrumb, size and colour variants with their own prices, badges and care plans. product/reviews returns the reviews with the 1-5 distribution, the recommend percentage and per-aspect averages; product/questions returns customer questions with staff and brand answers; category and deals browse a category or the current special offers. In a live check on 2026-09-15, 45 of 45 searches and 26 of 26 product reads answered, 29 real and misspelled keywords all kept their results, 8 made-up keywords all came back empty, and 6 of 6 products' ratings and review counts matched between two independent Argos back-ends. United Kingdom only, prices in GBP, no Argos account, one ReefAPI key and the standard { ok, data, meta, error } envelope.
The price, the price drop, the multi-buy and the Nectar points are four different things
Argos shows several numbers near a price. The API keeps each one in its own field, so nothing is subtracted or added for you: the price you pay for one item, the was-price of a price drop, any multi-buy offer the product is part of, and the Nectar points it earns.
| Product | price (GBP) | was_price / offer_text | multibuy_offers | nectar_points |
|---|---|---|---|---|
| Chad Valley Character Stacking Rings (7873553) | 4.00 | 8.00 / Half Price | 2 for £15 on Selected Toys and Games (and a second 2 for £15) | 20 (5x Nectar badge) |
| Kenwood Dawn 4 Slice Toaster (1346275) | 35.00 | 50.00 / Save £15.00 | none on the row | on product/detail |
| Cookworks Kettle - Black (3102039) | 9.00 | null / null | [] (none) | 9 |
Values from 2026-09-15. multibuy_offers is only on product/detail: Argos's search rows do not reliably say whether a product is in a multi-buy. Nectar points are a reward, never a discount.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/argos/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "kettle"
}
}{
"ok": true,
"meta": {
"api": "argos",
"endpoint": "search",
"mode": "live",
"latency_ms": 2344.6,
"record_count": 24,
"bytes": 34450,
"cache_hit": false,
"pagination": {
"page": 1,
"page_size": 24,
"has_more": true,
"total": 306
}
},
"data": {
"results": [
{
"product_id": "3102039",
"title": "Cookworks Kettle - Black",
"brand": "Cookworks",
"url": "https://www.argos.co.uk/product/3102039/",
"image": null,
"price": 9,
"currency": "GBP",
"price_is_from": false,
"was_price": null,
"savings": null,
"discount_percent": null,
"offer_text": null,
"clearance": false,
"search_index_rating": 4.41,
"rating_scale": 5,
"search_index_review_count": 1673,
"has_variations": false,
"variant_options": null,
"deliverable": true,
"click_and_collect": true,
"free_delivery": false,
"delivery_cost": 4.95,
"seller_type": "argos",
"fulfilment_agent": "ADSI",
"badges": null
},
{
"product_id": "2137074",
"title": "Russell Hobbs 20460 Buckingham Quiet Boil Kettle - S/Steel",
"brand": "Russell Hobbs",
"url": "https://www.argos.co.uk/product/2137074/",
"image": null,
"price": 34.99,
"currency": "GBP",
"price_is_from": false,
"was_price": null,
"savings": null,
"discount_percent": null,
"offer_text": null,
"clearance": false,
"search_index_rating": 4.61,
"rating_scale": 5,
"search_index_review_count": 6603,
"has_variations": false,
"variant_options": null,
"deliverable": true,
"click_and_collect": true,
"free_delivery": false,
"delivery_cost": 4.95,
"seller_type": "argos",
"fulfilment_agent": "ADSI",
"badges": [
"VALUE_20_pc_rhobbs20",
"INFO_2yr_warranty"
]
},
{
"product_id": "9363195",
"title": "Morphy Richards 102786 Equip Jug Kettle - Brushed",
"brand": "Morphy Richards",
"url": "https://www.argos.co.uk/product/9363195/",
"image": null,
"price": 23.99,
"currency": "GBP",
"price_is_from": false,
"was_price": 30,
"savings": 6.01,
"discount_percent": 20,
"offer_text": "Save 20%",
"clearance": false,
"search_index_rating": 4.44,
"rating_scale": 5,
"search_index_review_count": 2980,
"has_variations": false,
"variant_options": null,
"deliverable": true,
"click_and_collect": true,
"free_delivery": false,
"delivery_cost": 4.95,
"seller_type": "argos",
"fulfilment_agent": "ADSI",
"badges": [
"INFO_2yr_warranty"
]
}
],
"count": 24,
"total_results": 306,
"page": 1,
"page_size": 24,
"has_more": true,
"sort_applied": "relevance",
"filters_applied": [],
"filters_available": [
{
"facet": "category",
"label": "Category",
"values": [
{
"id": "[trimmed-depth]",
"label": "[trimmed-depth]",
"count": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"label": "[trimmed-depth]",
"count": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"label": "[trimmed-depth]",
"count": "[trimmed-depth]"
}
]
},
{
"facet": "sold by",
"label": "Sold By",
"values": [
{
"id": "[trimmed-depth]",
"label": "[trimmed-depth]",
"count": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"label": "[trimmed-depth]",
"count": "[trimmed-depth]"
}
]
},
{
"facet": "new",
"label": "New",
"values": [
{
"id": "[trimmed-depth]",
"label": "[trimmed-depth]",
"count": "[trimmed-depth]"
}
]
}
],
"sponsored_dropped": 0,
"query": "kettle",
"matched_query": null,
"category_applied": null
}
}What the Argos API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search argos.co.uk by keyword. Each product carries the price, the was-price and saving of a price drop, the offer text, clearance flag, the search index's rating and review count, delivery and click & collect flags, delivery cost, seller type and variant options. Sort by price or rating; filter by brand, category, offers, new in or minimum rating. A misspelling with no matches is re-run against Argos's own spelling correction (reported in matched_query). | Pricing teams call search to search argos.co.uk by keyword. | query, page, page_size, sort, brands, ... |
| product/detail | One Argos product in full: price, was-price and saving, the offer text, every multi-buy offer it is part of (never subtracted from the price), Nectar points, rating and review count, availability, delivery and click & collect flags, delivery cost, EAN when published, images, videos, description, feature list and specifications, breadcrumb, size/colour variants with their own prices, badges and warranties. | Marketplace operators call product/detail to get one Argos product in full. | product_id |
| product/reviews | Customer reviews of one Argos product, paged, sortable and filterable by star rating, with the average, the 1-5 distribution, the recommend percentage and per-aspect averages. | Catalog enrichment teams call product/reviews to get customer reviews of one Argos product, paged, sortable and filterable by star rating, with th…. | product_id, page, page_size, sort, rating |
| product/questions | Customer questions about one Argos product with their answers (staff, brand and best-answer flags). | Retail analysts call product/questions to get customer questions about one Argos product with their answers (staff, brand and best-answer f…. | product_id, page, page_size, sort |
| category | Every product in one Argos category, paged, with the same rows, sorting and filters as search. | Pricing teams call category to get every product in one Argos category, paged, with the same rows, sorting and filters as search.. | category_id, page, page_size, sort, brands, ... |
| deals | Products currently on a special offer at Argos (price drops and multi-buys), optionally narrowed by keyword, category or brand, with the same rows and sorting as search. | Marketplace operators call deals to get products currently on a special offer at Argos (price drops and multi-buys), optionally narro…. | query, category_id, brands, page, page_size, ... |
Call search from your stack
curl -X POST https://api.reefapi.com/argos/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"kettle"}'import requests
r = requests.post(
"https://api.reefapi.com/argos/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "kettle"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/argos/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "kettle"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.argos.search with {"query":"kettle"}.Who uses this API and why
- UK price-monitoring teams track Argos prices, price drops and was-prices daily, and read multi-buy offers separately so a 3 for 2 never looks like a price cut.
- Retail analysts watch which products sit in Argos special offers and clearance, by category and brand.
- Brands follow their Argos ratings, review volume, per-aspect scores and customer questions, including staff answers.
- Catalog teams pull the EAN, grouped specs, variants and images for products they match by GTIN.
Questions developers ask before integrating
What happens if I misspell the keyword?
The search follows Argos's own spelling correction: when a misspelling returns nothing, it re-runs the corrected term (iphnoe becomes iphone, trampolene becomes trampoline, nintedo becomes nintendo) and reports the correction in matched_query. On 2026-09-15, 29 real and misspelled keywords all kept their results. Pass category_id to search inside a particular category.
What happens with a keyword Argos does not know?
It comes back empty, total 0 — not a page of unrelated guesses. On 2026-09-15, 8 of 8 made-up keywords (zzqqxxnonexist, asdfghjkl, and so on) came back empty, while every real keyword and typo Argos recognises kept its results.
Is a multi-buy offer like 3 for 2 included in the price?
No. price is what one item costs. A price drop comes with was_price, savings, discount_percent and the offer text (Half Price, Save £15.00). A multi-buy offer is listed separately in multibuy_offers on product/detail, with its title, type, minimum quantity and dates, and is never subtracted from the price, because it only applies when you buy the set.
Why do the rating and review count differ between search and the product?
They come from two places. Search rows carry search_index_rating and search_index_review_count from Argos's search index, which can lag a few reviews behind (75 against 76 on one product on 2026-09-15). product/detail and product/reviews carry the product's own figures, which agreed exactly across two independent Argos back-ends on 6 of 6 products checked. Prices, titles and brands matched between search and detail on all 15 products compared.
Which products does it cover?
Everything argos.co.uk sells online: Argos's own catalogue (7-digit catalogue numbers like 3102039), Tu clothing (ids like tuc148096053, with size and colour variants) and marketplace items sold by other retailers through Argos (seller_type marketplace). A product id can also be passed as an argos.co.uk/product/ URL. A search result that Argos no longer sells can return NOT_FOUND on product/detail.
Which country does this cover?
The United Kingdom only (argos.co.uk). Prices are GBP, as shown on the site.
What is the Argos API?
Argos API is a ReefAPI endpoint group for uk's argos as json: prices, price drops, multi-buy offers, nectar points, specs, reviews and q&a. It returns live JSON through POST requests under /argos/v1.
Is the Argos API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Argos calls use the same shared credit balance as every other ReefAPI engine.
Do I need an Argos login or account?
No login to Argos is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Argos data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Argos API use?
Argos actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Argos from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call argos actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Argos API an Argos scraper?
It is the managed alternative to a DIY Argos scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same uk's argos as json: prices, price drops, multi-buy offers, nectar points, specs, reviews and q&a back as clean JSON.
Why does my Argos scraper keep getting blocked?
Most Argos scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.