Firmensuche - Italien

Firmensuche ist ein leistungsstarkes und effektives Suchwerkzeug und ermöglicht es, anhand von über 15 Parametern eine Liste aller Unternehmen zu erhalten, die diesen Kriterien entsprechen.

Die verfügbaren Parameter für die Suchanfragen sind:

Diese Parameter können beliebig kombiniert werden, um eine relevantere Liste von Unternehmenskontakten zu erhalten.

Zusätzlich ermöglicht es Search, Unternehmen zu identifizieren, bei denen eine Person oder eine juristische Person Gesellschafter ist, indem einfach die Steuernummer als Referenz verwendet wird.

Ein weiteres interessantes Feature ist der Parameter "dataEnrichment", der es ermöglicht, den gewünschten Datensatztyp in der Antwort anzugeben:

Search ist über den Endpunkt identifiziert: GET https://company.openapi.com/IT-search .

BEISPIELANFRAGE

GET /IT-search

Dies ist ein Beispiel für einen Aufruf, bei dem die folgenden Parameter verwendet wurden:

https://company.openapi.com/IT-Search?dataEnrichment=start&province=RM&atecoCode=6201&cciaa=RM&minTurnover=500000&maxTurnover=2000000&minEmployees=5&maxEmployees=20

BEISPIELANTWORT

GET /IT-search

Die Antwort gibt eine Liste von Unternehmen zurück, die mit den angegebenen Parametern und dem ausgewählten Datensatz (Start) übereinstimmen:

Diese Antwort dient als Beispiel und die Daten entsprechen nicht den in der Anfrage angegebenen Parametern:

{
"data": [
  {
    "taxCode": "12485671007",
    "companyName": "OPENAPI S.R.L.",
    "vatCode": "12485671007",
    "address":{
      "registeredOffice": {
      "toponym": "VIALE",
      "street": "F TOMMASO MARINETTI",
      "streetNumber": "221",
      "streetName": "VIALE F TOMMASO MARINETTI 221",
      "town": "ROM",
      "hamlet":  null,
      "province": "RM",
      "zipCode": "00143",
      "gps": {
        "coordinates": [
          12.47843,
          41.8071
       ]
      },
      "townCode": "H501"
    }
  },
  "activityStatus": "AKTIV",
  "creationTimestamp": 1676878023,
  "lastUpdateTimestamp": 1676878023,
  "sdiCode": "MJ1OYNU",
  "sdiCodeTimestamp": 1624358855,
  "id": "60b4a85585e34e615c569ef5",
  "registrationDate": "2013-07-19"
  },
{
  "taxCode": "12345678910",
  "companyName": "OPENAPI TEST S.P.A.",
  "vatCode": "12345678910",
  "address":{
    "registeredOffice": {
    "toponym": "VIALE",
    "street": "ROM",
    "streetNumber": "221",
    "streetName": "VIALE ROM 221",
    "town": "ROM",
    "hamlet":  null,
    "province": "RM",
    "zipCode": "00143",
      "gps": {
        "coordinates": [
         13.47866,
          41.9072
        ]
      },
      "townCode": "H501",
    }
  },
  "activityStatus": "REGISTRIERT",
  "creationTimestamp": 1676878023,
  "lastUpdateTimestamp": 1676878023,
  "sdiCode": "USAL8PV",
  "sdiCodeTimestamp": 1624358855,
  "id": "45d1bfc788174b9u092cdtr5",
  "registrationDate": "2016-08-29"
    }
 ],
 "success":  true,
 "message": "",
 "error":  null
 }

Die Kosten werden basierend auf der Anzahl der Unternehmen in der Antwort berechnet, und es ist möglich, vor der Anfrage die Anzahl der verfügbaren Ergebnisse über den Parameter “dry_run” abzurufen.

Die Suche ohne Parameter oder mit dem Parameter dry run hat eine freie Anzahl von Anfragen pro Tag von 100. Übersteigt diese Grenze, beträgt die Kosten 0,01€ pro Anfrage.

Um mögliche Fehler zu vermeiden, sieht der Dienst auch ein Standardergebnislimit vor: 1000 Ergebnisse. Die Anzahl der Ergebnisse kann weiter durch den Parameter “limit” reduziert werden, bei dem die gewünschte Anzahl an Ergebnissen angegeben wird.

Wenn die Antwort mehr als 1000 Unternehmen enthält, können alle Ergebnisse durch mehrere Anfragen und den Parameter “skip” abgerufen werden, der die Anzahl der zu “überspringenden” Ergebnisse angibt.

Praktisch bedeutet dies, dass bei einer Anfrage von 1500 Unternehmen das erste Aufruf die ersten 1000 Ergebnisse liefert. Der zweite Aufruf, bei dem der Parameter skip mit dem Wert 1000 (also das Überspringen der ersten 1000, die bereits im ersten Aufruf erhalten wurden) angegeben wird, liefert die verbleibenden 500.

Die Suche wird beispielsweise für Marktanalysen und -untersuchungen oder für Marketingaktivitäten verwendet.