> 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/hromadne-api-volani.md).

# Hromadné (BULK) API volání

Jak stránkovat výsledky, filtrovat podle štítků nebo časového období a na co si dát pozor při hromadném volání BizMachine API.

*Aktualizováno: 8. října 2026*

Vybrané API endpointy (kolekční endpointy) podporují hromadné volání - můžete jedním dotazem získat data pro více firem najednou. Kompletní přehled endpointů a parametrů najdete v [API dokumentaci](http://developers.bizmachine.com/).

### Stránkování výsledků

API vrací standardně **200 záznamů na stránku**. Parametrem `Limit` velikost stránky nastavíte, nejvýš na **250 záznamů** (k říjnu 2026). K dalším stránkám se dostanete parametrem `Offset`, který musí být násobkem velikosti stránky:

```
GET /cz/v3/events?Company.NationalIn=12345678&Limit=250&Offset=0      (1. stránka)
GET /cz/v3/events?Company.NationalIn=12345678&Limit=250&Offset=250    (2. stránka)
GET /cz/v3/events?Company.NationalIn=12345678&Limit=250&Offset=500    (3. stránka)
```

Bez parametru `Limit` stránkujte po 200 (`Offset=0`, `200`, `400`). Pokud `Offset` není násobkem velikosti stránky, API vrátí chybu `ArgumentOutOfRangeException`, při výchozí velikosti stránky například „Offset has to be multiple of page size 200“.

Celkový počet záznamů najdete v odpovědi v poli `paging.totalItems`. Stránkujte, dokud nezpracujete všechny záznamy.

> **Pozor:** Používejte parametr `Offset`, ne `Page`. Parametr `Page` API tiše ignoruje a vrací stále první stránku - výsledkem jsou duplicitní data bez jakékoliv chybové hlášky.

### Nejčastěji používané parametry

#### Tag.Uid a Company.Tag.Uid - filtrování podle štítku

API vrátí data pouze pro firmy v zadaném štítku (seznamu). Štítek můžete vytvořit přímo v Prospectoru jako „Seznam firem“, nebo ho spravovat kompletně přes API.

Typický postup: přes API nahrajte seznam firem do štítku a pak zavolejte datový endpoint s filtrem na tento štítek - dostanete data jen pro tyto firmy. Název parametru se liší podle endpointu:

* **`Tag.Uid`** - endpointy s daty o firmě, například `basic-infos`, `contacts`, `metrics`, `indicators` a `owners`
* **`Company.Tag.Uid`** - endpointy `events`, `financials/reports`, `job-postings` a `locations`

Když parametr pojmenujete špatně, API ho tiše ignoruje a vrátí data za všechny firmy (viz níže).

#### Updated.From, Updated.To - inkrementální aktualizace

API vrátí pouze záznamy změněné ve sledovaném období. Typicky stačí jednorázově naimportovat všechna data a pak pravidelně dotazovat jen přírůstek za poslední období.

### Na co si dát pozor

* **Neznámé parametry API tiše ignoruje.** Pokud použijete špatný název parametru (překlep, nesprávný formát), API nevrátí chybu - vrátí nefiltrované výsledky. Když dostáváte neočekávaně velký počet záznamů, zkontrolujte názvy parametrů.
* **Vozidla používají jiný identifikátor.** Endpoint `vehicles` nepoužívá `Company.NationalIn`, ale `Company.UniqueId` ve formátu `{dataset}-company-{ico}` (např. `cz-company-12345678`). Podrobnosti viz [Přehled API endpointů](https://help.bizmachine.com/api-a-integrace/api-endpointy.md).
* **Maximum 250 záznamů na stránku platí pro všechny kolekční endpointy.** (k říjnu 2026) Tato hodnota (`maxPageSize`) je uvedena v odpovědi v sekci `paging`.

### Další informace

* [Přehled API endpointů](https://help.bizmachine.com/api-a-integrace/api-endpointy.md)
* [Jaké jsou moje API limity?](https://help.bizmachine.com/api-a-integrace/api-limity.md)
* [API dokumentace](http://developers.bizmachine.com/)
