Bidders - City サービス
読み取り専用シティ サービスを使用すると、地域、指定された市場地域、各都市が属する国など、Xandr システムに登録されている都市に関する情報を表示できます。 このサービスを使用すると、キャンペーンでターゲット設定する都市の ID を取得できます (「拡張入札者プロファイル」を参照)。city_targets
HTTP メソッド | エンドポイント | 例 |
---|---|---|
GET | https://api.adnxs.com/city | すべての都市を表示します。 |
GET | https://api.adnxs.com/city?country_code=COUNTRY_CODE | 特定の国のすべての都市を表示します。 |
GET | https://api.adnxs.com/city?country_name=COUNTRY_NAME | 特定の国のすべての都市を表示します。 |
取得 | https://api.adnxs.com/city?dma_id=DMA_ID | 特定の指定された市場エリアのすべての都市を表示します。 |
GET | https://api.adnxs.com/city?dma_name=DMA_NAME | 特定の指定された市場エリアのすべての都市を表示します。 |
取得 | https://api.adnxs.com/city?id=ID | 特定の都市を表示します。 |
取得 | https://api.adnxs.com/city?name=NAME | 特定の都市を表示します。 |
取得 | https://api.adnxs.com/city/meta | フィルター処理および並べ替えの対象となるフィールドを確認します。 |
フィールド | 種類 | 説明 |
---|---|---|
country_code |
列挙 | 市区町村が属する国の ISO コード 。 Country Service を使用して、国コードの完全な一覧を取得できます。 |
country_name |
string | 市が属する国の名前。 Country Service を使用して、国名の完全な一覧を取得できます。 |
dma_id |
int | 市が属する指定された市場地域の ID。 指定されたマーケット エリア サービスを使用して、DMA ID の完全な一覧を取得できます。 |
dma_name |
string | 市が属する指定された市場地域の名前。 指定されたマーケット エリア サービスを使用して、dma 名の完全な一覧を取得できます。 |
id |
int | 市区町村の ID。 |
name |
string | 市区町村の名前。 |
region_id |
int | 市区町村が属するリージョンの ID。 リージョン サービスを使用して、リージョン ID の完全な一覧を取得できます。 |
region_name |
string | 市区町村が属する地域の名前。 リージョン サービスを使用して、リージョン名の完全な一覧を取得できます。 |
ドイツのすべての都市を表示
$ curl -b cookies -c cookies 'https://api.adnxs.com/city?country_code=DE'
{
"response": {
"status": "OK",
"count": 19786,
"start_element": null,
"num_elements": null,
"cities": [
{
"id": 36677,
"country_code": "DE",
"name": "Aach",
"region_name": "Baden-Wurttemberg",
"region_id": 825,
"dma_name": "Other DMA",
"dma_id": -1,
"country_name": "Germany"
},
{
"id": 36678,
"country_code": "DE",
"name": "Aalen",
"region_name": "Baden-Wurttemberg",
"region_id": 825,
"dma_name": "Other DMA",
"dma_id": -1,
"country_name": "Germany"
},
{
"id": 36679,
"country_code": "DE",
"name": "Abstatt",
"region_name": "Baden-Wurttemberg",
"region_id": 825,
"dma_name": "Other DMA",
"dma_id": -1,
"country_name": "Germany"
},
...
],
"dbg_info": {
...
}
}
}
ドイツのバイエルン州のすべての都市を表示
$ curl -b cookies -c cookies 'https://api.adnxs.com/city?region_name=Bayern'
{
"response": {
"status": "OK",
"count": 3799,
"start_element": null,
"num_elements": null,
"cities": [
{
"id": 39026,
"country_code": "DE",
"name": "Abenberg",
"region_name": "Bayern",
"region_id": 826,
"dma_name": "Other DMA",
"dma_id": -1,
"country_name": "Germany"
},
{
"id": 39027,
"country_code": "DE",
"name": "Abensberg",
"region_name": "Bayern",
"region_id": 826,
"dma_name": "Other DMA",
"dma_id": -1,
"country_name": "Germany"
},
{
"id": 39028,
"country_code": "DE",
"name": "Absberg",
"region_name": "Bayern",
"region_id": 826,
"dma_name": "Other DMA",
"dma_id": -1,
"country_name": "Germany"
},
...
],
"dbg_info": {
...
}
}
}
"Karlsruhe" という名前の都市をすべて表示
$ curl -b cookies -c cookies 'https://api.adnxs.com/city?name=Karlsruhe'
{
"response": {
"status": "OK",
"count": 2,
"start_element": null,
"num_elements": null,
"cities": [
{
"id": 37739,
"country_code": "DE",
"name": "Karlsruhe",
"region_name": "Baden-Wurttemberg",
"region_id": 825,
"dma_name": "Other DMA",
"dma_id": -1,
"country_name": "Germany"
},
{
"id": 195431,
"country_code": "US",
"name": "Karlsruhe",
"region_name": "North Dakota",
"region_id": 3952,
"dma_name": "Minot-Bismarck-Dickinson(Williston) ND",
"dma_id": 687,
"country_name": "United States"
}
],
"dbg_info": {
...
}
}
}