Δημιουργία λιστών εταιρειών
Φίλτραρε εταιρείες ανά κλάδο, περιοχή, μέγεθος και άλλα με την Αναζήτηση & Εξαγωγή.
Το search-organizations βρίσκει εταιρείες με βάση τα χαρακτηριστικά τους αντί για την επωνυμία. Συνδυάζεις φίλτρα, ταξινομείς κατά δείκτες και περιηγείσαι στα αποτελέσματα. Για να πάρεις τη λίστα ως αρχείο, την εξάγεις στην εφαρμογή web.
Συνδυασμός φίλτρων
Τα φίλτρα μπαίνουν στην παράμετρο filters ως αντικείμενο JSON. Όλα τα φίλτρα ισχύουν μαζί. Αν δώσεις πολλές τιμές σε ένα φίλτρο, αρκεί να ταιριάζει μία από αυτές.
curl -G "https://handelsregister.ai/api/v1/search-organizations" \ -H "x-api-key: YOUR_API_KEY" \ --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": "YOUR_API_KEY"}, 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": "YOUR_API_KEY" }, }); 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}
| Χαρακτηριστικό | Φίλτρο |
|---|---|
| Περιοχή |
state, county, city, postal_code· ακτίνα με location_coordinates και location_max_distance_km |
| Κλάδος |
industry_code, ένας πενταψήφιος κωδικός της WZ 2025 όπως 62.10.1, και ως λίστα |
| Νομική μορφή |
legal_form_code, όπως GmbH, AG ή UG (haftungsbeschränkt) |
| Κατάσταση |
status (ACTIVE, INSOLVENT …) ή active (true, false) |
| Μέγεθος |
company_size_category με βάση τον ισολογισμό, emp_size_category με βάση τους εργαζομένους: micro, small, medium, large |
| Δείκτες |
financial_filters με εύρη, όπως {"emp_count": {"gte": 50}} |
| Εγγραφή |
registration_date_from, registration_date_to |
| Από Pro |
owner_filters, ownership_filters, executive_filters, lifecycle_filters: εταίροι, δομή ιδιοκτησίας, διοίκηση, αφερεγγυότητα |
Όλα τα φίλτρα με τις τιμές τους αναφέρονται στο search-organizations. Το total είναι συνήθως ένα άνω όριο του πλήθους αποτελεσμάτων. Από 10.000 αποτελέσματα και πάνω, είναι εκτίμηση.
Ταξινόμηση
Με τα sort και order ορίζεις τη σειρά, για παράδειγμα κατά κύκλο εργασιών, εργαζομένους, σύνολο ενεργητικού ή ημερομηνία εγγραφής. Οι εταιρείες χωρίς την τιμή έρχονται τελευταίες. Το παράδειγμα αναζητά GmbH με τουλάχιστον 50 εργαζομένους στην περιφερειακή ενότητα και ταξινομεί κατά κύκλο εργασιών.
curl -G "https://handelsregister.ai/api/v1/search-organizations" \ -H "x-api-key: YOUR_API_KEY" \ --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": "YOUR_API_KEY"}, 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": "YOUR_API_KEY" }, }); 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}
Με match_context=1, κάθε αποτέλεσμα δείχνει στο _match_context γιατί ταιριάζει, για δείκτες με το έτος της τιμής. Αυτό έχει σημασία γιατί οι πιο πρόσφατες καταστάσεις κάθε εταιρείας μπορεί να είναι από διαφορετικό έτος. Το αποτέλεσμα δεν περιέχει τον ίδιο τον κύκλο εργασιών· τον ανακτάς με financial_kpi μέσω του fetch-organization.
Χωρίς sort, μια αναζήτηση με q ταξινομεί κατά συνάφεια. Για καθαρά ερωτήματα φίλτρων, όρισε το sort όταν μετράει η σειρά.
Περιήγηση στα αποτελέσματα
Το limit ορίζει πόσα αποτελέσματα έχει μια σελίδα, το πολύ 30. Το skip παραλείπει αποτελέσματα: η δεύτερη σελίδα ξεκινά με skip ίσο με limit.
curl -G "https://handelsregister.ai/api/v1/search-organizations" \ -H "x-api-key: YOUR_API_KEY" \ --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": "YOUR_API_KEY"}, 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": "YOUR_API_KEY" }, }); 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}
Κάθε σελίδα κοστίζει 1 πίστωση, ακόμη και μια σελίδα χωρίς αποτελέσματα. Γι’ αυτό οι μεγάλες σελίδες είναι οι φθηνότερες ανά εταιρεία.
Μια αναζήτηση φτάνει έως το αποτέλεσμα αριθμός 10.000. Για μεγαλύτερα σύνολα, χώρισέ τη, για παράδειγμα ανά κρατίδιο, ταχυδρομικό κώδικα ή περίοδο εγγραφής.
Εξαγωγή της λίστας
Ένα αρχείο το λαμβάνεις στην εφαρμογή web: στην Αναζήτηση & Εξαγωγή, όρισε τα φίλτρα και επίλεξε «Εξαγωγή». Η εξαγωγή επιστρέφει έως 5.000 εταιρείες ως CSV, XLSX ή JSON.
Πριν ξεκινήσει, βλέπεις το άνω όριο και το κόστος. Η εξαγωγή παραλείπει εταιρείες χωρίς δημοσιευμένη διεύθυνση· κατόπιν αιτήματος τις περιλαμβάνει. Το έτοιμο αρχείο το βρίσκεις στο Λογαριασμός › Εξαγωγές.
Η εξαγωγή διαβάζει τα αποτελέσματα μόνο όταν εκτελείται. Έτσι περιλαμβάνονται οι μεταβολές έως εκείνη τη στιγμή. Μέσω του API, δημιουργείς την ίδια λίστα σελίδα προς σελίδα όπως φαίνεται παραπάνω.
Συνήθεις παγίδες
- Γράψε τις τιμές ακριβώς: το
statusμε κεφαλαία, τοregistration_numberχωρίς «HRB», τους κωδικούς κλάδου με πέντε ψηφία. Άγνωστες τιμές επιστρέφουν 0 αποτελέσματα, και η σελίδα χρεώνεται παρ’ όλα αυτά. - Φίλτρα από Pro: Το
owner_filtersκαι τα άλλα φίλτρα Pro χρειάζονται συνδρομή πιστώσεων Pro ή Max. Διαφορετικά το API απαντά με HTTP 403, χωρίς κόστος. - Αριθμός μητρώου στον όρο αναζήτησης: Το
qψάχνει επωνυμίες. Για αριθμό μητρώου, χρησιμοποίησε τα φίλτραregistration_authority_nameκαιregistration_number. - Κενό q: Ένα κενό
q=επιστρέφει HTTP 400. Παράλειψε τοqόταν μόνο φιλτράρεις.