Search pozwala odpytywać polski rejestr firm i filtrować wyniki do podmiotów które faktycznie mają dane kontaktowe. Ten przewodnik pokazuje jak budować skuteczne zapytania i najlepiej wykorzystać dostępne filtry.
Filtr kontaktu
Parametr has_contact to najważniejszy filtr w Search. Zapewnia że każdy wynik ma co najmniej jeden zweryfikowany kontakt — żadnych pustych rekordów, żadnych ślepych zaułków. Możesz filtrować po phone, email, fax, lub any żeby akceptować wszystkie typy kontaktów.
Dostępne filtry
Wszystkie filtry są opcjonalne i można je łączyć. Im więcej filtrów, tym bardziej celowane wyniki.
| Parameter | Type | Description |
|---|---|---|
has_contact | enum | phone, email, fax, any |
activity_code | string | Exact PKD code. E.g. 62.01.Z |
activity_prefix | string | PKD prefix. E.g. 62 |
active_start_from | date | Registration date from. Y-m-d |
active_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 z numerem telefonu
Znajdź firmy zarejestrowane w ostatnim miesiącu na Mazowszu z numerem telefonu.
GET /api/v1/companies/search curl "https://alexambros.com/api/v1/companies/search?has_contact=phone&active_start_from=2026-02-01&active_start_to=2026-03-01&voivodeship=mazowieckie" \ -H "Authorization: Bearer sk_api_xxxx"
Przykład — firmy IT po kodzie PKD
Znajdź aktywne firmy IT po prefiksie PKD z adresem e-mail.
GET /api/v1/companies/search curl "https://alexambros.com/api/v1/companies/search?has_contact=email&activity_prefix=62&status=ACTIVE" \ -H "Authorization: Bearer sk_api_xxxx"
Przykład — firmy w konkretnym mieście
Znajdź firmy w Warszawie z dowolnym typem kontaktu.
GET /api/v1/companies/search curl "https://alexambros.com/api/v1/companies/search?has_contact=any&city=Warszawa" \ -H "Authorization: Bearer sk_api_xxxx"
Paginacja
Search 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 Search kosztuje 20 kredytów niezależnie od liczby zwróconych wyników. Planuj zapytania żeby uzyskać jak najbardziej trafne wyniki przed paginowaniem.