Corporate Databases (Postontarget)

The Corporate Databases (Postontarget) allows you to build and obtain a customized international company database to fit your needs.

You can access over 8 criteria to design your database:

Starting from a geographic filter (Country, Region, Province), you can select a revenue range, number of employees, over 300 macrocategories, and 1900 categories.

For each search parameter, an endpoint is available to find out in advance how many contacts are available and to obtain the ID of each desired requirement, which can then be used in the database request payload.

DATABASE REQUEST

As mentioned, before proceeding with the purchase, it will be possible to check the number of available contacts based on the set parameters and obtain the request ID to finalize the database purchase.

REQUEST EXAMPLE

POST/search

The request payload must include references to the database requirements:

{
        "query": {
          "country_code": "IT",
          "admin1_code": "IT.15",
          "macro_id": 1
        }
      }

RESPONSE EXAMPLE

POST/search

The response will return the number of available contacts, the number of contacts matching the request, the previously indicated parameters, and the request ID.

  {
    "data": {
      "total_records": 5379918,
      "records_found": 51,
      "query": {
        "country_code": "IT",
        "admin1_code": "IT.15",
        "macro_id": 1
      },
      "state": "search_completed",
      "owner": "[email protected]",
      "id_request": "5d4d77b80eb46d074e55ce19"
    },
    "success": true,
    "message": "OK",
    "error": null
  }
  
  

DATABASE PURCHASE

Once you have obtained the request code, you can proceed with the purchase.

REQUEST EXAMPLE

POST /buying

In the request payload, you need to pass the ID and the number of contacts you want to purchase.

{
    {
      "id_request": "5d4d799c0eb46d074f01947f",
      "records": "5"
    }

RESPONSE EXAMPLE

POST /buying

The response returns various pieces of information including the status (e.g., accepted), the request ID, previously indicated parameters, the cost per contact, the total charged, the request date, the order number, and the download link.

    {
      "data": {
        "_id": "5d4d799c0eb46d074f01947f",
        "total_records": 5379918,
        "records_found": 51,
        "query": {
          "country_code": "IT",
          "admin1_code": "IT.15",
          "macro_id": 1
        },
        "state": "accepted",
        "owner": "[email protected]",
        "base_price": 0.24,
        "credit": 3.5599999999999996,
        "date": "09/08/2019",
        "download": "https://test.postontarget.com/download/4D7736",
        "order_id": "4D7736",
        "price": 1.2,
        "records_purchased": "5"
      },
      "success": true,
      "message": "OK",
      "error": null
    }

DOWNLOAD DATABASE

You can check the status of the request via the dedicated endpoint.

REQUEST EXAMPLE

GET/state/{_id}

This is an example of a request made using the previously obtained ID.

https:/postontarget.com/state/5d4d799c0eb46d074f01947f 

The response will be identical to that of the previous request (buying) but with the updated fulfillment status.

Database fulfillment typically takes 48-72 working hours. Once the request status is "search_fulfilled," you will be able to download the document from the link provided in the response.

The Postontarget service provides premium contacts with the following information:

Data marked with an asterisk may not be present in all records.

All contacts in our Database comply with current regulations at both European and national levels. All data is daily updated by a dedicated team.