Action
Action Suggestions API
Action's (action.com) search suggestions for what a shopper has typed, on one market: the suggested search terms, a suggested category and up to 5 products with price and article number. 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/jsonquerystringrequiredWhat the shopper has typed so far, 1-100 characters, in the storefront's language (opberg = storage on nl-nl).
Example: opberg
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
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)
d = client.action.suggestions(query="opberg", country="nl")["data"]
print(d["suggestions"], d["category_suggestion"])
for p in d["products"]:
print(p["product_code"], p["title"], p["price"])Response