Action
Action Category API
One Action (action.com) category's products on one market, by its path or link: 24 a page with the article number, price, Action's struck-through price, unit price, weekly-deal validity, labels and rating, plus facets (price band, brand, new) to filter by and four sorts. Paths are in the storefront's language (wonen/woonaccessoires on nl-nl); categories lists them. Costs 1 credit.
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/jsoncategorystringrequiredA category path from categories (categories[].path, e.g. wonen or wonen/woonaccessoires on nl-nl: Wonen = home, woonaccessoires = home decoration) or its action.com/<market>/c/... link. Paths differ per storefront language.
Example: wonen/woonaccessoires
countrystringdefault:nlThe Action market, as a lowercase country code. This endpoint serves all 19 storefronts in 16 countries. Prices come back in the market's currency, never converted. Bulgaria and every other country answer 400, not charged.
Example: nl
nl— Netherlands, EUR, nl (Dutch) (nl-nl). The default.be— Belgium, EUR, nl (Dutch) or fr (French); default nl (nl-be, fr-be).fr— France, EUR, fr (French) (fr-fr).lu— Luxembourg, EUR, fr (French) (fr-lu).de— Germany, EUR, de (German) (de-de).at— Austria, EUR, de (German) (de-at).ch— Switzerland, CHF, de (German) or fr (French) or it (Italian); default de (de-ch, fr-ch, it-ch).it— Italy, EUR, it (Italian) (it-it).es— Spain, EUR, es (Spanish) (es-es).pt— Portugal, EUR, pt (Portuguese) (pt-pt).pl— Poland, PLN, pl (Polish) (pl-pl).cz— Czechia, CZK, cs (Czech) (cs-cz).sk— Slovakia, EUR, sk (Slovak) (sk-sk).ro— Romania, RON, ro (Romanian) (ro-ro).hr— Croatia, EUR, hr (Croatian) (hr-hr).si— Slovenia, EUR, sl (Slovenian) (sl-si).
languagestringThe storefront's language where a country has more than one: be nl (default) or fr; ch de (default), fr or it. Every other country has one language: leave language out (sending another answers 400, not charged). Titles, labels and facet values come back in it; prices are the same on every storefront of one country.
Example: fr
sortenum<string>default:relevanceResult order. Action offers no popularity sort.
Example: price_asc
relevance— Action's own order (default).price_asc— Price low to high.price_desc— Price high to low.newest— Newest first.
pageintegerdefault:1Page, 1 to 200, 24 products a page (23 on weekly deals); total_pages says how deep the list goes.
Example: 2
category_filterstringOne department: a value of facets[facet=category].values[].value, in the storefront's language (e.g. Hobby, Wonen, Eten & drinken).
Example: Wonen
price_rangestringA price band: a value of facets[facet=price_range].values[].value, e.g. <1, 1-2, 2-5, 5-10, 10-20, >20 (the bands follow the market's currency).
Example: 2-5
brand_filterstringOne brand: a value of facets[facet=brand].values[].value (e.g. Disney, Haribo, Max & More).
Example: Haribo
new_onlybooleanOnly products with Action's new label (Nieuw / Neu / Nouveau).
Example: true
Notes
Store. Action (action.com), the European non-food discount store, on 19 storefronts in 16 countries: country picks the market (default nl, the Netherlands) and language the storefront where a country has two or three (Belgium nl or fr, Switzerland de, fr or it). Titles, descriptions, labels, category names and facet values come back in that storefront's language, as Action writes them (Dutch by default); field names are English. Prices are numbers in the market's currency (EUR; CHF in Switzerland, PLN in Poland, CZK in Czechia, RON in Romania), never converted. An article number (product_code, 7 digits) is the same in every market; Action sets the price per market, inside the euro zone too. Every answer echoes country, language, market (the storefront, e.g. nl-nl) and currency. Not Action S.A. (action.pl), a Polish IT distributor. Cost: 1 credit.
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=210)
# Every deal in one category, page by page.
page, deals = 1, []
while True:
d = client.action.category(category="wonen/woonaccessoires", country="nl", page=page)["data"]
deals += [i for i in d["items"] if i["is_deal"]]
if not d["has_more"]:
break
page += 1
print(len(deals), "deals of", d["total"])Response