Autocomplete (Company)

  • Openapi Erogazione : Immediata
  • Openapi a partire da € 0,00 + iva

Rendi più facili ed immediate le ricerche su aziende dei tuoi clienti.

A partire da una query sarà possibile offrire suggerimenti di aziende con denominazione pertinente rispetto alla ricerca.

Esempio Autocomplete (Company)

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 ottenere nella risposta non solo gli id ma dati arricchiti delle aziende che coincidono con la nostra richiesta:

  • Nessun parametro: viene specificato verrà restituito un elenco di id delle aziende che possono essere usati per richiedere informazioni tramite gli altri endpoint di Company
  • Start: restituirà per ogni impresa corrispondente ai parametri tutte le informazioni dell'endpoint start: denominazione, codice fiscale, partita iva, indirizzo, sede, stato attività, sdi
  • Advanced: si comporterà nella stessa modalità di start ma offrirà informazioni arricchite come ad esempio  PEC codice SdI, REA, Natura Giuridica, ATECO, fatturato, utili, dipendenti, soci

Le nostre tariffe

Listino prezzi a chiamata