Media Expert
Media Expert Search API
Search Media Expert (mediaexpert.pl, PLN): 30 products per page (up to 50), each with price, old price, the Omnibus lowest price of the last 30 days, the code price with its code and dates, Media Expert's own discount figure, seller (Media Expert or a marketplace seller), availability, rating and category, plus the facets to filter on. Many single words go straight to a category page (redirected_to). Costs 1 credit for a category answer, 3 for a search results page or a sort.
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/jsonquerystringrequiredSearch text, 1-200 characters. Polish works best (telewizor, pralka, iphone 17).
Example: telewizor
category_idstring | integerNarrow the search to one category id (categories[].category_id).
Example: 12798
sortenum<string>default:relevanceResult order. Any sort costs 3 credits: Media Expert loads sorted lists lazily.
Example: price_asc
relevance— Media Expert's own order (default).price_asc— Price low to high, in Media Expert's own order: it follows promotional and code prices, so it is approximate against price. Re-sort the page if you need a strict order.price_desc— Price high to low, Media Expert's own order (approximate, as above).rating— Customer rating.newest— Newest first.name_asc— Name A-Z.name_desc— Name Z-A.brand_asc— Brand A-Z.brand_desc— Brand Z-A.discount— Biggest discount first, as Media Expert orders it.
pageintegerdefault:1Page, 1 to 100 (total_pages says how deep the list goes).
Example: 2
limitintegerdefault:30Products per page: 5, 10, 15, 20, 30 or 50, the page sizes Media Expert offers.
Example: 50
Notes
Store. One store: mediaexpert.pl, Poland, prices in PLN. There is no country input: Media Expert runs one Polish storefront. Names, specifications, labels, store names and review text come back in Polish, as Media Expert writes them; field names are English. Cost: 1 credit when Media Expert answers the search with a full category page (many single words, such as telewizor, go straight to a category); 3 credits for a search results page or a sorted list, because Media Expert loads the rest of those pages lazily and that takes one more lookup. Billing is the actual cost of the call, and every answer reports it in credits_used.
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=210)
# TVs with a code price: listed price, Omnibus 30-day low, code price and code.
data = client.mediaexpert.search(query="telewizor")["data"]
print(data["total"], "products", data["redirected_to"])
for i in data["items"]:
code = i["code_price"]
if code:
print(i["product_id"], i["price"], i["omnibus_lowest_30d"], code["price"], code["code"], code["valid_to"])Response