Bauen Sie Ihre globale Marketing-Datenbank über API auf

Wählen Sie Ihr Zielpublikum aus über 2000 Kategorien und greifen Sie auf über 11 Millionen Kontakte zu

Nützliche Tipps für den Einstieg Postontarget

Holen Sie sich das Token im entsprechenden Abschnitt, bevor Sie beginnen.

Verwenden Sie das Online-Tool oder generieren Sie es über die API. Legen Sie das Ablaufdatum, einen nützlichen Namen fest und fügen Sie jetzt eine Vielzahl von Scopes hinzu, um die möglichen Aktionen Ihres Tokens zu begrenzen.

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

Dieser Webdienst ermöglicht es Ihnen, Unternehmensdatenbanken auf der Grundlage verschiedener Suchparameter zu erwerben

Zum ersten Mal hier? Erzeugen Sie ein neues Zugangstoken

Fields

Aufrufe zum Auffinden aller erfassten Parameter, die dann für die anschließende Datenbanksuche verwendet werden

Liste der Länder

Endpunkt, der die Liste der untersuchten Länder zurückgibt.

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 der Regionen

Endpunkt, der die Liste der Regionen nach Ländern geordnet zurückgibt.

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 der Provinzen

Endpunkt, der die Liste der Provinzen, unterteilt nach Region und Land, zurückgibt.

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 der Anzahl der Beschäftigten

Endpunkt, der die Liste der Anzahl der Mitarbeiter pro Unternehmen zurückgibt.

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 der umgesetzten Unternehmen

Endpunkt, der die Liste der Unternehmen mit Umsatzbereichen in Millionen zurückgibt.

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 der Rechtsformen für Unternehmen

Endpunkt, der eine nach Ländern geordnete Liste der Rechtsformen von Unternehmen liefert.

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 der kommerziellen Makro-Kategorien

Endpunkt, der die Liste der kommerziellen Makro-Kategorien zurückgibt.

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 der Kategorien des Kleinstgewerbes

Endpunkt, der die Liste der Mikro-Gewerbekategorien, unterteilt nach Makrokategorien, zurückgibt.

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

Aufforderung zur Suche, zum Kauf und zur Verwaltung einer Bestellung von Unternehmensunterlagen

Unternehmensdaten finden

Dieser dndpoint ermöglicht Ihnen die Suche nach Unternehmenseinträgen anhand von Suchparametern und liefert eine Reihe von verfügbaren Ergebnissen.

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

}

Kauf von personenbezogenen Daten

Dieser Endpunkt ermöglicht es Ihnen, eine bestimmte Anzahl von Unternehmensdatensätzen zu kaufen, die bei der Suche gefunden wurden.

Authorizations:

bearerAuth

Request Body schema: application/json

id_request	string Nach der Durchführung einer POST-Suche zurückgegebene Anforderungskennung
records	integer Anzahl der Datensätze, die Sie kaufen möchten

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 der Anfragen

Endpunkt, über den Sie alle von Ihrem Profil aus durchgeführten Suchen und Anfragen einsehen können.

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

}

Einzelne Anfrage

Endpunkt, der es Ihnen ermöglicht, die einzelne Anfrage oder Suche im Zusammenhang mit der im Pfad übergebenen ID anzuzeigen.

Authorizations:

bearerAuth

path Parameters

_id

required

string

Example: 5d4bf7e80eb46d074e55cdeb

Kennung anfordern/suchen

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