For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Skip to content

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

E-shops operated by a company

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

Company ID (IČO) of the company.

Limitinteger · int32 · max: 250 · nullableOptional

Number of results. Default 200, max 250.

Offsetinteger · int32 · nullableOptional

Pagination offset.

SortBystring · nullableOptional

Sort order of the results.

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

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.


Need help? Write to support@bizmachine.com

Last updated