Endpoint eshops - e-shopy provozované firmou

E-shopy provozované firmou - URL, status, platební metody, dopravci, hodnocení a metriky návštěvnosti.

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

E-shopy provozované firmou

get

/{dataset}/v3/eshops

Authorizations

X-Api-KeystringRequired

Authorization header which caries ApiKey information. Copy value generated using ApiKey endpoint.
Example: abcdefgh-1234-5678-90yz-ijklmnopqrs

Path parameters

datasetstringRequired

Query parameters

Company.NationalInstring · nullableOptional

IČO firmy.

Limitinteger · int32 · max: 250 · nullableOptional

Počet výsledků. Výchozí 200, max 250.

Offsetinteger · int32 · nullableOptional

Stránkování.

SortBystring · nullableOptional

Řazení výsledků.

Responses

200

Success

No content

get/{dataset}/v3/eshops

GET /{dataset}/v3/eshops HTTP/1.1
Host: api.bizmachine.com
X-Api-Key: YOUR_API_KEY
Accept: */*

200

Success

No content

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 [e-mail]