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