Wyszukiwarka firm pozwala odpytywać polski rejestr firm i filtrować wyniki według własnych kryteriów - branży, lokalizacji, statusu czy daty rejestracji. Ten przewodnik pokazuje jak budować precyzyjne zapytania i najlepiej wykorzystać dostępne filtry.
Dostępne filtry
Wszystkie filtry są opcjonalne i można je łączyć. Im więcej filtrów, tym bardziej precyzyjne wyniki.
| Parameter | Type | Description |
|---|---|---|
activity_code | string | Exact PKD code. E.g. 6201Z |
activity_prefix | string | PKD prefix. E.g. 62 |
activity_start_from | date | Registration date from. Y-m-d |
activity_start_to | date | Registration date to. Y-m-d |
voivodeship | string | E.g. mazowieckie |
city | string | City name. |
postal_code | string | Postal code. |
status | enum | ACTIVE, SUSPENDED, DELETED |
legal_form | string | Legal form slug. |
page | integer | Page number. Default: 1. |
Przykład – nowe firmy na Mazowszu
Znajdź firmy zarejestrowane w ostatnim miesiącu na Mazowszu.
GET /api/v1/companies/search curl "https://api.entiway.com/api/v1/companies/search?activity_start_from=2026-02-01&activity_start_to=2026-03-01&voivodeship=mazowieckie" \ -H "Authorization: Bearer sk_api_xxxx"
Przykład – aktywne firmy IT po kodzie PKD
Znajdź aktywne firmy z branży IT po prefiksie PKD.
GET /api/v1/companies/search curl "https://api.entiway.com/api/v1/companies/search?activity_prefix=62&status=ACTIVE" \ -H "Authorization: Bearer sk_api_xxxx"
Przykład – firmy pod danym kodem pocztowym
Znajdź aktywne firmy zarejestrowane pod danym kodem pocztowym.
GET /api/v1/companies/search curl "https://api.entiway.com/api/v1/companies/search?postal_code=00-001&status=ACTIVE" \ -H "Authorization: Bearer sk_api_xxxx"
Paginacja
Wyszukiwarka zwraca 20 wyników na stronę. Użyj parametru page żeby nawigować. Odpowiedź zawiera total, current_page i last_page żebyś wiedział ile wyników jest dostępnych.
Koszt w kredytach
Każde zapytanie do Wyszukiwarki firm kosztuje 20 kredytów niezależnie od liczby zwróconych wyników. Planuj zapytania żeby uzyskać jak najbardziej trafne wyniki przed paginowaniem.