Argos APIargos.co.uk ↗
Search Argos UK products, browse categories, and retrieve full product details including price, ratings, promotions, and delivery options via 4 endpoints.
What is the Argos API?
The Argos UK API provides 4 endpoints to search, browse, and retrieve product data from argos.co.uk. Use search_products to query the catalogue by keyword and get paginated results, browse_category to navigate by category slug and ID, get_product_details to fetch price, EAN, ratings, and delivery flags for a specific product, and get_categories to pull the full navigation structure.
curl -X GET 'https://api.parse.bot/scraper/01541198-68b1-4b54-9e28-1fe4fec44226/search_products?page=1&sort=Relevance&query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword with optional pagination and sorting. Returns up to 60 products per page from the Argos catalogue. Results include product IDs and titles. When Akamai protection blocks the request, proxy rotation resolves it.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sort order for results. |
| queryrequired | string | Search keyword (e.g. 'laptop', 'gaming chair') |
{
"type": "object",
"fields": {
"version": "string, data format version",
"products": "array of product objects with id and title",
"totalPages": "integer, total number of pages available",
"currentPage": "integer, current page number",
"totalNumberOfAllProducts": "integer, total matching products count"
},
"sample": {
"data": {
"version": "1.0",
"products": [
{
"id": "8398037",
"title": "HP 14-ep2001na 14in Intel N1504GB 128GB Laptop"
},
{
"id": "7825697",
"title": "Samsung Galaxy 14in 4GB 64GB Chromebook Go - Silver"
}
],
"totalPages": 7,
"currentPage": 1,
"rank1CountForCurrentPage": 60,
"totalNumberOfAllProducts": 368
},
"status": "success"
}
}About the Argos API
Search and Browse
The search_products endpoint accepts a query string (e.g. 'gaming chair') with optional page and sort parameters. Each call returns up to 60 products per page, along with totalPages, currentPage, and totalNumberOfAllProducts so you can paginate through a full result set. Product objects at this level include id and title.
The browse_category endpoint takes a category_slug (e.g. 'technology/laptops-and-pcs/laptops') and a category_id. For leaf-level category pages it returns an array of product objects with id, name, price, brand, avg_rating, and reviews_count, plus filters, breadcrumbs, and categoryName. Hub-level category IDs return subcategory listings instead of products. Use get_categories first to discover valid slug and ID pairs from the Argos navigation structure.
Product Details
get_product_details accepts a single product_id and returns the richest data available: ean barcode, current price in GBP, savings (the discount amount when a promotion is active, null otherwise), avg_rating out of 5, HTML description, and boolean flags collectable and deliverable indicating click-and-collect and home delivery availability respectively.
Category Navigation
get_categories requires no inputs and returns the full top-level category structure from the Argos homepage as an array of objects with name and url fields. These URLs map directly to the category_slug and category_id values accepted by browse_category, making it the natural starting point for any catalogue traversal workflow.
The Argos API is a managed, monitored endpoint for argos.co.uk — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when argos.co.uk changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official argos.co.uk API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track price drops and active promotions on specific Argos products using the
savingsfield fromget_product_details. - Build a price comparison tool by querying competing product IDs and comparing
priceandavg_ratingfields. - Index the Argos catalogue by crawling
get_categoriesthen paginating throughbrowse_categoryfor each leaf category. - Check click-and-collect versus home delivery availability using the
collectableanddeliverableboolean flags. - Aggregate customer rating data across a product range using
avg_ratingandreviews_countreturned bybrowse_category. - Enrich a product database with EAN barcodes by calling
get_product_detailswith known Argos product IDs. - Implement keyword-based product search with sorted, paginated results using
search_productswith thesortandpageparameters.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Argos have an official public developer API?+
What does `get_product_details` return beyond basic pricing?+
collectable) and home delivery (deliverable), and a savings field that holds the GBP discount amount when the product is on promotion, or null when it is not.Does `browse_category` always return individual products?+
price, brand, avg_rating, and reviews_count. Use get_categories to identify valid category slug and ID combinations before calling browse_category.Does the API expose real-time stock levels or store-specific availability by postcode?+
collectable and deliverable boolean flags at the product level but does not expose store-level stock counts or postcode-based availability checks. You can fork this API on Parse and revise it to add an endpoint covering location-specific stock data.Are product images included in any endpoint response?+
search_products, browse_category, and get_product_details endpoints do not return image URLs in their documented response fields. You can fork this API on Parse and revise it to add image URL extraction for products.