Postontarget

  1. Home
  2. API Library
  3. Postontarget
Build your global marketing database via API

Select your target audience from over 2000 categories and access over 11 million contacts

All the knowledge you need

Here you can find some advice to consider to approach this API. If you prefer, we provide code samples, OAS3 documentation, the ability to try the API live via the Swagger UI or import the entire collection into Postman. We also offer a Sandbox environment where you can experiment with all kinds of requests completely free of charge.

Useful tips to start with Postontarget

Get the token in the appropriate section before you start.

Use the the online tool or generate it via API. Set the expire date, a usefull name and now add a bunch of scopes to limit the possible actions your token can do.
Read more on oauth API Manage my tokens
API docs by Redocly

Postontarget (1.0.0)

URL: https://openapi.it/en/support License: Apache 2.0 Terms of Service

This web service allows you to purchase company database based on different search parameters

First time here? Generate a new access token

Fields

Calls to find all the parameters recorded which will then be used for the subsequent database search

List of countries

Endpoint that returns the list of countries surveyed.

Authorizations:
bearerAuth
Request Body schema: application/json
limit
integer
object (Country_Query)

Responses

Response Schema: application/json
Array of objects (Country_Query)
searchRecords
integer
totalRecords
integer
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "limit": 0,
  • "query": {
    }
}

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "searchRecords": 1,
  • "totalRecords": 250,
  • "success": true,
  • "message": "",
  • "error": null
}

List of regions

Endpoint that returns the list of regions divided by country.

Authorizations:
bearerAuth
Request Body schema: application/json
limit
integer
object (Admin1_geo_Query)

Responses

Response Schema: application/json
Array of objects (Admin1_geo_Query)
searchRecords
integer
totalRecords
integer
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "limit": 0,
  • "query": {
    }
}

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "searchRecords": 1,
  • "totalRecords": 3967,
  • "success": true,
  • "message": "",
  • "error": null
}

List of provinces

Endpoint that returns the list of provinces divided by region and country.

Authorizations:
bearerAuth
Request Body schema: application/json
limit
integer
object (Admin2_geo_Query)

Responses

Response Schema: application/json
Array of objects (Admin2_geo_Query)
searchRecords
integer
totalRecords
integer
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "limit": 0,
  • "query": {
    }
}

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "searchRecords": 2,
  • "totalRecords": 45298,
  • "success": true,
  • "message": "",
  • "error": null
}

List of number of employees

Endpoint that returns the list of number of employees per company.

Authorizations:
bearerAuth
Request Body schema: application/json
limit
integer
object (Dipendenti_Query)

Responses

Response Schema: application/json
Array of objects (Dipendenti_Query)
searchRecords
integer
totalRecords
integer
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "limit": 0,
  • "query": { }
}

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "searchRecords": 6,
  • "totalRecords": 6,
  • "success": true,
  • "message": "",
  • "error": null
}

List of companies turnover

Endpoint that returns the list of companies turnover ranges in millions.

Authorizations:
bearerAuth
Request Body schema: application/json
limit
integer
object (Fatturato_Query)

Responses

Response Schema: application/json
Array of objects (Fatturato_Query)
searchRecords
integer
totalRecords
integer
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "limit": 0,
  • "query": { }
}

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "searchRecords": 8,
  • "totalRecords": 8,
  • "success": true,
  • "message": "",
  • "error": null
}

List of corporate legal forms

Endpoint that returns the list of corporate legal forms divided by country.

Authorizations:
bearerAuth
Request Body schema: application/json
limit
integer
object (Forma_giuridica_Query)

Responses

Response Schema: application/json
Array of objects (Forma_giuridica_Query)
searchRecords
integer
totalRecords
integer
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "limit": 0,
  • "query": {
    }
}

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "searchRecords": 2,
  • "totalRecords": 11,
  • "success": true,
  • "message": "",
  • "error": null
}

List of commercial macro-categories

Endpoint that returns the list of commercial macro-categories.

Authorizations:
bearerAuth
Request Body schema: application/json
limit
integer
object (Macrocategorie_Query)

Responses

Response Schema: application/json
Array of objects (Macrocategorie_Query)
searchRecords
integer
totalRecords
integer
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "limit": 0,
  • "query": {
    }
}

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "searchRecords": 1,
  • "totalRecords": 295,
  • "success": true,
  • "message": "",
  • "error": null
}

List of micro-commercial categories

Endpoint that returns the list of micro-commercial categories divided by macro-categories.

Authorizations:
bearerAuth
Request Body schema: application/json
limit
integer
object (Microcategorie_Query)

Responses

Response Schema: application/json
Array of objects (Microcategorie_Query)
searchRecords
integer
totalRecords
integer
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "limit": 5,
  • "query": {
    }
}

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "searchRecords": 5,
  • "totalRecords": 1892,
  • "success": true,
  • "message": "",
  • "error": null
}

Order

Calls for the search, purchase and management of an order of company records

Find company records

This dndpoint allows you to search company records according to search parameters, returning a number of available results.

Authorizations:
bearerAuth
Request Body schema: application/json
required
object

Responses

Response Schema: application/json
object (Search_Object)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "query": {
    }
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "OK",
  • "error": null
}

Purchase of personal data

This endpoint allows you to purchase a certain number of company records found following the search.

Authorizations:
bearerAuth
Request Body schema: application/json
id_request
string

Request identifier returned after performing a POST Search

records
integer

Number of records that you want to buy

Responses

Response Schema: application/json
object (Buying_Object)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "id_request": "5d4d799c0eb46d074f01947f",
  • "records": "5"
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "OK",
  • "error": null
}

List of requests

Endpoint that allows you to view all the searches and requests made from your profile.

Authorizations:
bearerAuth

Responses

Response Schema: application/json
Array of Search_Object (object) or Buying_Object (object)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://postontarget.com/state");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Single request

Endpoint that allows you to view the single request or search related to the id passed in the path.

Authorizations:
bearerAuth
path Parameters
_id
required
string
Example: 5d4bf7e80eb46d074e55cdeb

Request / search identifier

Responses

Response Schema: application/json
Search_Object (object) or Buying_Object (object)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://postontarget.com/state/%7B_id%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}
Web Service Revision: 2.0.0