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.
Prendi il token nell'apposita sezione prima di cominciare.
- Oas file url https://console.openapi.com/oas/it/postontarget.openapi.json
- Fork or import with Postman
- Production domain postontarget.com
- Sandbox domain test.postontarget.com
- Production Scopes 5
-
Sandbox Scopes 5
- GET test.postontarget.com/layout
- POST test.postontarget.com/fields
- POST test.postontarget.com/search
- GET test.postontarget.com/state
- POST test.postontarget.com/buying
Postontarget (1.0.0)
Questo servizio web consente di acquistare database aziendali in base a diversi parametri di ricerca.
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:
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
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "limit": 0,
- "query": {
- "country_code": "IT"
Response samples
- 200
- 400
- 404
- 406
- 422
- "data": [
- {
- "country_code": "IT",
- "country_name_EN": "Italy",
- "country_name_IT": "Italia"
- "searchRecords": 1,
- "totalRecords": 250,
- "success": true,
- "message": "",
- "error": null
Elenco delle regioni
Endpoint che restituisce l'elenco delle regioni divise per paese.
Authorizations:
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
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "limit": 0,
- "query": {
- "ID": "R1410",
- "country_code": "IT"
Response samples
- 200
- 400
- 404
- 406
- 422
- "data": [
- {
- "ID": "R1410",
- "admin1_name": "Sicilia",
- "admin1_name_ascii": "Sicilia",
- "country_code": "IT"
- "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:
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
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "limit": 0,
- "query": {
- "country_code": "IT",
- "id_admin1": "R1415"
Response samples
- 200
- 400
- 404
- 406
- 422
- "data": [
- {
- "ID": "P17203",
- "admin2_name": "Terni",
- "admin2_name_ascii": "Terni",
- "country_code": "IT",
- "id_admin1": "R1415"
- {
- "ID": "P17223",
- "admin2_name": "Perugia",
- "admin2_name_ascii": "Perugia",
- "country_code": "IT",
- "id_admin1": "R1415"
- "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:
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
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "limit": 0,
- "query": { }
Response samples
- 200
- 400
- 404
- 406
- 422
- "data": [
- {
- "dipendenti": "1 - 9"
- {
- "dipendenti": "10 - 19"
- {
- "dipendenti": "20 - 49"
- {
- "dipendenti": "50 - 249"
- {
- "dipendenti": "250 - 499"
- {
- "dipendenti": "oltre 500"
- "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:
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
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "limit": 0,
- "query": { }
Response samples
- 200
- 400
- 404
- 406
- 422
- "data": [
- {
- "fatturato": "fino a 0,5"
- {
- "fatturato": "0,5 - 2,5"
- {
- "fatturato": "2,5 - 5"
- {
- "fatturato": "5 - 13"
- {
- "fatturato": "13 - 25"
- {
- "fatturato": "25 - 50"
- {
- "fatturato": "50 - 100"
- {
- "fatturato": "oltre 100"
- "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:
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
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "limit": 0,
- "query": {
- "country_code": "FR"
Response samples
- 200
- 400
- 404
- 406
- 422
- "data": [
- {
- "ID": 10,
- "forma_giuridica": "SARL",
- "country_code": "FR"
- {
- "ID": 11,
- "forma_giuridica": "SA",
- "country_code": "FR"
- "searchRecords": 2,
- "totalRecords": 11,
- "success": true,
- "message": "",
- "error": null
Elenco delle macrocategorie commerciali
Endpoint che restituisce l'elenco delle macrocategorie commerciali.
Authorizations:
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
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "limit": 0,
- "query": {
- "macro_name_IT": "Abiti da sposa e cerimonia"
Response samples
- 200
- 400
- 404
- 406
- 422
- "data": [
- {
- "ID": 11,
- "macro_name_IT": "Abiti da sposa e cerimonia",
- "macro_name_EN": "Wedding and formal wear"
- "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:
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
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "limit": 5,
- "query": {
- "id_macro": 6
Response samples
- 200
- 400
- 404
- 406
- 422
- "data": [
- {
- "ID": 32,
- "micro_name_IT": "Abbigliamento industria - forniture ed accessori",
- "micro_name_EN": "Industry apparel - supplies and accessories",
- "id_macro": 6
- {
- "ID": 33,
- "micro_name_IT": "Abiti da lavoro ed indumenti protettivi",
- "micro_name_EN": "Work clothes and protective clothing",
- "id_macro": 6
- {
- "ID": 34,
- "micro_name_IT": "Abiti usati e stracci",
- "micro_name_EN": "Used clothes and rags",
- "id_macro": 6
- {
- "ID": 35,
- "micro_name_IT": "Additivi, coloranti e pigmenti uso industriale",
- "micro_name_EN": "Additives, dyes and pigments industrial",
- "id_macro": 6
- {
- "ID": 36,
- "micro_name_IT": "Aghi e spilli",
- "micro_name_EN": "Pins and needles",
- "id_macro": 6
- "searchRecords": 5,
- "totalRecords": 1892,
- "success": true,
- "message": "",
- "error": null
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:
Request Body schema: application/json
required | object |
Responses
Response Schema: application/json
object (Search_Object) | |
success | boolean |
message | string |
error | integer |
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "query": {
- "country_code": "IT",
- "admin1_code": "IT.15",
- "macro_id": 1
Response samples
- 200
- 400
- 422
- "data": {
- "total_records": 5379918,
- "records_found": 51,
- "query": {
- "country_code": "IT",
- "admin1_code": "IT.15",
- "macro_id": 1
- "state": "ricerca_evasa",
- "id_request": "5d4d77b80eb46d074e55ce19"
- "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:
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
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "id_request": "5d4d799c0eb46d074f01947f",
- "records": "5"
Response samples
- 200
- 402
- 404
- 406
- 412
- 422
- "data": {
- "_id": "5d4d799c0eb46d074f01947f",
- "total_records": 5379918,
- "records_found": 51,
- "query": {
- "country_code": "IT",
- "admin1_code": "IT.15",
- "macro_id": 1
- "state": "accettato",
- "base_price": 0.24,
- "credit": 3.5599999999999996,
- "date": "09/08/2019",
- "order_id": "4D7736",
- "price": 1.2,
- "records_purchased": "5"
- "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:
Responses
Response Schema: application/json
Array of Search_Object (object) or Buying_Object (object) | |
success | boolean |
message | string |
error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- 200
- 404
- "data": [
- {
- "_id": "5d4bf7e80eb46d074e55cdeb",
- "total_records": 5379918,
- "records_found": 60,
- "query": {
- "country_code": "IT",
- "admin1_code": "IT.15",
- "macro_id": 15
- "state": "accettato",
- "base_price": 0.24,
- "credit": 4.76,
- "date": "08/08/2019",
- "order_id": "2BECCE",
- "price": 0.24,
- "records_purchased": 1
- {
- "_id": "5d4d513d0eb46d074f01946a",
- "total_records": 5379918,
- "records_found": 60,
- "query": {
- "country_code": "IT",
- "admin1_code": "IT.15",
- "macro_id": 15
- "state": "ricerca_evasa",
- "owner": "[email protected]"
- "success": true,
- "message": "",
- "error": null
Richiesta singola
Endpoint che consente di visualizzare la singola richiesta o ricerca relativa all'id passato nel percorso.
Authorizations:
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
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- 200
- 404
- 406
- "data": {
- "_id": "5d4bf7e80eb46d074e55cdeb",
- "total_records": 5379918,
- "records_found": 60,
- "query": {
- "country_code": "IT",
- "admin1_code": "IT.15",
- "macro_id": 15
- "state": "accettato",
- "base_price": 0.24,
- "credit": 4.76,
- "date": "08/08/2019",
- "order_id": "2BECCE",
- "price": 0.24,
- "records_purchased": 1
- "success": true,
- "message": "",
- "error": null