Il servizio Autocomplete è un service che da una specifica stringa di ricerca testuale, query, fornisce in tempo reale una serie di risultati pertinenti di aziende.

Autocomplete consente di effettuare una ricerca su un database di oltre 15 mln di aziende italiane in tempo reale e geolocalizzarla in un raggio definito.

I parametri di ricerca sono:

• query (il termine da cercare)
• modalità di ricerca del termine: inizia (start), contiene (contain), finisce (end with)
• coordinate geografiche latitudine e longitudine
• raggio

Il carattere speciale '*' può essere utilizzato come carattere jolly per cercare stringhe che iniziano, contengono o terminano con la query specificata.

ESEMPIO DI CHIAMATA GET /autocomplete

Un esempio di chiamata è il seguente:

https://imprese.openapi.it/autocomplete/openapi%2A?lat=13.5478&lng=42.859&radius=10000

Questo è un esempio di richiesta con i seguenti parametri:

• inizia con query openapi
• latitudine 13.5478
• longitudine 42.859
• raggio 10000 metri

ESEMPIO DI RISPOSTA  GET /autocomplete

La risposta rispetto alla richiesta precedente presenta 3 risultati con denominazione dell’azienda che inizia con openapi e che è presente nell’arco di 10.000 metri dal punto identificato dalla latitudine 13.5478 e dalla longitudine 42.859.

{
  "data": [
    {
      "id": "60bf66ea35a4c0041e84826c",
      "denominazione": "OPENAPI SRL"
    },
    {
      "id": "56bf66ea35a4c0021e84826f",
      "denominazione": "OPENAPI PLATFORM SPA"

    },
    {
      "id": "47bf66ea35a4c0051e84826f",
      "denominazione": "OPENAPI HOLDING" 
    }
  ],
  "success": true,
  "message": "",
  "error": null
}

Il risultato restituirà oltre alla denominazione sociale anche l'ID azienda. Questo identificativo potrà essere utilizzato come parametro per altri endpoint del service Cerca Imprese come ad esempio il Base e l'Advance per ottenere informazioni dettagliate delle società come Partita IVA, PEC, Fatturato, Ateco, Soci, etc.

Il service autocomplete è stato scelto da centinaia di aziende per ottimizzare il form di ricerca. Infatti l’integrazione di Autocomplete consente di offrire suggerimenti mentre il cliente digita, anche prima di premere il pulsante di ricerca. Il cliente può scegliere uno qualsiasi dei suggerimenti di completamento automatico dall'elenco a discesa ed essere indirizzato alla pagina dei risultati senza dover inserire manualmente ogni carattere nel campo.

Altri Endpoint del Service Cerca Imprese

Il service Cerca Imprese permette attraverso altri endpoint di ottenere informazioni aziendali:

• Cerca Imprese Base per ottenere informazioni specifiche sulle aziende italiane
• Cerca Imprese PEC per scoprire la PEC di un’azienda
• Cerca Imprese Attiva/Chiusa per verificare lo stato di un’azienda
• Cerca Imprese Soci per ottenere l’elenco dei soci di un’impresa
• Cerca Imprese Gruppo IVA per verificare se un'impresa appartiene ad Gruppo IVA
• Cerca Imprese Advance (Elenco) per ottenere un elenco di imprese in base ad una serie di parametri come codice ateco, fatturato, cciaa, dipendenti
• Cerca Imprese Advance Partita IVA per ottenere informazioni dettagliate su un’azienda
• Cerca Imprese Updates per avere l'elenco di tutti gli id delle aziende per cui sono state registrate delle modifiche
• Cerca Imprese Forma Giuridica per ottenere l'elenco e il codice di tutte le forme giuridiche d'impresa