英語で読む

次の方法で共有


Bidders - City サービス

読み取り専用シティ サービスを使用すると、地域、指定された市場地域、各都市が属する国など、Xandr システムに登録されている都市に関する情報を表示できます。 このサービスを使用すると、キャンペーンでターゲット設定する都市の ID を取得できます (「拡張入札者プロファイル」を参照)。city_targets

REST API

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 フィルター処理および並べ替えの対象となるフィールドを確認します。

JSON フィールド

フィールド 種類 説明
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": {
            ...
        }
    }
}