Szybki start

Twój pierwszy profil firmy w pięć minut.

Potrzebujesz konta i terminala. Na końcu będziesz mieć pobrany profil firmy Hetzner Online GmbH z przykładowego zapytania i będziesz wiedzieć, co zawiera odpowiedź.

Skopiuj klucz API

Załóż bezpłatne konto i potwierdź adres e-mail. Dostajesz 150 kredytów startowych, ważnych przez 30 dni.

Twój pierwszy klucz API czeka już w Konto › Klucze API. Skopiuj go i traktuj jak hasło.

Każde zapytanie wysyła klucz w nagłówku x-api-key. W przykładach w jego miejscu stoi TWOJ_KLUCZ_API.

Jeśli API odpowiada 401, brakuje klucza albo nie został skopiowany w całości. Przy 403 twój adres e-mail nie jest jeszcze potwierdzony. Link potwierdzający znajdziesz w skrzynce odbiorczej.

Pobierz profil firmy

Wywołaj fetch-organization i przekaż nazwę firmy w parametrze q. Bez dalszych parametrów dostajesz dane podstawowe za 5 kredytów.

Skopiuj zapytanie, wstaw swój klucz i uruchom je. cURL wypisuje JSON od razu. W Pythonie i JavaScripcie odpowiedź jest potem w data. Przez print(data["name"]) lub console.log(data.name) zobaczysz nazwę firmy.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: TWOJ_KLUCZ_API" \
  --data-urlencode 'q=Hetzner Online GmbH'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "TWOJ_KLUCZ_API"},
    params={
        "q": "Hetzner Online GmbH",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "Hetzner Online GmbH");

const response = await fetch(url, {
  headers: { "x-api-key": "TWOJ_KLUCZ_API" },
});
const data = await response.json();

Odczytaj odpowiedź

Odpowiedź to profil firmy jako JSON. Te pola są potrzebne najczęściej:

Odczytaj odpowiedź
Pole	Znaczenie
entity_id	Identyfikator firmy w handelsregister.ai. Zapisz go do kolejnych zapytań.
name, legal_form, status	Nazwa firmy, forma prawna i status w rejestrze, w przykładzie `ACTIVE`.
registration	Sąd rejestrowy, typ rejestru i numer rejestru, w przykładzie Ansbach HRB 6089.
address, seat	Adres firmy ze współrzędnymi oraz siedziba według rejestru.
purpose, industry_classification	Przedmiot działalności i branża według WZ 2008 i WZ 2025.
representation_scheme	Zasady reprezentacji: `current` obowiązuje dziś, `history` pokazuje każdy wpisany stan.
meta	Ile kosztowało zapytanie (`request_credit_cost`) i twoje saldo po nim (`credits_remaining`).

1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "status": "ACTIVE",5  "legal_form": "GmbH",6  "registration": {7    "court": "Ansbach",8    "register_type": "HRB",9    "register_number": "6089"10  },11  "industry_classification": {12    "WZ2008": [13      {14        "code": "62.01.0",15        "label": "Erbringung von Dienstleistungen der Informationstechnologie"16      },17      {18        "code": "63.11.0",19        "label": "Datenverarbeitung, Hosting und damit verbundene Tätigkeiten"20      },21      {22        "code": "61.90.0",23        "label": "Telekommunikation, sonstige"24      }25    ],26    "WZ2025": [27      {28        "code": "62.20.1",29        "label": "Erbringung von Beratungsleistungen auf dem Gebiet der Informationstechnologie"30      },31      {32        "code": "46.50.1",33        "label": "Großhandel mit Datenverarbeitungsgeräten, peripheren Geräten und Software"34      },35      {36        "code": "62.90.0",37        "label": "Erbringung von sonstigen Dienstleistungen der Informationstechnologie"38      }39    ]40  },41  "address": {42    "house_number": "25",43    "street": "Industriestraße",44    "postal_code": "91710",45    "city": "Gunzenhausen",46    "county": "Weißenburg-Gunzenhausen",47    "state": "Bayern",48    "country": "DEU",49    "coordinates": {50      "latitude": 49.12483,51      "longitude": 10.7805252    }53  },54  "seat": {55    "city": "Gunzenhausen"56  },57  "registration_date": null,58  "representation_scheme": {59    "current": [60      "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."61    ],62    "history": [63      {64        "value": [65          "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."66        ],67        "effective_from": "2002-10-15",68        "effective_to": "2015-07-28"69      },70      {71        "value": [72          "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."73        ],74        "effective_from": "2015-07-28",75        "effective_to": null76      }77    ]78  },79  "purpose": "Die Durchführung von Internet- und Netzwerkdienstleistungen, das Erstellen und Vertreiben von Software, der Handel mit Hard- und Software, der Betrieb einer Werbeagentur,darüber hinaus der Im- und Export von Waren aller Art, soweit sie keiner Einfuhr- oder Ausfuhrbeschränkung unterliegen und soweit keine Genehmigungen erforderlich sind.",80  "meta": {81    "request_credit_cost": 5,82    "credits_remaining": 14583  }84}

200 · Przykładowa odpowiedź dla Hetzner Online GmbH, tylko dane podstawowe

Z entity_id odpytasz później tę samą firmę bezpośrednio. To także klucz dla fetch-document i Signals. Sąd rejestrowy i numer rejestru są równie jednoznaczne, w przykładzie Ansbach HRB 6089.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: TWOJ_KLUCZ_API" \
  --data-urlencode 'q=94eb910fef13f94585c48c263fa446d4'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "TWOJ_KLUCZ_API"},
    params={
        "q": "94eb910fef13f94585c48c263fa446d4",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "94eb910fef13f94585c48c263fa446d4");

const response = await fetch(url, {
  headers: { "x-api-key": "TWOJ_KLUCZ_API" },
});
const data = await response.json();

Co dalej

Dodaj features Członkowie zarządu, wspólnicy lub finanse w tym samym zapytaniu. Pobierz firmę po numerze rejestru Jednoznaczna droga przez sąd rejestrowy, numer rejestru i entity_id. Podstawowe pojęcia Jak działają kredyty, tryb czasu rzeczywistego, historia i puste wartości. Plugin ChatGPT Te same dane w czacie, bez kodu. Python SDK API w Pythonie, z gotowymi metodami. Node SDK API w JavaScripcie i TypeScripcie.