> 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/en/api-and-integrations/api-endpoints/endpoint-eshops.md).

# Endpoint eshops: e-shops operated by a company

E-shops operated by a company: URL, status, payment and delivery options, customer ratings and traffic metrics from comparison portals.

*Updated: 5 October 2026*

```
GET /{dataset}/v3/eshops
```

E-shops operated by a company: URL, status, payment options, delivery options, customer ratings and traffic metrics. The data comes from comparison portals (Heureka, Zboží.cz) and other sources.

***

### What this endpoint returns

For each e-shop it returns:

* **Identification**: name, URL, status (Active or Inactive), launch date, description
* **Payment options**: the list of accepted payment methods (card, bank transfer, cash on delivery, PayPal and others)
* **Delivery options**: the available carriers (PPL, DPD, Zásilkovna, Česká pošta and others)
* **Ratings**: the total number of reviews and the average rating from Heureka and Zboží.cz
* **Traffic metrics**: estimated traffic, rank in the country, number of products, paid keywords
* **Technologies**: the detected tech stack of the e-shop (where available)

#### When to use this endpoint

* You want to find out whether a target company runs an e-shop and what its status is
* You need the direct URL of the e-shop (not the corporate website)
* You want signals of market strength: ratings, traffic, number of products
* You are analyzing the e-commerce segment for prospecting or market intelligence

#### When to use a different endpoint

| You need                                         | Use instead                                                                                                          |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------- |
| Only whether a company has an e-shop (yes or no) | `aggregated-data` (v4), the `data.metrics.eshopCount` field                                                          |
| Only the company website                         | `aggregated-data` (v4), the `data.contacts.website.value` field, or `suggest` (v4), the `contacts.website.url` field |

#### Availability

The endpoint is available for all datasets: **cz, sk, hu, pl, de**.

***

### Technical details

{% openapi src="/files/FGwu42o2gqsEWtcATX3u" path="/{dataset}/v3/eshops" method="get" %}
[api-spec.temp.json](https://247275268-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYkl7SJ14Nk0vzhVx7upl%2Fuploads%2Fgit-blob-f3abeffbb2534d765afc74352238d1f9ef6bc845%2Fapi-spec.temp.json?alt=media)
{% endopenapi %}

#### What to watch out for

* `data[i].data.metrics.*.timeline[0]` is the latest value of the metric. The metrics are time series, so always index into `timeline`.
* `data[i].data.sources[i].metrics` are flat values (not a timeline), a different structure from the metrics at the e-shop level.
* `technologies` can be an empty array. Not every e-shop has detected technologies.
* One company can have several e-shops, so iterate over all records in `data[]`.
* `countryRank`: a lower number means a larger e-shop (rank 1 is the largest in the country).

***

### Instructions for AI agents

Copy this block and give it to your agent. It describes how to use the endpoint correctly.

```
## 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 to 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
```

***

Need help? Write to <support@bizmachine.com>