# Endpoint eshops — e-shopy provozované firmou

*Aktualizováno: 28. dubna 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 <support@bizmachine.com>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.bizmachine.com/api-a-integrace/api-endpointy/endpoint-eshops.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.