Cerca Imprese Advance permette, a partire da una serie parametri, di ricercare tutte le aziende corrispondenti a quei criteri.

Cerca Imprese Advance non è da confondere con l’omonimo Cerca Impresa Advance Partita IVA che invece offre informazioni più dettagliate ma solo su un’unica azienda.

I parametri utilizzabili per le richieste del Cerca Imprese Advance sono:

• Denominazione sociale (o parte dei termini in essa presente), 
• provincia
• Codice ATECO
• Camera di Commercio
• REA
• Fatturato (min. / max.)
• Dipendenti (min. / max.) 
• Longitudine e Latitudine e Raggio

Il Cerca Imprese Advance è identificato dall’endpoint: GET https://imprese.openapi.it/advance

ESEMPIO RICHIESTA GET /Advance

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

• la provincia di Roma
• codice ATECO 62.01
• fatturato minimo 500.000 e massimo 2.000.000
• dipendenti minimo 5 e massimo 20 

https://imprese.openapi.it/advance?provincia=RM&codice_ateco=6201&cciaa=RM&fatturato_min=500000&fatturato_max=2000000&dipendenti_min=5&dipendenti_max=20

 
ESEMPIO RISPOSTA GET /Advance

La risposta restituisce un elenco di aziende compatibili con i parametri indicati e con i seguenti dati:

• Codice Fiscale
• Denominazione
• Partita IVA
• Sede Legale (toponimo, via, indirizzo, comune, frazione, provincia, CAP)
• Stato Attività
• Timestamp (data ed orario della richiesta)
• Timestamp creation (data creazione azienda in database)
• Timestamp last update (data ultima variazione dell’impresa)
• Codice Natura Giuridica
• Timestamp_creation
• Coordinate Geografiche Sede Legale (longitudine e latitudine)
• Data iscrizione alla Camera di Commercio
• Identificativo azienda interno (ID)

Questa è un esempio di riposta: 

{
   "data": [
    {
     "cf": "12485671007",
     "denominazione": "ALTRAVIA SERVIZI SOCIETA' A RESPONSABILITA' 		
     LIMITATA",
     "piva": "12485671007",
     "toponimo": "VIALE",
     "via": "F TOMMASO MARINETTI",
     "civico": "221",
     "indirizzo": "F TOMMASO MARINETTI, 221",
     "comune": "ROMA",
     "frazione":  null,
     "provincia": "RM",
     "stato_attivita": "ATTIVA",
     "timestamp": 1622452306,
     "timestamp_creation": 1622452306,
     "timestamp_last_update": 1622452306,
     "cap": "00143",
     "id": "60b4a85585e34e615c569ef5"
     "gps": {
     "coordinates": [
       12.47843,
       41.8071
      ]
     }  
    },
    {
     "cf": "05526560874",
     "denominazione": "ALTRAVIA - SOCIETA' A RESPONSABILITA' LIMITATA SEMPLIFICATA' 		
     LIMITATA",
     "piva": "05526560874",
     "toponimo": "VIA",
     "via": "DELLE SCALE",
     "civico": "10/18",
     "indirizzo": "DELLE SCALE 10/18",
     "comune": "CATANIA",
     "frazione":  null,
     "provincia": "CT",
     "stato_attivita": "ATTIVA",
     "timestamp": 1622452306,
     "timestamp_creation": 1622452306,
     "timestamp_last_update": 1622452306,
     "cap": "95129",
     "codice_destinatario": ".....",
     "id": "60b4a85585e34e615c569ef8"
     "gps": {
      "coordinates": [
       12.47843,
       41.8071
     ]
    }
  },
 ] 
 "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”. 

Per prevenire eventuali errori il servizio prevede inoltre un limite massimo di risultati di default: 100 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 100 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 150 aziende come risultato, la prima chiamata consentirà di ottenerne le prime 100, la seconda, in cui verrà indicato il parametro skip ed il valore 100 (quindi di saltare le prime 100 già ottenute con la prima chiamata), permetterà di ottenere le restanti 50.

Cerca Imprese Advance viene utilizzato ad esempio per indagini e analisi di mercato settoriale o per attività di marketing.

Con il Cerca Imprese Advance è possibile ottenere sia la partita IVA che l'ID aziende che potranno essere utili per poi procedere alla chiamata del Cerca Imprese Advance P.IVA ed ottenere ulteriori informazioni come ad esempio: REA, CCIAA, PEC, Codice Destinatario, Codice e Descrizione ATECO, Bilanci, Utili e dipendenti.

Altri Endpoint del Service Cerca Imprese

Il service Cerca Imprese Advance appartiene al service Cerca Imprese dove sono disponibili ulteriori endpoint per ottenere altre informazioni sulle aziende italiane:

• Cerca Imprese Advance Partita IVA per ottenere informazioni dettagliate su un’azienda
• Cerca Imprese Attiva/Chiusa per verificare lo stato di un’azienda
• Cerca Imprese Autocomplete per ottenere un elenco di nomi di aziende a partire da una ricerca parole
• Cerca Imprese Base per ottenere informazioni specifiche sulle aziende italiane
• Cerca Imprese Forma Giuridica per ottenere l'elenco e il codice di tutte le forme giuridiche d'impresa
• Cerca Imprese Gruppo IVA per verificare se un'impresa appartiene ad Gruppo IVA
• Cerca Imprese PEC per scoprire la PEC di un’azienda
• Cerca Imprese Soci per ottenere l’elenco dei soci di un’impresa
• Cerca Imprese Updates per avere l'elenco di tutti gli id delle aziende per cui sono state registrate delle modifiche