Argos
Argos Store Stock API
Store stock for up to 10 Argos products at the Argos stores near a UK postcode: for each store (nearest first, up to 10 within 50 miles), whether each product can be collected now, today, tomorrow or later, or is out of stock, with the collection time and Argos's own message, plus the store's type, distance, address and hours, and whether each product can be delivered to a postcode (same day, next day or within N days). States and times, not unit counts. 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/jsonproduct_idsstring | string[]required1 to 10 Argos catalogue numbers (7 digits), as a list or comma-separated. Trusted Seller items are never stocked in Argos stores, so their ids answer 400.
Example: ["8377058", "7163184"]
postcodestringrequiredA full UK postcode (any spacing or case): the stores near it are checked.
Example: SW1A 1AA
delivery_postcodestringA full UK postcode to check home delivery to. Defaults to postcode.
Example: M1 1AE
max_distanceintegerdefault:50Search radius in miles, 1 to 50 (50 is what Argos's product page uses).
Example: 10
max_resultsintegerdefault:10Stores to return, 1 to 10 (10 is the most Argos returns).
Example: 5
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). Stock answers for UK postcodes only: a malformed postcode answers 400 before anything is charged. A well-formed postcode that does not exist (such as ZZ99 9ZZ) gets no answer from Argos and ends in an unbilled 502 after about 50 seconds. Each call costs 2 credits.
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=210)
# Which Argos stores near a postcode can hand over a kettle and an air fryer: 2 credits.
data = client.argos.store_stock(product_ids=["8377058", "7163184"], postcode="SW1A 1AA")["data"]
for s in data["stores"]:
states = {p["product_id"]: p["state"] for p in s["products"]}
print(s["distance_miles"], s["name"], s["type"], states)
for p in data["delivery"]["products"]:
print("delivery", p["product_id"], p["state"], p["message"])Response