Autocomplete è una funzionalità del servizio Search Company 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
• Codice Catastale
• CCCIA
• Codice ATECO
• Camera di Commercio
• REA
• Fatturato (min. / max.)
• Dipendenti (min. / max.)
• Codice Sdi
• Codice Forma Legale
• PEC
• Codice Fiscale socio

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

ESEMPIO DI RICHIESTA GET /IT-search

Un esempio di richiesta è il seguente:

https://company.openapi.com/IT-search/openapi%2A?lat=13.5478&long=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 /IT-search

La risposta rispetto alla richiesta precedente presenta 3 risultati con id 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"
    },
    {
      "id": "56bf66ea35a4c0021e84826f"

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

L'identificativo potrà essere utilizzato come parametro per altri endpoint del service Company come ad esempio lo Start e l'Advanced per ottenere informazioni dettagliate delle società come Partita IVA, PEC, Fatturato, Ateco, Soci, etc.

In fase di richiesta è possibile utilizzare anche il parametro "dataEnrichment", che consente di definire i dati desiderati nella risposta:

• Nessun parametro: verrà restituito un elenco di id delle aziende che possono essere usati per richiedere informazioni tramite gli altri endpoint di Company
• Name: includerà nella risposta ID impresa, Partita IVA, Codice Fiscale, Ragione Sociale e città della sede legale.
• Address: includerà nella risposta ID impresa, Partita IVA, Codice Fiscale, Ragione Sociale e indirizzo sede legale con coordinate e codice catastale.
• PEC: presenterà nella risposta ID impresa, Partita IVA, Codice Fiscale, Ragione Sociale e l'elenco delle aziende con attuale e storico PEC depositate in CCIAA
• Start: includerà per ogni impresa corrispondente ai parametri tutte le informazioni del servizio start e cioè denominazione, codice fiscale, partita iva, indirizzo, sede, stato attività, SdI
• Advanced: si comporterà nella stessa modalità di start ma offrirà informazioni ulteriori come ad esempio PEC codice SdI, REA, Natura Giuridica, ATECO, fatturato, utili, dipendenti, soci
• Shareholders: presenterà nella risposta ID impresa, Partita IVA, Codice Fiscale, Ragione Sociale e informazioni sui soci come nome e cognome o Denominazione sociale, codice fiscale e percentuale quota.