Construisez votre base de données marketing mondiale via API

Sélectionnez votre public cible parmi plus de 2000 catégories et accédez à plus de 11 millions de contacts

Conseils utiles pour commencer Postontarget

Obtenir le Token dans la section appropriée avant de commencer.

Utilisez l'outil en ligne ou générez-le via l'API. Définissez la date d'expiration, un nom utile et ajoutez maintenant un ensemble d'étendues pour limiter les actions possibles que votre jeton peut effectuer.

Oas file url https://console.openapi.com/oas/fr/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)

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

Ce service web vous permet d'acheter des bases de données d'entreprises en fonction de différents paramètres de recherche.

C'est la première fois que vous venez ici ? Générer un nouveau jeton d'accès

Fields

Appels pour trouver tous les paramètres enregistrés qui seront utilisés pour la recherche ultérieure dans la base de données.

Liste des pays

Point final qui renvoie la liste des pays étudiés.

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": {
- "country_code": "IT"
}

}

Response samples

Content type

application/json

{

"data": [
- {
  - "country_code": "IT",
  - "country_name_EN": "Italy",
  - "country_name_IT": "Italia"
  }
],
"searchRecords": 1,
"totalRecords": 250,
"success": true,
"message": "",
"error": null

}

Liste des régions

Point d'arrivée qui renvoie la liste des régions divisées par pays.

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": {
- "ID": "R1410",
- "country_code": "IT"
}

}

Response samples

Content type

application/json

{

"data": [
- {
  - "ID": "R1410",
  - "admin1_name": "Sicilia",
  - "admin1_name_ascii": "Sicilia",
  - "country_code": "IT"
  }
],
"searchRecords": 1,
"totalRecords": 3967,
"success": true,
"message": "",
"error": null

}

Liste des provinces

Point de terminaison qui renvoie la liste des provinces divisées par région et par pays.

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": {
- "country_code": "IT",
- "id_admin1": "R1415"
}

}

Response samples

Content type

application/json

{

"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

}

Liste du nombre d'employés

Point de terminaison qui renvoie la liste du nombre d'employés par entreprise.

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": [
- {
  - "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

}

Liste des chiffres d'affaires des entreprises

Point final qui renvoie la liste des fourchettes de chiffre d'affaires des entreprises en 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": [
- {
  - "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

}

Liste des formes juridiques des sociétés

Point de terminaison qui renvoie la liste des formes juridiques des entreprises par pays.

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": {
- "country_code": "FR"
}

}

Response samples

Content type

application/json

{

"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

}

Liste des macro-catégories commerciales

Point d'arrivée qui renvoie la liste des macro-catégories commerciales.

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": {
- "macro_name_IT": "Abiti da sposa e cerimonia"
}

}

Response samples

Content type

application/json

{

"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

}

Liste des catégories micro-commerciales

Point d'arrivée qui renvoie la liste des catégories micro-commerciales divisées par les macro-catégories.

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": {
- "id_macro": 6
}

}

Response samples

Content type

application/json

{

"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

}

Order

Appels pour la recherche, l'achat et la gestion d'une commande de documents d'entreprise

Trouver les documents de l'entreprise

Ce point dnd vous permet de rechercher des enregistrements d'entreprises en fonction de paramètres de recherche, en renvoyant un certain nombre de résultats disponibles.

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": {
- "country_code": "IT",
- "admin1_code": "IT.15",
- "macro_id": 1
}

}

Response samples

Content type

application/json

{

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

}

Achat de données personnelles

Ce point d'accès vous permet d'acheter un certain nombre d'enregistrements d'entreprises trouvés à la suite de la recherche.

Authorizations:

bearerAuth

Request Body schema: application/json

id_request	string Identifiant de la requête renvoyé après avoir effectué une recherche POST
records	integer Nombre de disques que vous souhaitez acheter

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": {
- "_id": "5d4d799c0eb46d074f01947f",
- "total_records": 5379918,
- "records_found": 51,
- "query": {
  - "country_code": "IT",
  - "admin1_code": "IT.15",
  - "macro_id": 1
  },
- "state": "accettato",
- "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

}

Liste des demandes

Point d'accès qui vous permet de visualiser toutes les recherches et demandes effectuées à partir de votre profil.

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": [
- {
  - "_id": "5d4bf7e80eb46d074e55cdeb",
  - "total_records": 5379918,
  - "records_found": 60,
  - "query": {
    "country_code": "IT",
    "admin1_code": "IT.15",
    "macro_id": 15
    },
  - "state": "accettato",
  - "owner": "[email protected]",
  - "base_price": 0.24,
  - "credit": 4.76,
  - "date": "08/08/2019",
  - "download": "https://dev.postontarget.com/download/2BECCE",
  - "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

}

Demande unique

Point de terminaison qui vous permet de visualiser la demande ou la recherche unique liée à l'identifiant passé dans le chemin.

Authorizations:

bearerAuth

path Parameters

_id

required

string

Example: 5d4bf7e80eb46d074e55cdeb

Demande / recherche d'identifiant

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": {
- "_id": "5d4bf7e80eb46d074e55cdeb",
- "total_records": 5379918,
- "records_found": 60,
- "query": {
  - "country_code": "IT",
  - "admin1_code": "IT.15",
  - "macro_id": 15
  },
- "state": "accettato",
- "owner": "[email protected]",
- "base_price": 0.24,
- "credit": 4.76,
- "date": "08/08/2019",
- "download": "https://dev.postontarget.com/download/2BECCE",
- "order_id": "2BECCE",
- "price": 0.24,
- "records_purchased": 1
},
"success": true,
"message": "",
"error": null

}

Web Service Revision: 2.0.0