Jsonpage · SIREN- und SIRET-API

Firmendaten-API für Europa: 14 Länder, ein Format

Ihre Kunden und Lieferanten sitzen nicht alle im selben Land. Um sie zu prüfen, reicht eine nationale API nicht mehr.

01 / WARUM

Eine API pro Land, oder eine einzige

Jsonpage durchsucht die Unternehmen aus 14 Ländern mit denselben Routen und liefert überall denselben Datensatz. So funktioniert es, Land für Land, mit Beispielaufrufen.

Jedes Land hat sein Register, seine Nummer und sein Format: 9 Ziffern in Frankreich, 10 in Belgien, ein Code mit Endbuchstaben in Singapur. Einen Dienst pro Land anzubinden heißt ebenso viele Verträge, Antwortformate und Fehlerfälle.

Mit einer API für mehrere Länder kennt Ihr Code nur ein Format: Er liest dasselbe Feld status für ein norwegisches oder ein australisches Unternehmen, und ein neues Land erfordert keine Entwicklung.

Gut zu wissenEine Kennung pro Unternehmen: der Ländercode, ein Bindestrich und die nationale Nummer (FR-552032534, BE-0417497106). Dieselben Routen und dieselbe Antwort in allen 14 Ländern.
02 / LÄNDER

Die 14 Länder und ihre Kennungen

Die globale Kennung ist die nationale Nummer mit vorangestelltem Ländercode. Die üblichen Schreibweisen werden ebenfalls angenommen: mit oder ohne Leerzeichen, Punkte oder Bindestriche, und die USt-IdNr, wenn sie die Unternehmensnummer enthält.

LandNationale NummerKennung in der API
FrankreichSIREN, 9 ZiffernFR-552032534
BelgienUnternehmensnummer, 10 ZiffernBE-0417497106
SchweizUID (CHE), 9 ZiffernCH-101374515
Vereinigtes KönigreichCompany numberGB-00445790
IrlandCompany numberIE-104547
NorwegenOrganisationsnummer, 9 ZiffernNO-923609016
SchwedenOrganisationsnummer, 10 ZiffernSE-5560427220
FinnlandY-tunnusFI-01120389
EstlandRegistercode, 8 ZiffernEE-10137025
LettlandRegisternummer, 11 ZiffernLV-40003245752
LitauenCode, 9 ZiffernLT-110053842
AustralienABN, 11 ZiffernAU-51824753556
SingapurUENSG-196800306E
JapanUnternehmensnummer, 13 ZiffernJP-1180301018771
03 / SUCHE

Ein Unternehmen nach Namen suchen

Die Namenssuche funktioniert in einem Land, mit country, oder in allen Ländern zugleich. Exakte Namen kommen zuerst, danach aktive Unternehmen:

curl -H "X-API-Key: $JSONPAGE_API_KEY" \
  "https://api.jsonpage.com/v2/companies?q=equinor&country=NO"

Für ein Formular schlägt die Autocomplete-Route Unternehmen schon beim Tippen vor, mit demselben Länderfilter.

04 / DATENSATZ

Einen Datensatz lesen, in jedem Land

Mit der globalen Kennung liefert eine einzige Route den Datensatz:

curl -H "X-API-Key: $JSONPAGE_API_KEY" \
  "https://api.jsonpage.com/v2/companies/BE-0417497106"

Der Basisdatensatz ist in jedem Land gleich: Kennung, Name, Status, Rechtsform, Anschrift und Datum der letzten Aktualisierung. Einige Felder bleiben leer, wo das Land sie nicht veröffentlicht, etwa die Tätigkeit in Lettland oder die Straßenanschrift in Australien:

{
  "data": {
    "id": "BE-0417497106",
    "country": "BE",
    "registry_id": "0417497106",
    "name": "...",
    "status": "active",
    "legal_form": { "code": "...", "label": "..." },
    "address": { "postal_code": "...", "city": "...", "country": "BE" },
    "updated_at": "..."
  }
}
05 / NUMMER

Eine Nummer finden, ohne das Land zu kennen

Eine Nummer steht allein in einer Datei, ohne Land? Der Parameter registry_id sucht sie in allen Ländern und liefert die Unternehmen, die sie tragen:

curl -H "X-API-Key: $JSONPAGE_API_KEY" \
  "https://api.jsonpage.com/v2/companies?registry_id=923609016"
06 / PREIS

Der Preis hängt nicht vom Land ab

Alle Länder sind in jedem Tarif enthalten, auch im Entdecken-Tarif (kostenlos). Der Preis ist ein fester Monatstarif: keine Credits, kein Aufpreis für das Ausland. Alle Auswahlkriterien finden Sie im Vergleich der Firmendaten-APIs.

07 / HÄUFIGE FRAGEN

Häufige Fragen

Welche Länder deckt die API ab?+

Frankreich, Belgien, die Schweiz, das Vereinigte Königreich, Irland, Norwegen, Schweden, Finnland, Estland, Lettland, Litauen, Australien, Singapur und Japan.

Ist die Antwort in jedem Land gleich?+

Ja. Der Basisdatensatz hat überall dieselben Felder; ein Feld bleibt leer, wenn das Land die Angabe nicht veröffentlicht.

Brauche ich für das Ausland einen teureren Tarif?+

Nein. Alle Länder sind in allen Tarifen enthalten, auch im Entdecken-Tarif (kostenlos).

Kann ich in allen Ländern zugleich suchen?+

Ja: Ohne den Parameter country durchsucht die Namenssuche alle Länder, und registry_id sucht eine Nummer überall.

08 / VERWANDTE ARTIKEL

Weiterlesen

Sofort prüfen

Französischen Kunden prüfen

Geben Sie eine SIREN, eine SIRET oder den Namen eines französischen Unternehmens ein.

3 kostenlose Prüfungen pro Tag, ohne Konto.

AUSPROBIEREN

Testen Sie alle 14 Länder mit Ihrem Schlüssel

Der Entdecken-Tarif (kostenlos) braucht keine Kreditkarte und öffnet alle Routen und alle Länder.