Argos
Argos Deals API
Argos's deal collections: the Black Friday deals, clearance and special offers as full lists (24 per page, with query, category, the search filters and four sorts), or Argos's own Top 100 deals list (2 pages of 60). Each product with price, was price, Scavio's computed save, Argos's offer text and badges (Black Friday, Price Guarantee ...), rating, seller and delivery. 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/jsoncollectionenum<string>requiredThe deal collection.
Example: black_friday
black_friday— Argos's Black Friday deals, as a full list with filters and sorts.clearance— Clearance, as a full list.special_offers— Argos offers (Half Price, Save £X, multi-buys), as a full list.top_100— Argos's own Top 100 deals list: 2 pages of 60, page only (no query, filters or sort).
querystringOptional text within the collection (not with top_100).
Example: lego
categorystringCategory id to narrow to (not with top_100).
Example: 29560
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), or 1 to 2 (60 each) for top_100.
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)
# Black Friday deals under 50 GBP with Argos's Price Guarantee badge, lowest price first.
data = client.argos.deals(collection="black_friday", price_max=50, sort="price_low")["data"]
print(data["total"], "deals")
for i in data["items"]:
if "price_guarantee" in i["badges"]:
print(i["product_id"], i["name"], i["price"], i["was_price"], i["offer_text"])Response