Argos
Argos Category API
One Argos category's products by category id (from categories, the category facet or an argos.co.uk browse link), 24 per page, with the same fields as search: price, was price, Scavio's computed save, Argos's offer text and badges, rating, seller and delivery; optional text inside the category, the same filters and four sorts. Costs 2 credits.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsoncategory_idstringrequiredCategory id: categories[].category_id (any level), the category facet's values, or the c:<id> of an argos.co.uk browse link (29560 Kettles, 29575 Air fryers).
Example: 29560
querystringOptional text inside the category, 1-200 characters.
Example: quiet boil
offersstring | string[]Up to 3 offer filters (OR): clearance, special_offer (Argos offers: Half Price, Save £X, multi-buys), black_friday (Argos's Black Friday deals).
Example: ["black_friday"]
brandstring | string[]Brands, up to 10 (OR), as the brands facet's values[].value (lower case, e.g. russell hobbs, ninja). There is no brand directory: brand is a filter.
Example: ["ninja"]
sellerenum<string>argos (sold by Argos) or trusted_seller (Argos's marketplace of third-party sellers).
Example: argos
new_inbooleanOnly products Argos marks New In.
Example: true
colourstring | string[]Colour groups, up to 10 (the colour group facet: blacks, whites, greys ...).
Example: ["blacks"]
price_minnumberLowest price, GBP. Any amount: the range is sent as is, not snapped to Argos's price bands.
Example: 20
price_maxnumberHighest price, GBP.
Example: 100
rating_minintegerCustomer rating: 5 (five stars only) or 1-4 (that many stars or more).
Example: 4
filtersobjectAny facet by facets[].name, each a value or a list of values (facets[].values[].value). Values of one facet are OR, facets are AND. Up to 10 facets. Lists offer per-category facets such as type, age range, character or kettle capacity (l).
Example: {"capacity range (litres)": "6.1 to 8 litres"}
sortenum<string>default:relevanceResult order.
Example: price_low
relevance— Argos's Most Popular order (default).price_low— Price low to high.price_high— Price high to low.rating— Customer rating.
pageintegerdefault:1Page, 24 products each, 1 to 200 (total_pages says how deep the list goes).
Example: 2
Notes
Store. One store: argos.co.uk, the UK store, prices in GBP. There is no country input: Argos trades in the UK only (its Republic of Ireland stores and website closed on 24 June 2023). Each call costs 2 credits.
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=210)
# Every kettle on Black Friday offer, 24 a page: 2 credits per page.
page, items = 1, []
while True:
data = client.argos.category(category_id="29560", offers=["black_friday"], page=page)["data"]
items += data["items"]
if not data["has_more"]:
break
page += 1
for i in items:
print(i["product_id"], i["name"], i["price"], i["was_price"], i["offer_text"])Response