Aukro API: aukce, Kup teď a ceny v Kč z aukro.cz
Kdo hledá „Aukro REST API“ kvůli datům z nabídek, najde tu jiný přístup: rozhraní čte aukro.cz tak, jak ho vidí návštěvník bez přihlášení, a vrací položky z hledání a jejich detail: cenu v korunách, jestli jde o běžící aukci, nebo pevnou cenu, cenu Kup teď, počet přihazujících, konec aukce, lokalitu, kategorie a v detailu i dopravu a platbu. Prodejcům neposlouží: položku přes něj nevystavíte, nabídku neupravíte a „Moje Aukro“ nespravujete; s ceníkem poplatků za vystavení také nesouvisí. Prodejní API Aukra to není, jde jen o data z veřejně viditelných nabídek.
Endpointy
| endpoint | Co se vrací | Povinné |
|---|---|---|
| search | Hledání podle slova, 1 až 60 položek na stránku (výchozí 12), nejvýš do 100. stránky. Každý řádek: aktuální cena v Kč, `price_basis` (běžící aukce, nebo pevná cena), cena Kup teď, počet kusů, počet přihazujících, začátek a konec, lokalita s PSČ, parametry a cesta kategorií. Když Aukro slovo vyhodnotí jako kategorii, engine ji vrátí v `resolved_category`. | query |
| detail | Jedna položka podle `listing_id` z hledání: celý popis, galerie, cena a nejnižší možný příští příhoz (`next_bid_minimum`), cenu Kup teď, pokud je aktivní, stav a časy, prodané kusy, způsoby dopravy s cenou (třeba Balíkovna 65 Kč), platební možnosti a EAN, pokud ho prodejce vyplnil. | listing_id |
Každé volání se účtuje v kreditech. Neúspěšná a blokovaná volání jsou zdarma.
Funkční příklad
U aukce je `price` aktuální cena aukce, ne hodnota zboží. Dvě stejné mince Maple Leaf 2026 (1 oz) z Brna, vystavené 25. 10. s odstupem jedenácti minut a končící 28. 10., stály při našem dotazu 1 110 Kč (3 přihazující) a 3 Kč (2 přihazující). Kdo z hledání počítá průměrnou cenu, ať srovnává jen aukce těsně před koncem (`ends_at`), nebo nabídky s `price_basis: "fixed_price"`. U mincí byly aukcí všechny řádky první stránky, u dotazu „kočárek“ mělo pevnou cenu 8 z 20.
curl -X POST https://api.reefapi.com/aukro/v1/search \
-H "x-api-key: VAS_KLIC" \
-H "content-type: application/json" \
-d '{"query": "stříbrná mince", "page_size": 20}'{
"ok": true,
"data": {
"query": "stříbrná mince",
"page": 1,
"page_size": 20,
"total": 3711,
"source_total_pages": 186,
"last_supported_page": 100,
"has_more": true,
"resolved_category": null,
"listings": [
...
{
"listing_id": "7138871858",
"title": "Stříbrná mince 1oz Maple Leaf 2026",
"url": "https://aukro.cz/stribrna-mince-1oz-maple-leaf-2026-7138871858",
"price": { "amount": 1110, "currency": "CZK" },
"price_basis": "current_auction_price",
"auction": true,
"buy_now_price": null,
"quantity": 1,
"state": "ACTIVE",
"starts_at": "2026-10-25T19:10:02.272+01:00",
"ends_at": "2026-10-28T19:10:00+01:00",
"bidder_count": 3,
"location": "Brno",
"postcode": "61600",
"categories": [
{ "id": 8531, "name": "Sběratelství", "seoUrl": "sberatelstvi" },
{ "id": 8479, "name": "Numismatika", "seoUrl": "numismatika" },
{ "id": 52870, "name": "Investiční předměty numismatika", "seoUrl": "investicni-predmety-numismatika" },
{ "id": 52872, "name": "Stříbrné investiční předměty", "seoUrl": "stribrne-investicni-predmety" }
],
...
},
{
"listing_id": "7138871788",
"title": "Stříbrná mince 1oz Maple Leaf 2026",
"price": { "amount": 3, "currency": "CZK" },
"price_basis": "current_auction_price",
"auction": true,
"starts_at": "2026-10-25T18:59:01.482+01:00",
"ends_at": "2026-10-28T18:58:50+01:00",
"bidder_count": 2,
"location": "Brno",
...
},
...
]
},
"meta": { "record_count": 20, "upstream_requests": 1, "charged_credits": 3, "cache_hit": false, "mode": "live" }
}Vlastní scraper na Aukro: příhoz, Kup teď a přesměrování
U nabídek s pevnou cenou (Kup teď) Aukro v detailu pole `price` vůbec neposílá; částka je jen v `buyNowPrice`, kdežto u aukce je v `price`. Na tom při stavbě enginu začátkem října 2026 neprošlo první měřicí kolo; oprava proběhla před spuštěním. Opačný případ je neaktivní Kup teď s nulou: to není zboží zdarma, a proto ho engine vrací jako null.
Některá slova Aukro nehledá, ale pošle je rovnou do kategorie. „lego“, „kočárek“ i „gramofon“ skončily 26. 10. v kategoriích, výsledky pak mohou obsahovat i příbuzné zboží a engine to hlásí v `meta.warnings` a v `resolved_category`. Při tom přesměrování se snadno ztratí číslo stránky a velikost stránky; engine je drží, takže druhá stránka je opravdu druhá.
Neexistující id položky vrací NOT_FOUND a dotaz, který opravdu nic nenašel, prázdný seznam. Pokud Aukro změní tvar odpovědi nebo přesměrování, přijde chyba SCHEMA_DRIFT, ne tichá nula.
Kdo se podívá na pár cen, vystačí si s webem Aukra. Kdo je sbírá denně, potřebuje u každého řádku vědět, jestli je to rozjetý příhoz, nebo cena, za kterou se dá koupit hned.
Omezení a poctivé poznámky
- Rozhraní je neoficiální, Aukro se na něm nepodílí a partnerem Aukra nejsme.
- Hledání teď u některých dotazů selhává (měřeno 26. 10. 2026): „lego technic“ dvakrát ze dvou skončilo chybou SCHEMA_DRIFT, „nintendo switch“ jednou SCHEMA_DRIFT a jednou TARGET_BLOCKED. Ostatních 8 vyzkoušených dotazů prošlo. Neúspěšná volání se neúčtovala.
- Jsou jen dvě akce, hledání a detail. Filtry a řazení, historii příhozů, ostatní nabídky prodejce ani akční a členské ceny API nemá.
- Stránkovat jde do 100. stránky (`last_supported_page`), i když Aukro hlásí víc; u stříbrných mincí 186 stránek.
- Ceny dopravy v `shipping_options` jsou takové, jaké Aukro u položky uvádí. Nejde o součet v košíku a poplatky při placení v nich nejsou.
- `gtin` je null, pokud prodejce EAN nevyplnil; id položky za něj nedosazujeme.
- Odpověď nese veřejnou přezdívku prodejce a jeho hodnocení; v příkladu jsme je vynechali. Kdo data posílá dál, ať zváží, jestli tyto údaje potřebuje.
- Hledání stojí 3 kredity za volání, detail 2 kredity.