The Autocomplete service is a service that from a specific textual search string, query, provides a series of relevant company results in real time.

Autocomplete allows you to search a database of more than 15 million Italian companies in real time and geolocalise it within a defined radius.

The search parameters are:

• query (the term to be searched for)
• search term mode: start (start), contain (contain), end (end with)
• geographical coordinates latitude and longitude
• radius

The special character '*' can be used as a wildcard to search for strings that start, contain or end with the specified query.

EXAMPLE REQUEST GET /autocomplete

https://imprese.openapi.it/autocomplete/openapi%2A?lat=13.5478&lng=42.859&radius=10000

This is an example of a query with the following parameters:

• starts with openapi query
• latitude 13.5478
• longitude 42.859
• radius 10000 metres

EXAMPLE RESPONSE  GET /autocomplete

The response with respect to the previous query presents 3 results with the company name starting with openapi and occurring within 10,000 metres of the point identified by latitude 13.5478 and longitude 42.859.

{
  "data": [
    {
      "id": "60bf66ea35a4c0041e84826c",
      "denominazione": "OPENAPI SRL"
    },
    {
      "id": "56bf66ea35a4c0021e84826f",
      "denominazione": "OPENAPI PLATFORM SPA"

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

The result will return the company ID in addition to the company name. This identifier can be used as a parameter for other endpoints of the Company Search service such as Basic and Advance to obtain detailed company information such as VAT number, PEC, Turnover, Ateco, Shareholders, etc.

The Autocomplete service has been chosen by hundreds of companies to optimise their search form. In fact, Autocomplete's integration allows suggestions to be offered while the customer is typing, even before pressing the search button. The customer can choose any of the autocomplete suggestions from the drop-down list and be directed to the results page without having to manually enter each character in the field.

Other Endpoints of the Search Company Service

The Search Company service allows through other endpoints to obtain individual information already present in the Search Company Basic and Advance:

• Search Company Basic to get specific information about Italian companies
• Search Company CEM to obtain the CEM of a company
• Search Company Active/Closed to check the status of a company
• Search Company Shareholders to obtain the list of partners of a company
• Search Company VAT Group to find out if the company belongs to a VAT Group
• Search Company Advance (Company List) to obtain a list of enterprises based on a number of parameters such as ATECO code, turnover, CCIAA, employees
• Search Company Advance VAT Number to have detailed information on a company
• Search Company Updates to get a list of all company ids for which changes have been registered
• Search Company Legal Form to get the list and code of all companies’ legal forms