Action
Action Reviews API
Customer reviews of one Action (action.com) article, up to 100 per call with offset paging. Action publishes reviews on four storefronts only: the Netherlands, Germany, France and Poland. scope local (default) returns the reviews written on that storefront, in its language; international the ones written on the other three; all both (offset + limit up to 100). Each review has its rating, title, text, date, its own language, aspect ratings, pros and cons; no reviewer name or any reviewer identity is returned. 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/jsonproduct_codestring | integerrequiredAction's article number (items[].product_code).
Example: 3224838
countrystringdefault:nlThe Action market, as a lowercase country code. This endpoint serves the four storefronts where Action publishes reviews: nl (nl-nl), de (de-de), fr (fr-fr) and pl (pl-pl). Any other country answers 400, not charged. 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.fr— France, EUR, fr (French) (fr-fr).de— Germany, EUR, de (German) (de-de).pl— Poland, PLN, pl (Polish) (pl-pl).
scopeenum<string>default:localWhich reviews.
Example: all
local— Reviews written on this storefront, in its language (default).international— Reviews of the same article written on the other three storefronts.all— Both sets merged; offset + limit at most 100 (page further with local and international). Reads two sets, still 1 credit.
sortenum<string>default:relevantReview order.
Example: newest
relevant— Action's own order (default).newest— Newest first.oldest— Oldest first.highest— Highest rating first.lowest— Lowest rating first.
ratinginteger[]Star ratings to include, 1 to 5 (e.g. [1, 2]).
Example: [1, 2]
querystringOnly reviews that mention this text, 1-100 characters.
Example: warm
limitintegerdefault:20Reviews per call, 1 to 100.
Example: 100
offsetintegerdefault:0Reviews to skip (paging).
Example: 20
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. Reviews exist on nl, de, fr and pl only; other countries answer 400, not charged. An article with no reviews answers 200 with total 0. Aspect names come in the storefront's language (Kwaliteit = quality, Prijs-kwaliteitverhouding = value for money); the review text stays in the language it was written in. Cost: 1 credit (scope all reads both review sets and still costs 1 credit).
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=210)
# One- and two-star reviews of an article from all four review storefronts.
d = client.action.reviews(product_code="3224838", country="nl", scope="all", rating=[1, 2], limit=100)["data"]
print(d["total"], "reviews:", d["local_total"], "local,", d["international_total"], "international")
for r in d["reviews"]:
print(r["language"], r["rating"], r["reviewed_at"][:10], r["title"], (r["text"] or "")[:80])Response