Company Search - Italy

Company Search is a powerful and effective search tool that allows you to obtain a list of all companies matching those criteria based on over 15 parameters.

The parameters available for Company Search requests are:

These parameters can be freely combined to obtain a more relevant list of business contacts.

Additionally, using Company Search, it is possible to identify companies where an individual or legal entity is a shareholder, simply using the tax code as a reference.

Another interesting aspect is the "dataEnrichment" parameter, which allows you to specify the type of dataset desired in the response:

Company Search is identified by the endpoint: GET https://company.openapi.com/IT-search .

REQUEST EXAMPLE

GET /IT-search

This is an example of a call where the following parameters were used:

https://company.openapi.com/IT-Search?dataEnrichment=start&province=RM&atecoCode=6201&cciaa=RM&minTurnover=500000&maxTurnover=2000000&minEmployees=5&maxEmployees=20

EXAMPLE RESPONSE

GET /IT-search

The response returns a list of companies that match the given parameters and the selected dataset (start):

This response is for example purposes, and the data may not correspond to the parameters indicated in the request:

{
"data": [
  {
    "taxCode": "12485671007",
    "companyName": "OPENAPI S.R.L.",
    "vatCode": "12485671007",
    "address":{
      "registeredOffice": {
      "toponym": "VIALE",
      "street": "F TOMMASO MARINETTI",
      "streetNumber": "221",
      "streetName": "VIALE F TOMMASO MARINETTI 221",
      "town": "ROME",
      "hamlet":  null,
      "province": "RM",
      "zipCode": "00143",
      "gps": {
        "coordinates": [
          12.47843,
          41.8071
       ]
      },
      "townCode": "H501"
    }
  },
  "activityStatus": "ACTIVE",
  "creationTimestamp": 1676878023,
  "lastUpdateTimestamp": 1676878023,
  "sdiCode": "MJ1OYNU",
  "sdiCodeTimestamp": 1624358855,
  "id": "60b4a85585e34e615c569ef5",
  "registrationDate": "2013-07-19"
  },
{
  "taxCode": "12345678910",
  "companyName": "OPENAPI TEST S.P.A.",
  "vatCode": "12345678910",
  "address":{
    "registeredOffice": {
    "toponym": "VIALE",
    "street": "ROME",
    "streetNumber": "221",
    "streetName": "VIALE ROME 221",
    "town": "ROME",
    "hamlet":  null,
    "province": "RM",
    "zipCode": "00143",
      "gps": {
        "coordinates": [
         13.47866,
          41.9072
        ]
      },
      "townCode": "H501",
    }
  },
  "activityStatus": "REGISTERED",
  "creationTimestamp": 1676878023,
  "lastUpdateTimestamp": 1676878023,
  "sdiCode": "USAL8PV",
  "sdiCodeTimestamp": 1624358855,
  "id": "45d1bfc788174b9u092cdtr5",
  "registrationDate": "2016-08-29"
    }
 ],
 "success":  true,
 "message": "",
 "error":  null
 }

The cost is charged based on the number of companies present in the response, and it is possible to get the count of available results before making the call using the parameter “dry_run”.

Searching without a parameter or with the dry run parameter has a free daily request limit of 100; beyond that limit, the cost will be €0.01 per request.

To prevent potential errors, the service also has a default maximum result limit: 1000 results. You can further reduce the number of results using the parameter “limit”, where you can specify the number of desired results.

If the response includes more than 1000 companies, you can obtain all the results with multiple calls and use the parameter “skip” to indicate the number of results to be “skipped”.

For example, if a request is expected to return 1500 companies, the first call will provide the first 1000 results. The second call, with the skip parameter set to 1000 (to skip the first 1000 results already obtained), will return the remaining 500 results.

Company Search is used, for example, for sectoral market research and analysis or for marketing activities.