Un tutorial
per le Atoka API

Come usare al meglio le Atoka API

Atoka, la banca dati con più di 21 milioni di imprese italiane (di cui oltre 6 milioni attive oggi) e inglesi e 13 milioni di contatti verificati, permette l’accesso ai propri dati tramite queste API. In questa pagina troverai alcuni tutorial, da quelli più semplici per introdurti ai concetti base per poterle usare, a quelli più avanzati che ti mostreranno tutte le potenzialità del nostro servizio.

SuperQuick reference

Token di accesso

Le API hanno bisogno di autenticazione, tramite un token passato ad ogni chiamata, simile a xuao1d61b5234c1e912b11856c3f4de3. Se non ne hai uno, scrivici a sales@atoka.io, saremo felici di crearne uno di prova!

Il token va passato ad ogni richiesta con il parametro token, e lo useremo per autenticare le tue richieste, e scalare crediti per i dati che visualizzerai. Puoi controllare in tempo reale i crediti disponibili sul tuo token tramite credits.atoka.io 

Tutorial (in ordine di complessità)

  • Ricavare nome e sede legale di un’azienda avendo la Partita IVA: se hai appena ottenuto il tuo token e non sai da che parte iniziare, questo è il tutorial per te. Vedremo come effettuare una semplice ricerca di un'azienda utilizzando la partita iva.
  • Completamento automatico di un'anagrafica azienda: un esempio pratico con tanto di codice JS per autocompletare una form con i dati (ateco, sede, telefono, ...) di un'azienda a partire dalla sua partita iva.
  • Usare la Company Match API: per correggere ed arricchire dati approssimativi. Hai un elenco di partite iva e nomi di leads che vorresti contattare, ma non sei sicuro dell'accuratezza dei dati in input? La company match api ti permette di trovare risultati anche in caso di dati di partenza imprecisi.
  • Ricerca di Lead: nel primo esempio abbiamo intravisto come utilizzare la company search API. Qui cominciamo ad assaporare la potenza di questo servizio utilizzando vari filtri per selezionare una lista di lead e scaricarne i dati.
  • Faceting: vedremo come possiamo utilizzare i facet per analizzare l'uso di social network al variare del numero di dipendenti di un'azienda.
  • Aziende su una mappa: utilizzeremo l'API AdminDiv per farci suggerire i nomi dei comuni e poi vederne le aziende su una mappa.
  • Aziende nei dintorni: un esempio pratico che utilizza diversi endpoint per supportare un agente di commercio direttamente sul posto, permettendogli di trovare aziende di un determinato settore nelle vicinanze della sua posizione.

Come sono organizzate le informazioni in Packages e quali sono gli endpoint per arrivarci

Le API di Atoka sono divise in vari endpoint, tra cui:

Ed inoltre contracts, jobs, people.

All’interno di ogni endpoint, i dati sono organizzati in più package, che non sono altro che unità logiche di raggruppamento. I package disponibili per l'endpoint companies per esempio sono:

  • base: informazioni generali dell'azienda, partita iva, indirizzo sede legale, settore ATECO,..
  • contacts: telefoni ed email
  • economics: numero dipendenti, dati finanziari sui ricavi, stagionalità
  • web: dati estratti dal web quali descrizione, logo, siti web controllati, feed rss, parole chiave ed altro
  • govContracts: contratti e bandi di gara con le pubbliche amministrazioni, a cui le aziende hanno solo partecipato o che hanno vinto
  • people: informazioni sugli esponenti (manager e amministratori) e rispettivi ruoli ricoperti nell’azienda
  • shares: chi possiede chi e cosa, con ammontare e percentuali

Il parametro packages permette di selezionare cosa vuoi ottenere nella risposta, e dichiarare quali parametri stai usando per costruire la tua richiesta. Ad esempio, per sapere come crescono i follower di una certa azienda userai il package socials, per ottenere email e numeri di telefono contacts e così via. Per una lista di email e telefoni di aziende che usano Twitter e Facebook, si possono usare assieme per filtrare ed arricchire la risposta.

Sei interessato a conoscere più in dettaglio i dati disponibili e da dove provengono?
Abbiamo preparato una pagina tutta dedicata ai Dati nelle API che fa proprio al caso tuo.