API

Alza API: produkty, ceny a recenze v JSON

Alza má vlastní marketplace rozhraní pro prodejce a to řeší jinou věc: váš sortiment a vaše objednávky. Tohle API odpovídá na otázku trhu — co se prodává, za kolik a co na to zákazníci. Účet prodejce není potřeba a odpověď přijde jako JSON.

Získat klíč zdarma Úplná dokumentace: každý endpoint, každý parametr →

Endpointy

endpoint	Co se vrací	Povinné
search	Vyhledávání na jedné národní verzi obchodu, 24 produktů na stránku, s cenou a dostupností.	query
category	Produkty jedné kategorie — z navigace webu, z drobečkové navigace produktu nebo z adresy kategorie.	category
product/detail	Kompletní karta produktu podle id nebo URL: název, značka, kód výrobce, cena a obrázky.	product_id
product/reviews	Recenze zákazníků k jednomu produktu, od nejnovějších, přímo z recenzní sekce obchodu.	product_id

Každé volání se účtuje v kreditech. Neúspěšná a blokovaná volání jsou zdarma.

Funkční příklad

Alza provozuje několik národních verzí a každá má vlastní ceny i sortiment. Bez určení verze dostanete výchozí, ne nějaký průměr napříč zeměmi.

Požadavek

curl -X POST https://api.reefapi.com/alza/v1/search \
  -H "x-api-key: VAS_KLIC" \
  -H "content-type: application/json" \
  -d '{"query": "notebook", "page": 1}'

Odpověď (zkrácená)

{
  "ok": true,
  "data": {
    "results": [
      {
        "product_id": "...",
        "title": "...",
        "brand": "...",
        "price": 24990,
        "currency": "CZK",
        "available": true
      }
    ]
  },
  "meta": { "record_count": 24, "cache_hit": false, "mode": "live" }
}

Místo vlastního scraperu na Alzu

Napsat si scraper na Alzu první den funguje. Potíže přijdou později: když se změní struktura výpisu, parser vrátí prázdný seznam místo chyby, a při delším běhu zasáhne ochrana proti robotům uprostřed práce. Obojí u vás vypadá stejně — jako by produkty nebyly.

Tady je údržba na nás: když se změní schéma, opravíme engine; když přijde blokace, vrátí se chybový kód a takové volání se neúčtuje.

Na jednorázový export je vlastní skript levnější a říkáme to na rovinu. U sledování, které má běžet každý den, se platí za výpadky, ne za kód.

This page in English →Úplná dokumentace: každý endpoint, každý parametr →

Omezení a poctivé poznámky

Tohle není oficiální API Alzy a s Alzou nemáme žádné partnerství.
Každá národní verze obchodu má vlastní ceny a sortiment; bez určení dostanete výchozí.
Pokud obchod nezveřejní skladovou dostupnost, pole přijde jako null — nic nedopočítáváme.
Žádná cache: každé volání ukazuje stav v okamžiku dotazu.