Licitadores: servicio de región

El servicio de región de solo lectura le permite ver información sobre las regiones y estados registrados en el sistema Xandr, incluido el país o región al que pertenece cada región/estado. Puedes usar este servicio para recuperar identificadores de región para segmentarlos en perfiles.

API de REST

Método HTTP Endpoint Description
GET https://api.adnxs.com/region Ver todas las regiones.
GET https://api.adnxs.com/region?id=ID Ver una región específica.
GET https://api.adnxs.com/region?name=NAME Ver una región específica.
GET https://api.adnxs.com/region?code=CODE Ver una región específica.
GET https://api.adnxs.com/region/meta Obtenga información sobre los campos por los que puede filtrar y ordenar.

Campos JSON

Campo Tipo Descripción
code enumeración El código ISO o FIPS de la región.
country_code enumeración El código ISO del país o región al que pertenece la región. Puede usar el Servicio de país para recuperar una lista completa de los códigos de país.
country_id Entero El identificador del país o región al que pertenece la región.
country_name string Nombre del país o región al que pertenece la región. Puede usar el Servicio de país o región para obtener una lista completa de nombres de países.
id Entero El identificador de la región.
name string El nombre de la región.

Ejemplos

Ver todas las regiones de Alemania

$ curl -b cookies -c cookies 'https://api.adnxs.com/region?country or region_code=DE'
{
    "response": {
        "status": "OK",
        "count": 16,
        "start_element": null,
        "num_elements": null,
        "regions": [
            {
                "id": 825,
                "name": "Baden-Wurttemberg",
                "code": "01",                
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 826,
                "name": "Bayern",
                "code": "02",                
                "country_id": 69,                
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 827,
                "name": "Bremen",
                "code": "03",
                "country_id": 69,                                
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 828,
                "name": "Hamburg",
                "code": "04",
                "country_id": 69,                                
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 829,
                "name": "Hessen",
                "code": "05",
                "country_id": 69,                                                
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 830,
                "name": "Niedersachsen",
                "code": "06",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 831,
                "name": "Nordrhein-Westfalen",
                "code": "07",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 832,
                "name": "Rheinland-Pfalz",
                "code": "08",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 833,
                "name": "Saarland",
                "code": "09",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 834,
                "name": "Schleswig-Holstein",
                "code": "10",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 835,
                "name": "Brandenburg",
                "code": "11",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 836,
                "name": "Mecklenburg-Vorpommern",
                "code": "12",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 837,
                "name": "Sachsen",
                "code": "13",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 838,
                "name": "Sachsen-Anhalt",
                "code": "14",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 839,
                "name": "Thuringen",
                "code": "15",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 840,
                "name": "Berlin",
                "code": "16",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            }
        ],
        "dbg_info": {
            ...
        }
    }
}

Ver todas las regiones de Alemania y Francia

$ curl -b cookies -c cookies 'https://api.adnxs.com/region?country_code=DE,FR'
{
    "response": {
        "status": "OK",
        "count": 38,
        "start_element": null,
        "num_elements": null,
        "regions": [
            {
                "id": 825,
                "name": "Baden-Wurttemberg",
                "code": "01",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 826,
                "name": "Bayern",
                "code": "02",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 827,
                "name": "Bremen",
                "code": "03",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 828,
                "name": "Hamburg",
                "code": "04",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            ...
            {
                "id": 1070,
                "name": "Aquitaine",
                "code": "97",
                "country_id": 78,
                "country_code": "FR",
                "country_name": "France"
            },
            {
                "id": 1071,
                "name": "Auvergne",
                "code": "97",
                "country_id": 78,
                "country_code": "FR",
                "country_name": "France"
            },
            {
                "id": 1072,
                "name": "Basse-Normandie",
                "code": "99",
                "country_id": 78,
                "country_code": "FR",
                "country_name": "France"
            },
            ...
        ],
        "dbg_info": {
            ...
        }
    }
}

Ver todas las regiones que contienen "California" en sus nombres

$ curl -b cookies -c cookies 'https://api.adnxs.com/region?like_name=California'
{
    "response": {
        "status": "OK",
        "count": 3,
        "start_element": null,
        "num_elements": null,
        "regions": [
            {
                "id": 2600,
                "name": "Baja California",
                "code": "02",
                "country_id": 42,
                "country_code": "MX",
                "country_name": "Mexico"
            },
            {
                "id": 2601,
                "name": "Baja California Sur",
                "code": "03",
                "country_id": 42,
                "country_code": "MX",
                "country_name": "Mexico"
            },
            {
                "id": 3922,
                "name": "California",
                "code": "CA",
                "country_id": 233,
                "country_code": "US",
                "country_name": "United States"
            }
        ]
    }
}