Argos
Argos Search API
Search Argos (argos.co.uk, GBP): 24 products per page, each with price, was price, Scavio's computed save, Argos's offer text and badges (Black Friday, Price Guarantee ...), rating, review count, seller (Argos or a Trusted Seller), delivery cost and whether it can be reserved for store collection, plus the facets to filter on. Brand, category, seller, offers, colour, price, rating and any facet as filters; 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/jsonquerystringrequiredSearch text, 1-200 characters.
Example: air fryer
categorystringCategory id to search inside (categories[].category_id or the category facet's values, e.g. 29560 Kettles).
Example: 29575
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)
# Air fryers on offer, sold by Argos: price, was price and badges, 2 credits a page.
data = client.argos.search(query="air fryer", seller="argos", offers=["special_offer"])["data"]
print(data["total"], "products,", data["total_pages"], "pages")
for i in data["items"]:
print(i["product_id"], i["price"], i["was_price"], i["offer_text"], i["badges"], i["reservable"])Response