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
Toutes les connaissances dont vous avez besoin
Vous trouverez ici quelques conseils à prendre en compte pour aborder cette API. Si vous préférez, nous fournissons des exemples de code, la documentation OAS3, la possibilité d'essayer l'API en direct via Swagger UI ou d'importer l'intégralité de la collection dans Postman. Nous proposons également un environnement Sandbox où vous pouvez expérimenter toutes sortes de requêtes de manière totalement gratuite.
Obtenir le Token dans la section appropriée avant de commencer.
- 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
- POST test.postontarget.com/buying
- GET test.postontarget.com/state
Postontarget (1.0.0)
Ce service web vous permet d'acheter des bases de données d'entreprises en fonction de différents paramètres de recherche.
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:
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
Liste des régions
Point d'arrivée qui renvoie la liste des régions divisées par pays.
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
Liste des provinces
Point de terminaison qui renvoie la liste des provinces divisées par région et par pays.
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
Liste du nombre d'employés
Point de terminaison qui renvoie la liste du nombre d'employés par entreprise.
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
Liste des chiffres d'affaires des entreprises
Point final qui renvoie la liste des fourchettes de chiffre d'affaires des entreprises en millions.
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
Liste des formes juridiques des sociétés
Point de terminaison qui renvoie la liste des formes juridiques des entreprises par pays.
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
Liste des macro-catégories commerciales
Point d'arrivée qui renvoie la liste des macro-catégories commerciales.
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
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:
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
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:
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
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:
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
- 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
Liste des demandes
Point d'accès qui vous permet de visualiser toutes les recherches et demandes effectuées à partir de votre profil.
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
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:
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
- 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