Action
Action Stores API
The 20 Action (action.com) stores nearest a city, town, postcode or point, as Action's store finder lists them, with address, coordinates and 7 dated days of opening hours. The list can cross a border: on 2026-11-22 Luxembourg returned stores in Luxembourg, Belgium, France and Germany, and a point in Basel stores in Switzerland, Germany and France. Action does not publish store stock, so there is none here. 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/jsonquerystringA city, town or postcode (Amsterdam, 5672 GM, Kraków). Send query or lat + lng.
Example: Amsterdam
latnumberLatitude, with lng: the 20 stores nearest this point, nearest first, with distance_km.
Example: 47.5596
lngnumberLongitude, with lat.
Example: 7.5886
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. country picks the store finder's language and the market the query is read in; the stores themselves can be in a neighbouring country (country_code). Cost: 1 credit.
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=210)
# The 20 stores nearest a point near three borders, with today's hours.
d = client.action.stores(lat=47.5596, lng=7.5886, country="ch")["data"]
print(d["countries"])
for s in d["stores"]:
today = s["hours"][0]
print(s["country_code"], s["name"], s["distance_km"], "closed" if today["closed"] else f'{today["open"]}-{today["close"]}')Response