Publiczne API · Bezpłatne

Dokumentacja API

Bezpłatne REST API do pobierania danych rejestrowych polskich firm. Limit 100 requestów/godzinę per adres IP. Nie wymaga klucza API.

Rate limiting

Każdy adres IP może wykonać maksymalnie 100 requestów na godzinę. Przekroczenie limitu zwraca status 429 Too Many Requests. Licznik resetuje się co godzinę.

X-RateLimit-Limit

Łączny limit (100)

X-RateLimit-Remaining

Pozostałe żądania

X-RateLimit-Reset

Reset (Unix timestamp)

GET/api/v1/firma/{nip}

Zwraca pełne dane firmy po numerze NIP (10 cyfr) wraz z BiznesScore.

curl

curl "https://biznesbaza.pl/api/v1/firma/5272649986"

JavaScript (fetch)

const res = await fetch("https://biznesbaza.pl/api/v1/firma/5272649986");
const { firma } = await res.json();
console.log(firma.nazwa, firma.biznes_score.score);

Response 200 OK

{
  "firma": {
    "id": "1",
    "slug": "allegro-sp-z-oo",
    "nazwa": "Allegro Sp. z o.o.",
    "nip": "5272649986",
    "regon": "367333902",
    "krs": "0000672805",
    "forma_prawna": "Sp. z o.o.",
    "status": "aktywna",
    "adres": {
      "ulica": "ul. Grunwaldzka 182",
      "miasto": "Poznań",
      "kod_pocztowy": "60-166",
      "wojewodztwo": "wielkopolskie"
    },
    "data_rejestracji": "2017-03-01",
    "pkd_kody": [
      { "kod": "47.91.Z", "nazwa": "Sprzedaż detaliczna przez Internet" }
    ],
    "kapital_zakladowy": 32940250,
    "biznes_score": {
      "score": 75,
      "poziom": "wysoki"
    }
  }
}

GET/api/v1/szukaj

Wyszukuje firmy po nazwie, NIP lub REGON. Zwraca max 10 wyników na stronę.

Parametr	Typ	Opis
`q`	string	Wymagane. Fraza do wyszukania (min. 2 znaki)
`limit`	number	Liczba wyników (1–10, domyślnie 10)
`strona`	number	Numer strony (domyślnie 1)

curl

curl "https://biznesbaza.pl/api/v1/szukaj?q=allegro&limit=5"

Response 200 OK

{
  "firmy": [ { "id": "1", "nazwa": "Allegro Sp. z o.o.", ... } ],
  "total": 42,
  "page": 1,
  "total_pages": 5
}

Kody błędów

Status	Znaczenie
`200`	Sukces
`400`	Błędne parametry (np. nieprawidłowy NIP)
`404`	Firma nie znaleziona
`429`	Przekroczono limit requestów (100/h)
`500`	Błąd serwera

Używasz naszego API?

Chętnie poznamy Twój projekt. Napisz do nas, a postaramy się zwiększyć limit dla Twojego IP lub omówić możliwości współpracy.

Napisz do nas →