Constituer des listes d’entreprises

Filtrer les entreprises par secteur, région, taille et plus encore avec Recherche & Export.

search-organizations trouve des entreprises par leurs caractéristiques plutôt que par leur nom. Tu combines des filtres, tries par indicateurs et parcours les résultats page par page. Pour obtenir la liste sous forme de fichier, tu l’exportes dans l’application web.

Combiner des filtres

Les filtres se placent dans le paramètre filters sous forme d’objet JSON. Tous les filtres s’appliquent ensemble. Si tu indiques plusieurs valeurs dans un filtre, il suffit que l’une d’elles corresponde.

curl -G "https://handelsregister.ai/api/v1/search-organizations" \
  -H "x-api-key: TA_CLE_API" \
  --data-urlencode 'filters={"legal_form_code":"GmbH","city":"Gunzenhausen","active":true}' \
  --data-urlencode 'limit=5'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/search-organizations",
    headers={"x-api-key": "TA_CLE_API"},
    params={
        "filters": "{\"legal_form_code\":\"GmbH\",\"city\":\"Gunzenhausen\",\"active\":true}",
        "limit": "5",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/search-organizations");
url.searchParams.append("filters", "{\"legal_form_code\":\"GmbH\",\"city\":\"Gunzenhausen\",\"active\":true}");
url.searchParams.append("limit", "5");

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

1{2  "results": [3    {4      "entity_id": "0100d4d86f3f26fceac3a833db59d700",5      "name": "Beyer Grundstücksverwaltungs-GmbH",6      "registration": {7        "court": "Ansbach",8        "register_type": "HRB",9        "register_number": "3635"10      },11      "address": {12        "house_number": "42",13        "street": "Nürnberger Str.",14        "postal_code": "91710",15        "city": "Gunzenhausen",16        "county": "Weißenburg-Gunzenhausen",17        "state": "Bayern",18        "country": "DEU",19        "coordinates": {20          "latitude": 49.11954,21          "longitude": 10.7591822        }23      },24      "seat": {25        "city": "Gunzenhausen"26      },27      "registration_date": "2003-04-15T00:00:00",28      "purpose": "Die Beteiligung als persönlich haftende Gesellschafterin an der Beyer Grundbesitz GmbH & Co. KG sowie die Geschäftsführung dieser Kommanditgesellschaft. Unternehmensgegenstand dieser Kommanditgesellschaft ist die Verwaltung eigenen Vermögens, insbesondere der Erwerb, die Verwaltung, die Bebauung und die Verwertung von Grundbesitz, jedoch mit Ausnahme von Tätigkeiten, die einer Genehmigung nach § 34 c GewO bedürfen.",29      "_match_context": [],30      "status_normalized": "ACTIVE"31    },32    {33      "entity_id": "0269de827eef8cae201195e4966886c3",34      "name": "Martin Bosch GmbH",35      "registration": {36        "court": "Ansbach",37        "register_type": "HRB",38        "register_number": "5034"39      },40      "address": {41        "house_number": "14 A",42        "street": "Auweg",43        "postal_code": "91710",44        "city": "Gunzenhausen",45        "county": "Weißenburg-Gunzenhausen",46        "state": "Bayern",47        "country": "DEU",48        "coordinates": {49          "latitude": 49.11129,50          "longitude": 10.7580151        }52      },53      "seat": {54        "city": "Gunzenhausen"55      },56      "registration_date": "2010-09-23T00:00:00",57      "purpose": "Gegenstand des Unternehmens ist - der Vertrieb und die Montage von Waren aller Art, insbesondere von Photovoltaikanlagen, Bauteilen nach DIN vorwiegend von Fenstern und Türen, - die Erbringung von Dienstleistungen und Vertriebsunterstützung im Bereich von Sport und Freizeitartikeln, - die Erbringung von Bauleistungen aller Art, insbesondere im Bereich Wohnbau, und zwar auch Leistungen im Sinne des § 34 c Abs. 1 Nr. 3. GewO, d.h. gewerbsmäßige Vorbereitung oder Durchführung von Bauvorhaben als Ba …",58      "_match_context": [],59      "status_normalized": "ACTIVE"60    },61    {62      "entity_id": "072223d1d792f9295175f80dded04545",63      "name": "König & Reuß Softwarelösungen GmbH",64      "registration": {65        "court": "Ansbach",66        "register_type": "HRB",67        "register_number": "5881"68      },69      "address": {70        "house_number": "6",71        "street": "Kirchenplatz",72        "postal_code": "91710",73        "city": "Gunzenhausen",74        "county": "Weißenburg-Gunzenhausen",75        "state": "Bayern",76        "country": "DEU",77        "coordinates": {78          "latitude": 49.11263,79          "longitude": 10.7553280        }81      },82      "seat": {83        "city": "Gunzenhausen"84      },85      "registration_date": "2014-07-15T00:00:00",86      "purpose": "Die Entwicklung und der Vertrieb von Software, die Organisationsberatung für EDV-Lösungen, EDV-Schulungen sowie der damit zusammenhängende An- und Verkauf von Hardware.",87      "_match_context": [],88      "status_normalized": "ACTIVE"89    },90    {91      "entity_id": "078582ddfc9526b6405289afa26b66f5",92      "name": "Wolfgang Seifert GmbH",93      "registration": {94        "court": "Ansbach",95        "register_type": "HRB",96        "register_number": "7369"97      },98      "address": {99        "house_number": "1",100        "street": "Brechhausstr.",101        "postal_code": "91710",102        "city": "Gunzenhausen",103        "county": "Weißenburg-Gunzenhausen",104        "state": "Bayern",105        "country": "DEU",106        "coordinates": {107          "latitude": 49.12887,108          "longitude": 10.7468109        }110      },111      "seat": {112        "city": "Gunzenhausen"113      },114      "registration_date": "2020-12-07T00:00:00",115      "purpose": "Die Ausführung von Isolierarbeiten sowie der Betrieb eines Getränkemarktes.",116      "_match_context": [],117      "status_normalized": "ACTIVE"118    },119    {120      "entity_id": "08764e95299e20f75f873d9497eab723",121      "name": "Zimmerei Ortner GmbH",122      "registration": {123        "court": "Ansbach",124        "register_type": "HRB",125        "register_number": "7994"126      },127      "address": {128        "house_number": "22",129        "street": "Hauptstr.",130        "postal_code": "91710",131        "city": "Gunzenhausen",132        "county": "Weißenburg-Gunzenhausen",133        "state": "Bayern",134        "country": "DEU",135        "coordinates": {136          "latitude": 49.10797,137          "longitude": 10.73341138        }139      },140      "seat": {141        "city": "Gunzenhausen"142      },143      "registration_date": "2022-12-19T00:00:00",144      "purpose": "Der Betrieb einer Zimmerei sowie die Durchführung von Dachdeckerarbeiten, Trockenbauarbeiten und Holzbauarbeiten aller Art.",145      "_match_context": [],146      "status_normalized": "ACTIVE"147    }148  ],149  "total": 239,150  "total_exact": false,151  "total_relation": "upper_bound",152  "meta": {153    "request_credit_cost": 1,154    "credits_remaining": 145155  }156}

200 · Exemple de réponse : GmbH actives à Gunzenhausen

Caractéristique
Caractéristique	Filtre
Région	`state`, `county`, `city`, `postal_code` ; rayon avec `location_coordinates` et `location_max_distance_km`
Secteur	`industry_code`, un code à cinq chiffres de la WZ 2025 comme `62.10.1`, aussi sous forme de liste
Forme juridique	`legal_form_code`, comme `GmbH`, `AG` ou `UG (haftungsbeschränkt)`
Statut	`status` (`ACTIVE`, `INSOLVENT` …) ou `active` (true, false)
Taille	`company_size_category` selon le bilan, `emp_size_category` selon les salariés : `micro`, `small`, `medium`, `large`
Indicateurs	`financial_filters` avec des plages, comme `{"emp_count": {"gte": 50}}`
Inscription	`registration_date_from`, `registration_date_to`
À partir de Pro	`owner_filters`, `ownership_filters`, `executive_filters`, `lifecycle_filters` : associés, structure de détention, direction, insolvabilité

Tous les filtres avec leurs valeurs figurent sous search-organizations. total est généralement une borne supérieure du nombre de résultats. À partir de 10 000 résultats, c’est une estimation.

Trier

Avec sort et order, tu définis l’ordre, par exemple par chiffre d’affaires, salariés, total du bilan ou date d’inscription. Les entreprises sans cette valeur viennent en dernier. L’exemple recherche les GmbH d’au moins 50 salariés dans l’arrondissement et trie par chiffre d’affaires.

curl -G "https://handelsregister.ai/api/v1/search-organizations" \
  -H "x-api-key: TA_CLE_API" \
  --data-urlencode 'filters={"county":"Weißenburg-Gunzenhausen","legal_form_code":"GmbH","status":"ACTIVE","financial_filters":{"emp_count":{"gte":50}}}' \
  --data-urlencode 'sort=revenue' \
  --data-urlencode 'order=desc' \
  --data-urlencode 'limit=5' \
  --data-urlencode 'match_context=1'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/search-organizations",
    headers={"x-api-key": "TA_CLE_API"},
    params={
        "filters": "{\"county\":\"Weißenburg-Gunzenhausen\",\"legal_form_code\":\"GmbH\",\"status\":\"ACTIVE\",\"financial_filters\":{\"emp_count\":{\"gte\":50}}}",
        "sort": "revenue",
        "order": "desc",
        "limit": "5",
        "match_context": "1",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/search-organizations");
url.searchParams.append("filters", "{\"county\":\"Weißenburg-Gunzenhausen\",\"legal_form_code\":\"GmbH\",\"status\":\"ACTIVE\",\"financial_filters\":{\"emp_count\":{\"gte\":50}}}");
url.searchParams.append("sort", "revenue");
url.searchParams.append("order", "desc");
url.searchParams.append("limit", "5");
url.searchParams.append("match_context", "1");

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

1{2  "results": [3    {4      "entity_id": "94eb910fef13f94585c48c263fa446d4",5      "name": "Hetzner Online GmbH",6      "registration": {7        "court": "Ansbach",8        "register_type": "HRB",9        "register_number": "6089"10      },11      "address": {12        "house_number": "25",13        "street": "Industriestraße",14        "postal_code": "91710",15        "city": "Gunzenhausen",16        "county": "Weißenburg-Gunzenhausen",17        "state": "Bayern",18        "country": "DEU",19        "coordinates": {20          "latitude": 49.12483,21          "longitude": 10.7805222        }23      },24      "seat": {25        "city": "Gunzenhausen"26      },27      "registration_date": "2015-07-28T00:00:00",28      "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.",29      "_match_context": {30        "financial": {31          "emp_count": 340,32          "year": 202333        },34        "legal_form": {35          "name": "Gesellschaft mit beschränkter Haftung",36          "category": "capital_company",37          "liability_type": "limited"38        }39      },40      "status_normalized": "ACTIVE"41    },42    {43      "entity_id": "e937d0eb0d9b938afaae55808a066400",44      "name": "Auto Bierschneider GmbH",45      "registration": {46        "court": "Ansbach",47        "register_type": "HRB",48        "register_number": "3953"49      },50      "address": {51        "house_number": "23",52        "street": "Dettenheimer Str.",53        "postal_code": "91781",54        "city": "Weißenburg i. Bay.",55        "county": "Weißenburg-Gunzenhausen",56        "state": "Bayern",57        "country": "DEU",58        "coordinates": {59          "latitude": 49.00163,60          "longitude": 10.9519861        }62      },63      "seat": {64        "city": "Weißenburg i. Bay."65      },66      "registration_date": "2005-03-22T00:00:00",67      "purpose": "Die Reparatur und der Handel mit Kraftfahrzeugen aller Art.",68      "_match_context": {69        "financial": {70          "emp_count": 263,71          "year": 202472        },73        "legal_form": {74          "name": "Gesellschaft mit beschränkter Haftung",75          "category": "capital_company",76          "liability_type": "limited"77        }78      },79      "status_normalized": "ACTIVE"80    },81    {82      "entity_id": "7bde1c2520a00de2e67da1237163c629",83      "name": "Hasselbacher GmbH Metallrecycling",84      "registration": {85        "court": "Ansbach",86        "register_type": "HRB",87        "register_number": "3865"88      },89      "address": {90        "house_number": "24",91        "street": "Treuchtlinger Str.",92        "postal_code": "91781",93        "city": "Weißenburg i.Bay.",94        "county": "Weißenburg-Gunzenhausen",95        "state": "Bayern",96        "country": "DEU",97        "coordinates": {98          "latitude": 49.01128,99          "longitude": 10.95407100        }101      },102      "seat": {103        "city": "Weißenburg i. Bay."104      },105      "registration_date": "2004-10-05T00:00:00",106      "purpose": "Das Metallrecycling sowie der Schrott- und Metallgroßhandel.",107      "_match_context": {108        "financial": {109          "emp_count": 50,110          "year": 2024111        },112        "legal_form": {113          "name": "Gesellschaft mit beschränkter Haftung",114          "category": "capital_company",115          "liability_type": "limited"116        }117      },118      "status_normalized": "ACTIVE"119    },120    {121      "entity_id": "3d495cff8ca2f1e8e717d8ff1317f61d",122      "name": "KTX GmbH",123      "registration": {124        "court": "Ansbach",125        "register_type": "HRB",126        "register_number": "5941"127      },128      "address": {129        "house_number": "34",130        "street": "Dettenheimer Strasse",131        "postal_code": "91781",132        "city": "Weißenburg",133        "county": "Weißenburg-Gunzenhausen",134        "state": "Bayern",135        "country": "DEU",136        "coordinates": {137          "latitude": 49.00551,138          "longitude": 10.95048139        }140      },141      "seat": {142        "city": "Weißenburg"143      },144      "registration_date": "2014-11-24T00:00:00",145      "purpose": "Die Entwicklung von technischen Problemlösungen auf dem Gebiet der Kunststoffindustrie, die Herstellung, Weiterverarbeitung und der Vertrieb von Kunststoffartikeln aller Art, insbesondere, aber nicht nur, für die Automobilindustrie.",146      "_match_context": {147        "financial": {148          "emp_count": 664,149          "year": 2024150        },151        "legal_form": {152          "name": "Gesellschaft mit beschränkter Haftung",153          "category": "capital_company",154          "liability_type": "limited"155        }156      },157      "status_normalized": "ACTIVE"158    },159    {160      "entity_id": "c95348029f78b1a5162a365a46e772a3",161      "name": "GUTMANN GmbH",162      "registration": {163        "court": "Ansbach",164        "register_type": "HRB",165        "register_number": "3621"166      },167      "address": {168        "house_number": "57",169        "street": "Nürnberger Straße",170        "postal_code": "91781",171        "city": "Weißenburg",172        "county": "Weißenburg-Gunzenhausen",173        "state": "Bayern",174        "country": "DEU",175        "coordinates": {176          "latitude": 49.04067,177          "longitude": 10.96989178        }179      },180      "seat": {181        "city": "Weißenburg i. Bay."182      },183      "registration_date": "2003-03-19T00:00:00",184      "purpose": "Die Produktion von Erzeugnissen aller Art und der Handel und Vertrieb von Produkten aller Art; insbesondere die Be- und Verarbeitung von Metall, Holz und Kunststoff.",185      "_match_context": {186        "financial": {187          "emp_count": 356,188          "year": 2024189        },190        "legal_form": {191          "name": "Gesellschaft mit beschränkter Haftung",192          "category": "capital_company",193          "liability_type": "limited"194        }195      },196      "status_normalized": "ACTIVE"197    }198  ],199  "total": 36,200  "total_exact": false,201  "total_relation": "upper_bound",202  "meta": {203    "request_credit_cost": 1,204    "credits_remaining": 145205  }206}

200 · Exemple de réponse : les GmbH au plus fort chiffre d’affaires dans l’arrondissement de Weißenburg-Gunzenhausen

Avec match_context=1, chaque résultat indique sous _match_context pourquoi il correspond, pour les indicateurs avec l’année de la valeur. C’est important, car les derniers comptes de chaque entreprise peuvent dater d’une année différente. Le résultat ne contient pas le chiffre d’affaires lui-même ; tu le récupères avec financial_kpi via fetch-organization.

Sans sort, une recherche avec q trie par pertinence. Pour les requêtes uniquement filtrées, définis sort quand l’ordre compte.

Parcourir les résultats

limit définit combien de résultats compte une page, au plus 30. skip saute des résultats : la deuxième page commence à skip égal à limit.

curl -G "https://handelsregister.ai/api/v1/search-organizations" \
  -H "x-api-key: TA_CLE_API" \
  --data-urlencode 'filters={"legal_form_code":"GmbH","city":"Gunzenhausen","active":true}' \
  --data-urlencode 'limit=3' \
  --data-urlencode 'skip=3'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/search-organizations",
    headers={"x-api-key": "TA_CLE_API"},
    params={
        "filters": "{\"legal_form_code\":\"GmbH\",\"city\":\"Gunzenhausen\",\"active\":true}",
        "limit": "3",
        "skip": "3",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/search-organizations");
url.searchParams.append("filters", "{\"legal_form_code\":\"GmbH\",\"city\":\"Gunzenhausen\",\"active\":true}");
url.searchParams.append("limit", "3");
url.searchParams.append("skip", "3");

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

1{2  "results": [3    {4      "entity_id": "078582ddfc9526b6405289afa26b66f5",5      "name": "Wolfgang Seifert GmbH",6      "registration": {7        "court": "Ansbach",8        "register_type": "HRB",9        "register_number": "7369"10      },11      "address": {12        "house_number": "1",13        "street": "Brechhausstr.",14        "postal_code": "91710",15        "city": "Gunzenhausen",16        "county": "Weißenburg-Gunzenhausen",17        "state": "Bayern",18        "country": "DEU",19        "coordinates": {20          "latitude": 49.12887,21          "longitude": 10.746822        }23      },24      "seat": {25        "city": "Gunzenhausen"26      },27      "registration_date": "2020-12-07T00:00:00",28      "purpose": "Die Ausführung von Isolierarbeiten sowie der Betrieb eines Getränkemarktes.",29      "_match_context": [],30      "status_normalized": "ACTIVE"31    },32    {33      "entity_id": "08764e95299e20f75f873d9497eab723",34      "name": "Zimmerei Ortner GmbH",35      "registration": {36        "court": "Ansbach",37        "register_type": "HRB",38        "register_number": "7994"39      },40      "address": {41        "house_number": "22",42        "street": "Hauptstr.",43        "postal_code": "91710",44        "city": "Gunzenhausen",45        "county": "Weißenburg-Gunzenhausen",46        "state": "Bayern",47        "country": "DEU",48        "coordinates": {49          "latitude": 49.10797,50          "longitude": 10.7334151        }52      },53      "seat": {54        "city": "Gunzenhausen"55      },56      "registration_date": "2022-12-19T00:00:00",57      "purpose": "Der Betrieb einer Zimmerei sowie die Durchführung von Dachdeckerarbeiten, Trockenbauarbeiten und Holzbauarbeiten aller Art.",58      "_match_context": [],59      "status_normalized": "ACTIVE"60    },61    {62      "entity_id": "0a5cea0c9d3861d10d42f21c1d3f9816",63      "name": "TJ Gastro 3 GmbH",64      "registration": {65        "court": "Ansbach",66        "register_type": "HRB",67        "register_number": "8809"68      },69      "address": {70        "house_number": "111",71        "street": "Nürnberger Straße",72        "postal_code": "91710",73        "city": "Gunzenhausen",74        "county": "Weißenburg-Gunzenhausen",75        "state": "Bayern",76        "country": "DEU",77        "coordinates": {78          "latitude": 49.12861,79          "longitude": 10.7708280        }81      },82      "seat": {83        "city": "Gunzenhausen"84      },85      "registration_date": "2021-01-11T00:00:00",86      "purpose": "Der Betrieb von Restaurants entsprechend dem mit der McDonald´s Deutschland Inc., Zweigniederlassung München, und Herrn Dr. Konrad Exempelmann abgeschlossenen Franchise-Vertrag, dem die Gesellschaft beigetreten ist.",87      "_match_context": [],88      "status_normalized": "ACTIVE"89    }90  ],91  "total": 239,92  "total_exact": false,93  "total_relation": "upper_bound",94  "meta": {95    "request_credit_cost": 1,96    "credits_remaining": 14597  }98}

200 · Exemple de réponse : deuxième page des GmbH actives à Gunzenhausen, trois résultats par page

Chaque page coûte 1 crédit, même une page sans résultat. Les grandes pages sont donc les moins chères par entreprise.

Une recherche va jusqu’au résultat numéro 10 000. Pour des ensembles plus grands, découpe-la, par exemple par Land, code postal ou période d’inscription.

Exporter la liste

Tu obtiens un fichier dans l’application web : dans Recherche & Export, définis les filtres et choisis « Exporter ». L’export renvoie jusqu’à 5 000 entreprises en CSV, XLSX ou JSON.

Avant le démarrage, tu vois la borne supérieure et les coûts. L’export omet les entreprises sans adresse publiée ; sur demande, il les inclut. Tu trouveras le fichier terminé sous Compte › Exports.

L’export ne lit les résultats qu’au moment de son exécution. Les modifications jusqu’à ce moment sont donc incluses. Via l’API, tu construis la même liste page par page comme indiqué ci-dessus.

Pièges fréquents

Écrire les valeurs exactement : status en majuscules, registration_number sans « HRB », codes de secteur à cinq chiffres. Les valeurs inconnues renvoient 0 résultat, et la page est quand même facturée.
Filtres à partir de Pro : owner_filters et les autres filtres Pro nécessitent un abonnement de crédits Pro ou Max. Sinon, l’API répond HTTP 403, sans frais.
Numéro de registre dans le terme de recherche : q recherche des noms. Pour un numéro de registre, utilise les filtres registration_authority_name et registration_number.
q vide : un q= vide renvoie HTTP 400. Omets q quand tu ne fais que filtrer.

Ensuite

search-organizations Tous les filtres, options de tri et champs de la recherche. Playground Essayer des filtres et exporter la liste. Enrichir des données clients Ajouter des profils d’entreprise complets aux résultats. Récupérer un profil d’entreprise Récupérer directement un seul profil d’entreprise.