> For the complete documentation index, see [llms.txt](https://help.bizmachine.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.bizmachine.com/api-a-integrace/api-endpointy/endpoint-eshops.md). # Endpoint eshops - e-shopy provozované firmou *Aktualizováno: 30. července 2026* ``` GET /{dataset}/v3/eshops ``` E-shopy provozované firmou - URL, status, platební metody, dopravci, hodnocení zákazníků a metriky návštěvnosti. Data pocházejí ze srovnávačů (Heuréka, Zboží.cz) a dalších zdrojů. *** ## Jaké informace tento endpoint obsahuje Pro každý e-shop vrátí: * **Identifikaci** - název, URL, status (Active/Inactive), datum vzniku, popis * **Platební metody** - seznam akceptovaných plateb (karta, bankovní převod, dobírka, PayPal…) * **Dopravce** - dostupné přepravní metody (PPL, DPD, Zásilkovna, Česká pošta…) * **Hodnocení** - celkový počet recenzí a průměrná hodnota z Heuréky / Zboží.cz * **Metriky návštěvnosti** - odhadovaná návštěvnost, pořadí v zemi, počet produktů, placená klíčová slova * **Technologie** - rozpoznaný tech stack e-shopu (pokud je dostupný) ### Kdy tento endpoint použít * Zjišťujete, zda cílová firma provozuje e-shop a jaký je jeho stav * Potřebujete přímou URL e-shopu (ne korporátní web firmy) * Chcete signály tržní síly - hodnocení, návštěvnost, počet produktů * Analyzujete e-commerce segment pro prospecting nebo market intelligence ### Kdy použít jiný endpoint | Potřebujete | Použijte místo toho | | ------------------------------------------------ | --------------------------------------------------------------------------------------------------- | | Chcete jen zjistit, zda firma e-shop má (ano/ne) | `aggregated-data` (v4) - pole `data.metrics.eshopCount` | | Chcete jen zjistit webovou stránku firmy | `aggregated-data` (v4) - `data.contacts.website.value` nebo `suggest` (v4) - `contacts.website.url` | ### Dostupnost Endpoint je dostupný pro všechny datasety: **cz, sk, hu, pl, de**. *** ## Technické informace {% openapi src="/files/XsgqAcv6XJjIzqRU0Ubr" path="/{dataset}/v3/eshops" method="get" %} [api-spec.temp.json](https://2865951599-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9IXbHwc2ctAHDxOoCdoX%2Fuploads%2Fgit-blob-de88966fec10805d50f17dc1d05ba0ecb23e8eb2%2Fapi-spec.temp.json?alt=media) {% endopenapi %} ### Na co si dát pozor * `data[i].data.metrics.*.timeline[0]` = nejnovější hodnota metriky. Metriky jsou časové řady - vždy indexujte do `timeline`. * `data[i].data.sources[i].metrics` jsou ploché hodnoty (ne timeline) - jiná struktura než metriky na úrovni e-shopu. * `technologies` může být prázdné pole - ne všechny e-shopy mají rozpoznané technologie. * Jedna firma může mít více e-shopů - iterujte přes všechny záznamy v `data[]`. * `countryRank`: nižší číslo = větší e-shop (rank 1 = největší v zemi). *** ## Instrukce pro AI agenty Zkopírujte tento blok a předejte ho agentovi - popisuje, jak endpoint správně používat. ``` ## BizMachine API: eshops endpoint Purpose: Returns e-shop data for a company — URL, status, payment options, delivery options, customer ratings, and traffic metrics from comparison portals (Heuréka, Zboží.cz). When to use: - You want to check if a company has an e-shop and what its URL and status is - You need customer rating signals or traffic estimates - You are prospecting in the e-commerce segment When NOT to use: - You only need to know if a company has an eshop (yes/no) → use aggregated-data (data.metrics.eshopCount) - You need the company's website → use aggregated-data (data.contacts.website.value) or suggest (v4, contacts.website.url) - You are searching for companies by segment → use collection endpoints URL: GET https://api.bizmachine.com/{dataset}/v3/eshops Required: - Path: dataset — "cz", "sk", "hu", "pl", "de" - Header: X-Api-Key: {api_key} Optional: - Query: Company.NationalIn — filter by IČO (e.g. "05450641") - Query: Limit — default 200, max 250 - Query: Offset — pagination Key response fields (per item in data[]): data[i].data.uniqueId — eshop ID data[i].data.company.nationalIn — company IČO data[i].data.name — eshop name data[i].data.url — eshop URL data[i].data.status — "Active" or "Inactive" data[i].data.establishedAt — launch date data[i].data.description — eshop description data[i].data.paymentOptions[i].name — accepted payment method data[i].data.deliveryOptions[i].name — delivery carrier data[i].data.metrics.countryRank.timeline[0].value — country rank (lower = larger) data[i].data.metrics.trafficEstimate.timeline[0].value — estimated monthly visitors data[i].data.metrics.productCount.timeline[0].value — number of products data[i].data.metrics.ratingCountTotal.timeline[0].value — total customer reviews data[i].data.metrics.paidKeywords.timeline[0].value — paid keywords count data[i].data.sources[i].code — source portal ("cz-heureka", "cz-zbozicz") data[i].data.sources[i].metrics.ratingValue — avg rating from source (0–1) data[i].data.sources[i].metrics.ratingCountTotal — review count from source data[i].data.sources[i].metrics.deliveryDurationDays — avg delivery duration (days) data[i].data.sources[i].attributes[i].code — badges (e.g. "cz-heureka_blue_badge") data[i].data.technologies — detected tech stack (may be empty array) Gotchas: - metrics.*.timeline[0] = most recent value — always index into timeline array - sources[i].metrics are flat values, NOT timeline — different structure from top-level metrics - technologies may be empty array — not all eshops have detected tech stack - One company may have multiple eshops — always iterate all data[] items - countryRank: lower = larger eshop (rank 1 = #1 in country) Typical workflow: 1. suggest or aggregated-data → get nationalIn 2. eshops?Company.NationalIn={nationalIn} → check eshop existence + get URL + ratings 3. Check status = "Active" before using the eshop URL ``` *** Potřebujete pomoc? Ozvěte se na