Tutorial Enterprise API

SuperQuick reference

• La documentazione tecnica (in inglese) è disponibile sul portale developers.atoka.io, potrebbero interessarti:
  • come autenticarsi;
  • come funzionano i crediti dell'API;
  • la documentazione dell’endpoint più comune: Company API.
• L’indirizzo di base, condiviso da tutti gli endpoint, è https://api.atoka.io/v2/.
• Ogni API segue l’architettura REST e risponde in formato JSON.

Token di accesso

Le API hanno bisogno di autenticazione, tramite un token generato a ogni chiamata, simile a xuao1d61b5234c1e912b11856c3f4de3. Se non ne hai uno, scrivici a sales@atoka.io per crearne uno di prova! Il token è utilizzato per autenticare le tue richieste e consumare i crediti per i dati che visualizzerai. Puoi controllare in tempo reale i crediti disponibili sul tuo token tramite credits.atoka.io.

How-to

• Ricavare nome e sede legale di un’azienda usando la partita IVA: con questo tutorial puoi scoprire come effettuare la ricerca di un’azienda partendo da un semplice dato.
• Completamento automatico di un’anagrafica azienda: un esempio pratico con tanto di codice JS per compilare in modo rapido una scheda con i dati quali codici Ateco, sedi e numeri di telefono di un’azienda a partire dalla sua partita IVA.
• Usare la Company Match API per correggere ed arricchire dati imprecisi. La Company Match API ti permette di trovare risultati anche quando i dati di partenza non sono accurati. Potrai ottenere un elenco di nuovi lead da contattare il più completo possibile.
• Filtrare, attraverso la Company Search API, i dati utili per selezionare la lista di lead ideale per il tuo business.
• Analizzare con i Facet l’uso di social network al variare del numero di dipendenti di un’azienda.
• Aziende su una mappa: individuare tramite l’API AdminDiv i nomi dei comuni e poi vederne le aziende su una mappa.
• Aziende nei dintorni: potrai supportare un agente di commercio direttamente sul posto utilizzando diversi endpoint, permettendogli di trovare aziende di un determinato settore nelle vicinanze della sua posizione.

Packages e endpoint

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

• https://api.atoka.io/v2/companies: centinaia di campi e dozzine di filtri per più di 22 milioni di aziende;
• https://api.atoka.io/v2/locations: query geografiche su tutte le sedi delle aziende presenti in Atoka;

E, ancora, real-estate, people e molto altro.

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, codice Ateco, etc…;
• contacts: contatti telefonici e indirizzi e-mail;
• economics: numero dipendenti, dati finanziari, ricavi e stagionalità;
• entities: elenco delle entità semantiche legate ad un’azienda;
• people: informazioni su manager e amministratori e rispettivi ruoli ricoperti nell’azienda;
• shares: chi possiede chi e cosa, con ammontare e percentuali;
• web: dati estratti dal web quali descrizione, logo, siti web controllati, feed rss, parole chiave e altro.

Attraverso il parametro packages puoi selezionare cosa ottenere nella risposta e verificare quali parametri usare per costruire la tua richiesta. Ad esempio, per sapere come crescono i follower di una certa azienda, il package socials mette a tua disposizione i dati che stai cercando, mentre con contacts puoi disporre di numeri di telefono e indirizzi e-mail e così via. Per una lista di email e telefoni di aziende che usano Twitter e Facebook, i due package possono essere combinati assieme per filtrare ed arricchire la risposta.