Company Search - Italia

Company Search è un potente ed efficace strumento di ricerca e consente, a partire da oltre 15 parametri, di ottenere la lista di tutte le aziende corrispondenti a quei criteri.

I parametri disponibili per le richieste di Company Search sono:

Questi parametri possono essere combinati liberamente per ottenere un elenco di contatti aziendali più pertinente.

Inoltre, utilizzando Company Search, è possibile identificare le aziende in cui un individuo o un'entità legale è socio, utilizzando semplicemente il codice fiscale come riferimento.

Un altro aspetto interessante è il parametro "dataEnrichment", che consente di specificare il tipo di dataset desiderato nella risposta:

Company Search è identificato dall’endpoint: GET https://company.openapi.com/IT-search .

ESEMPIO RICHIESTA

GET /IT-search

Questo è un esempio di chiamata in cui sono stati utilizzati i seguenti parametri:

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

ESEMPIO RISPOSTA

GET /IT-search

La risposta restituisce un elenco di aziende compatibili con i parametri indicati e il dataset selezionato (start):

Questa risposta è a titolo di esempio ed i dati non sono corrispondenti ai parametri indicati nella richiesta: 

{
"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": "ROMA",
      "hamlet":  null,
      "province": "RM",
      "zipCode": "00143",
      "gps": {
        "coordinates": [
          12.47843,
          41.8071
       ]
      },
      "townCode": "H501"
    }
  },
  "activityStatus": "ATTIVA",
  "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": "ROMA",
    "streetNumber": "221",
    "streetName": "VIALE ROMA 221",
    "town": "ROMA",
    "hamlet":  null,
    "province": "RM",
    "zipCode": "00143",
      "gps": {
        "coordinates": [
         13.47866,
          41.9072
        ]
      },
      "townCode": "H501",
    }
  },
  "activityStatus": "REGISTRATA",
  "creationTimestamp": 1676878023,
  "lastUpdateTimestamp": 1676878023,
  "sdiCode": "USAL8PV",
  "sdiCodeTimestamp": 1624358855,
  "id": "45d1bfc788174b9u092cdtr5",
  "registrationDate: "2016-08-29"
    }
 ],
 "success":  true,
 "message": "",
 "error":  null
 }

Il costo viene addebitato in base al numero delle imprese presenti nella risposta ed è possibile prima di effettuare la chiamata avere il conteggio dei risultati disponibili tramite il parametro “dry_run”. 

La ricerca senza parametro o con parametro dry run ha un numero di richieste gratuite al giorno pari a 100, superate quel limite il costo sarà pari a 0,01€ a richiesta.

Per prevenire eventuali errori il servizio prevede inoltre un limite massimo di risultati di default: 1000 risultati. È possibile ridurre ulteriormente il numero di risultati con il parametro “limit” dove verrà appunto indicato il numero di risultati desiderati.

Nel caso la risposta preveda oltre 1000 aziende è possibile ottenere tutti i risultati con più chiamate e tramite il parametro “skip” che indica il numero di risultati che devono essere “saltati”. In pratica, se per una richiesta sono previste 1500 aziende come risultato, la prima chiamata consentirà di ottenerne le prime 1000, la seconda, in cui verrà indicato il parametro skip ed il valore 1000 (quindi di saltare le prime 1000 già ottenute con la prima chiamata), permetterà di ottenere le restanti 500.

Company Search viene utilizzato ad esempio per indagini e analisi di mercato settoriale o per attività di marketing.