Atoka API Tutorial

How to use Atoka API in the best way

Atoka, the database with more than 21 million Italian and British companies (about 6 million active today) and 13 million verified contacts, allows access to their data through these APIs. This tutorial introduces the basic concepts to be able to use, showing practical examples that you can try.

SuperQuick reference

Access Token

The API needs authentication, through a token passed to each call, similar to this xuao1d61b5234c1e912b11856c3f4de3. If you don’t have any of these, write to us at, we would be happy to create a trial one for you.

You must send the token in each request using the token parameter. This allows us to authenticate your calls and decrease credits for the data you will download through our API. You can check in real time the credits available on your token at

Tutorial (increasing complexity)

  • Get the name and registered office of a company having the VAT ID if you just got your token and don't know where to start, this is the tutorial for you. We will see how to perform a simple search request by VAT
  • Automatic completion of a company form a practical example with also JS code for implementing the automatic completion of a form starting from the VAT with all company data (ateco, headquarters, phone..)
  • Company Match API to correct and enrich approximate data. Do you have a list of VAT and names of leads you'd like to contact, but you're not confident about the data accuracy? The Match API allows you to find results starting from data that could be incorrect, inaccurate or incomplete (such as a phone number no longer used)
  • Lead Search, in the first example we catched a glimpse of the Company Search API. Here we start using the full power of this service using different filters to select a list of leads and download their data.
  • Faceting we will see how we can use facets to analyze how many companies are using social networks as the number of employees changes
  • Companies on a map, we will use the AdminDiv API to get suggestion for municipalities names and then show the companies on a map 
  • Around me, a practical example that uses various endpoints to support a selling agent, by letting him find companies of a given sector close to his position

How is the information organized in Packages and what are the endpoints to get there

The APIs of Atoka are divided in several endpoints, among which:

And also contracts, jobs, people.

Within each endpoint, data is organized in multiple packages, which are nothing more than logical grouping units. In the example, using the base package we have retrieved the master and some basic information of the company. Other packages of the endpoint companies are:

  • contacts: telephone and email
  • economics: number of employees, financial data on revenues, seasonality
  • web: data extracted from the web such as description, logos, controlled websites, RSS feeds, keywords, and more
  • govContracts: contracts and tenders with public administrations, to which companies have participated or who have won
  • people: information about exponents (managers and administrators) and their respective roles in the company
  • shares: who owns who and what, with the amount and percentages

And also economicsLite, groups, jobs, locations, socials, technologies, entities, cervedIndicators.

The package parameter allows you to select what you want to get in the answer, and state which parameters you are using to build your request.

Are you interested in discovering more details about the available data and where they come from?
We prepared a page dedicated to the API Data that is perfect for you.