GRATIS le prime 100 chiamate/giorno
Erogazione :
Immediata
a partire da € 0,00 + iva Ottieni in tempo reale elenchi di imprese italiane con dati arricchiti selezionando tra oltre 15 parametri.
Search Company consente di creare una lista di aziende presenti all’interno di una zona geografica o provincia o CCIAA e selezionando parametri come fatturato, Codice ATECO, numero dipendenti
Search Company è 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 Search sono:
Questi parametri possono essere combinati liberamente per ottenere un elenco di contatti aziendali più pertinente.
Inoltre, utilizzando 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:
Search è identificato dall’endpoint: GET https://company.openapi.com/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
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.
Search viene utilizzato ad esempio per indagini e analisi di mercato settoriale o per attività di marketing.