KRS API i API KRS ze zmianami wspólników w JSON

Co dostajesz w API ruchów

• Endpoint GET /api/v1/ruchy ze strumieniem zdarzeń, filtrowany po dacie, rodzaju ruchu i sekcji PKD, do 500 rekordów w jednym zapytaniu.
• Endpoint GET /api/v1/osoby/{slug} z profilem osoby: przedział szacowanej wartości udziałów, data danych, link do metody i do 200 ostatnich ruchów.
• Webhook POST na Twój adres https z każdym ruchem obserwowanych osób i branż, podpisany nagłówkiem X-Podpis (HMAC-SHA256 treści sekretem webhooka).
• Klucz w nagłówku X-Api-Key, do 100 000 zapytań miesięcznie w planie Instytucja.

Każdy rekord ma pola, które da się od razu zapisać w CRM albo w hurtowni danych: identyfikator, rodzaj, etykietę, datę publikacji i datę zdarzenia, osobę z adresem profilu, spółkę z numerem KRS, tytuł, opis, zmianę środka przedziału szacunku w złotych oraz nazwę i adres źródła.

Czym różni się nasze API od bezpłatnego API KRS

Oficjalne API KRS udostępnia Ministerstwo Sprawiedliwości pod adresem api-krs.ms.gov.pl. Jest bezpłatne i zwraca odpis aktualny albo odpis pełny dla jednego numeru KRS w formacie JSON. To dobre źródło, gdy znasz spółkę i potrzebujesz jej aktualnego stanu. Gorzej sprawdza się, gdy pytanie brzmi „co się zmieniło u właścicieli, których obserwuję”, bo odpis nie mówi, który wpis jest nowy, a część danych osobowych w odpowiedziach bywa zamaskowana.

Żeby z odpisów zrobić strumień zmian, trzeba pobierać odpisy pełne regularnie, porównywać kolejne wpisy, łączyć zmiany pod jednym numerem wpisu w jedno zdarzenie, odróżniać sprzedaż udziałów od objęcia nowych udziałów w podwyższonym kapitale i przypisywać zdarzenia do osób, a nie tylko do spółek. Tę pracę wykonujemy codziennie dla spółek obserwowanych osób, a dla reszty bazy co tydzień.

Uczciwie mówiąc, jeśli potrzebujesz danych o wszystkich spółkach w Polsce, stowarzyszeniach i fundacjach, szersze API rejestrowe da Ci więcej rekordów. Nasze API jest węższe z założenia. Odpowiada na pytanie, co kupili, sprzedali i założyli właściciele z bazy, i robi to bez budowania własnego silnika porównań.

Jak pobrać ruchy z ostatniego tygodnia

Zapytanie o sprzedaże udziałów od 1 października w budownictwie wygląda tak.

GET https://najbogatsi.info/api/v1/ruchy?od=2026-10-01&rodzaj=sprzedaz&branza=F&limit=100

z nagłówkiem X-Api-Key: <Twój klucz>. Parametr rodzaj przyjmuje wartości przejecie, sprzedaz, zakup, nowa_spolka, wejscie, wyjscie, podwyzszenie_kapitalu, emisja i zmiana_szacunku. Parametr branza to litera sekcji PKD, na przykład F dla budownictwa albo J dla informacji i komunikacji. Bez parametru limit odpowiedź ma 100 rekordów, a największa dopuszczalna wartość to 500.

Profil osoby pobierasz po jej adresie z serwisu, na przykład GET https://najbogatsi.info/api/v1/osoby/<slug>. Odpowiedź zawiera przedział szacowanej wartości udziałów od i do w złotych, datę danych, z których go policzyliśmy, adres opisu metody szacunku oraz listę ruchów osoby od najnowszego.

Jak działa webhook

W panelu podajesz adres https, a system zapisuje sekret webhooka. Przy każdym nowym ruchu obserwowanej osoby albo branży wysyłamy żądanie POST z ruchem w JSON. Nagłówek X-Podpis zawiera HMAC-SHA256 całej treści liczony tym sekretem, więc Twój serwer sprawdza w jednej linii, czy wiadomość przyszła od nas. Webhook zastępuje odpytywanie API co godzinę i oszczędza limit zapytań.

Kto korzysta z API ruchów właścicielskich

• Banki i zespoły bankowości korporacyjnej, które chcą wiedzieć, że właściciel klienta sprzedał udziały albo założył nową spółkę, zanim temat trafi do prasy.
• Fundusze i family office, które mapują współinwestorów i wyjścia z inwestycji w swoich branżach.
• Kancelarie i butiki M&A, które zasilają CRM sygnałami o przejęciach i zmianach kontroli. Więcej o tym zastosowaniu piszemy na stronie dla doradców M&A.
• Redakcje ekonomiczne, które chcą mieć ruchy właścicieli w swoim systemie redakcyjnym z sygnaturą źródła.

Wspólny mianownik jest prosty. Te zespoły i tak płacą analitykowi za ręczne przeglądanie odpisów. API przenosi tę pracę do automatu i zostawia ludziom ocenę, czy ruch jest ważny.

Cztery kroki do pierwszego zapytania

1. Sprawdź dane bez konta. W polu na stronie głównej wybierz osobę albo branżę i rodzaj ruchu. Pierwsze trzy ruchy zobaczysz od razu.
2. Załóż konto i wybierz plan Instytucja. Płatność roczna obniża cenę o połowę, a fakturę VAT dostajesz od razu po płatności.
3. W panelu, w zakładce API, utwórz klucz. Klucz widzisz w całości tylko raz, potem panel pokazuje jego początek i licznik zapytań w okresie.
4. Podaj adres webhooka i dodaj obserwowane osoby oraz branże. Od tej chwili każdy ich ruch trafia do Twojego systemu.

Plan Instytucja obejmuje też 25 miejsc dla zespołu, eksport do 200 000 wierszy miesięcznie i umowę powierzenia przetwarzania. Pełne porównanie limitów jest w cenniku.

Skąd pochodzą dane w API

Ruchy wyliczamy z publicznych rejestrów: odpisów z KRS, sprawozdań finansowych z eKRS, wykazu podatników VAT i raportów bieżących spółek giełdowych. Każdy rekord ma adres źródła, więc odbiorca może sprawdzić zdarzenie u źródła przed publikacją albo decyzją. Szczegóły opisujemy na stronie o źródłach danych.

Szacowana wartość udziałów jest przedziałem liczonym z ostatniego sprawozdania i mnożnika branżowego. Nie opisuje całego majątku osoby. Osoba, której dotyczą dane, może zgłosić korektę albo sprzeciw, a po uwzględnionym sprzeciwie jej profil przestaje być publiczny, także w API.

Najczęstsze pytania