Leer en inglés

Compartir a través de


Licitantes: servicio de ciudad

El servicio de ciudad de solo lectura le permite ver información sobre las ciudades registradas en el sistema Xandr, incluida la región, el área de mercado designada y el país al que pertenece cada ciudad. Puede usar este servicio para recuperar los identificadores de ciudades para dirigirse a campañas (consulte city_targets los perfiles del licitador mejorado).

API de REST

Métodos HTTP Punto de conexión Ejemplo
GET https://api.adnxs.com/city Ver todas las ciudades.
GET https://api.adnxs.com/city?country_code=COUNTRY_CODE Ver todas las ciudades de un país específico.
GET https://api.adnxs.com/city?country_name=COUNTRY_NAME Ver todas las ciudades de un país específico.
GET https://api.adnxs.com/city?dma_id=DMA_ID Ver todas las ciudades en un área de mercado específica designada.
GET https://api.adnxs.com/city?dma_name=DMA_NAME Ver todas las ciudades en un área de mercado específica designada.
GET https://api.adnxs.com/city?id=ID Ver una ciudad específica.
GET https://api.adnxs.com/city?name=NAME Ver una ciudad específica.
GET https://api.adnxs.com/city/meta Averigüe por qué campos puede filtrar y ordenar.

Campos JSON

Campo Tipo Description
country_code enumeración El código ISO del país al que pertenece la ciudad. Puede usar country service para recuperar una lista completa de códigos de país.
country_name string Nombre del país al que pertenece la ciudad. Puede usar country service para recuperar una lista completa de nombres de país.
dma_id Entero El identificador de la zona de mercado designada a la que pertenece la ciudad. Puede usar el Servicio de área de mercado designada para recuperar una lista completa de identificadores dma.
dma_name string Nombre de la zona de mercado designada a la que pertenece la ciudad. Puede usar el Servicio de área de mercado designada para recuperar una lista completa de nombres dma.
id Entero El identificador de la ciudad.
name string Nombre de la ciudad.
region_id Entero Identificador de la región a la que pertenece la ciudad. Puede usar el Servicio de región para recuperar una lista completa de identificadores de región.
region_name string Nombre de la región a la que pertenece la ciudad. Puede usar el Servicio de región para recuperar una lista completa de nombres de región.

Ejemplos

Ver todas las ciudades de Alemania

$ 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": {
            ...
        }
    }
}

Ver todas las ciudades de la región de Bayern de Alemania

$ 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": {
            ...
        }
    }
}

Ver todas las ciudades llamadas "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": {
            ...
        }
    }
}