Postontarget

Costruisci il tuo database di marketing a livello globale tramite API

Seleziona il tuo target tra oltre 2000 categorie e accedi ad oltre 11 milioni di contatti

Tutte le informazioni di cui hai bisogno

Qui trovi qualche consiglio da prendere in considerazione per approcciare a questa API. Se preferisci forniamo esempi di codice, documentazione in OAS3, la possibilità di provare l'API dal vivo con la Swagger UI oppure importare l'intera collezione in Postman. Offriamo inoltre un ambiente di Sandbox dove puoi sperimentare tutte le API gratuitamente.

Utili consigli per iniziare con Postontarget

Prendi il token nell'apposita sezione prima di cominciare.

Usa lo strumento online o generalo via API. Imposta una data di scadenza e aggiungi una serie di Scopes per limitare le possibli azioni permesse al token.

Postontarget (1.0.0)

Questo servizio web consente di acquistare database aziendali in base a diversi parametri di ricerca.

Fields

Chiamate per trovare tutti i parametri registrati, che saranno poi utilizzati per la successiva ricerca nel database.

Elenco dei paesi

Endpoint che restituisce l'elenco dei Paesi esaminati.

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
}

Elenco delle regioni

Endpoint che restituisce l'elenco delle regioni divise per paese.

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
}

Elenco delle province

Endpoint che restituisce l'elenco delle province divise per regione e paese.

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
}

Elenco del numero di dipendenti

Endpoint che restituisce l'elenco del numero di dipendenti per azienda.

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
}

Elenco del fatturato delle aziende

Endpoint che restituisce l'elenco delle fasce di fatturato delle aziende in milioni.

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
}

Elenco delle forme giuridiche aziendali

Endpoint che restituisce l'elenco delle forme giuridiche aziendali suddivise per Paese.

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
}

Elenco delle macrocategorie commerciali

Endpoint che restituisce l'elenco delle macrocategorie commerciali.

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
}

Elenco delle categorie micro-commerciali

Endpoint che restituisce l'elenco delle micro-categorie commerciali divise per macro-categorie.

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

Richieste per la ricerca, l'acquisto e la gestione di un ordine di documenti aziendali

Trovare i documenti aziendali

Questo dndpoint consente di cercare i record aziendali in base a parametri di ricerca, restituendo una serie di risultati disponibili.

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
}

Acquisto di dati personali

Questo endpoint consente di acquistare un certo numero di record aziendali trovati in seguito alla ricerca.

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

Identificatore della richiesta restituito dopo l'esecuzione di una ricerca POST

records
integer

Numero di dischi che si desidera acquistare

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
}

Elenco delle richieste

Endpoint che consente di visualizzare tutte le ricerche e le richieste effettuate dal proprio profilo.

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
}

Richiesta singola

Endpoint che consente di visualizzare la singola richiesta o ricerca relativa all'id passato nel percorso.

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

Identificatore di richiesta/ricerca

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
}