REST API · JSON · UTF-8

API dla deweloperów

Programowy dostęp do danych 475 000+ polskich firm. KRS, NIP, REGON, sprawozdania finansowe, Risk Score AI, MSiG, Biała Lista VAT.

JSON REST API

Standardowe REST z odpowiedziami JSON. UTF-8, content-type: application/json.

Bearer Auth

Autoryzacja przez nagłówek Authorization: Bearer {API_KEY}. Wystawiamy klucz po kontakcie.

475 000+ firm

Wszystkie spółki z KRS + JDG z CEIDG. Aktualizacja codzienna z RDF MS i Białej Listy VAT.

Rate limit

1 000 req/h dla Free, 50 000 req/h dla Pro. Nagłówki X-RateLimit-Remaining w odpowiedzi.

Autoryzacja

Wszystkie endpointy wymagają nagłówka Authorization: Bearer YOUR_API_KEY. Aby otrzymać klucz, napisz na emilpinskidev@gmail.com.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://raport360.pl/api/company/7740001454

Endpointy

GET/api/szukaj-firme?q={query}

Wyszukiwanie firm po nazwie, NIP lub KRS. Zwraca listę dopasowań (max 20).

Przykład:

curl "https://raport360.pl/api/szukaj-firme?q=PKN+Orlen"

Odpowiedź:

{
  "results": [
    {
      "krs": "0000028860",
      "nip": "7740001454",
      "regon": "610188201",
      "nazwa": "POLSKI KONCERN NAFTOWY ORLEN S.A.",
      "miasto": "PŁOCK",
      "wojewodztwo": "MAZOWIECKIE"
    }
  ],
  "count": 1
}

GET/api/company/{nip}

Pełen profil firmy po NIP — dane rejestrowe, zarząd, status, adres, PKD.

Przykład:

curl "https://raport360.pl/api/company/7740001454"

Odpowiedź:

{
  "krs": "0000028860",
  "nip": "7740001454",
  "regon": "610188201",
  "nazwa": "POLSKI KONCERN NAFTOWY ORLEN S.A.",
  "forma_prawna": "Spółka Akcyjna",
  "kapital_zakladowy": 534636326.25,
  "data_rejestracji": "2001-09-21",
  "status": "aktywna",
  "pkd": ["19.20.Z", "46.71.Z"],
  "adres": { "miasto": "PŁOCK", "ulica": "Chemików 7" }
}

GET/api/financials/{krs}

Sprawozdania finansowe firmy z e-Sprawozdań MF (lata 2018–2024).

Przykład:

curl "https://raport360.pl/api/financials/0000028860"

Odpowiedź:

{
  "krs": "0000028860",
  "lata": [
    {
      "rok": 2024,
      "przychody_netto": 287612000000,
      "zysk_netto": 12834000000,
      "aktywa_razem": 145000000000,
      "zobowiazania": 78900000000,
      "kapital_wlasny": 66100000000,
      "rentownosc_ros": 4.46,
      "zadluzenie": 0.54
    }
  ]
}

GET/api/ranking?branza={pkd}&limit={n}

Ranking firm w branży po przychodach. Sortowanie: revenue_desc, profit_desc.

Przykład:

curl "https://raport360.pl/api/ranking?branza=62.01.Z&limit=30"

Odpowiedź:

{
  "branza": "62.01.Z",
  "ranking": [
    {
      "pozycja": 1,
      "nip": "7342867148",
      "nazwa": "CD PROJEKT S.A.",
      "przychody_2024": 1340000000,
      "zysk_2024": 481000000
    }
  ]
}

GET/api/ai-analysis/{nip}

Analiza AI ryzyka firmy. Risk Score 0–100, rating A–E, red flags. Cache 30 dni.

Przykład:

curl "https://raport360.pl/api/ai-analysis/7740001454"

Odpowiedź:

{
  "nip": "7740001454",
  "risk_score": 78,
  "rating": "A",
  "red_flags": [],
  "summary": "Stabilna spółka z dobrą rentownością...",
  "cache_until": "2026-05-30"
}

GET/api/health

Health check API (status, czas odpowiedzi, wersja).

Przykład:

curl "https://raport360.pl/api/health"

Odpowiedź:

{ "status": "ok", "version": "1.0", "db": "connected" }

Cennik API

Free na start, Pro od 199 zł/mc.

Free

0 zł

Do testów i małych projektów.

•1 000 req/h
•Cache 24h
•Tylko dane KRS
•Wsparcie e-mail

POLECANE

Pro

199 zł / mc

Dla firm i SaaS.

•50 000 req/h
•Cache real-time
•Pełne dane (finanse, AI, MSiG)
•Webhook na zmiany
•Wsparcie priorytetowe

Enterprise

wycena

Bulk integracje, dedykowane SLA.

•Bez limitu
•Bulk export CSV
•Custom endpoints
•SLA 99,9%
•Dedykowany support

Otrzymaj klucz API

Napisz do nas — opisz swój use case, otrzymasz klucz API w ciągu 24h roboczych. Free key zaraz po weryfikacji e-mail.

Poproś o klucz API