Partager via

API de plateforme numérique - Service pays

Le service de pays en lecture seule vous permet d’afficher des informations sur les pays enregistrés dans le système Xandr. Vous pouvez utiliser ce service pour récupérer l’ID de ciblage dans les campagnes (voir country_targets dans le service de profil).

API REST

HTTP, méthode Endpoint Description
GET https://api.appnexus.com/country Afficher tous les pays.
GET https://api.appnexus.com/country?id=ID Afficher un pays spécifique par ID.
GET https://api.appnexus.com/country?name=NAME Afficher un pays spécifique par NOM.
GET https://api.appnexus.com/country?code=CODE Afficher un pays spécifique par CODE.
GET https://api.appnexus.com/country/meta Découvrez les champs que vous pouvez filtrer et trier.

Champs JSON

Champ Type Description
id int ID du pays.
name string Nom du pays.
code string Code ISO pour le pays.
active Valeur booléenne Si la valeur est true, le pays est disponible pour le ciblage. Si la valeur est false, il n’y a pas de données de géolocalisation pour le pays et la livraison n’est donc pas possible.

Exemples

Afficher tous les pays

$ curl -b cookies -c cookies 'https://api.appnexus.com/country'
{
    "response": {
        "status": "OK",
        "count": 250,
        "start_element": null,
        "num_elements": null,
        "countries": [
            {
                "id": 1,
                "name": "Anonymous Proxy",
                "code": "A1",
                "active": true
            },
            {
                "id": 2,
                "name": "Satellite Provider",
                "code": "A2",
                "active": true
            },
            {
                "id": 3,
                "name": "Other Country",
                "code": "O1",
                "active": true
            },
            ...
        ]
    }
}

Afficher un pays spécifique par ID

$ curl -b cookies -c cookies 'https://api.appnexus.com/country?id=59'
{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": null,
        "num_elements": null,
        "country": {
            "id": 59,
            "name": "Germany",
            "code": "DE",
            "active": true
        }
    }
}

Afficher un pays spécifique par code

$ curl -b cookies -c cookies 'https://api.appnexus.com/country?code=DE'
{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": null,
        "num_elements": null,
        "countries": [
            {
                "id": 59,
                "name": "Germany",
                "code": "DE",
                "active": true
            }
        ]
    }
}

Afficher tous les pays qui contiennent « United » dans leur nom

$ curl -b cookies -c cookies 'https://api.appnexus.com/country?like_name=United'
{
    "response": {
        "status": "OK",
        "count": 5,
        "start_element": null,
        "num_elements": null,
        "countries": [
            {
                "id": 5,
                "name": "United Arab Emirates",
                "code": "AE",
                "active": true
            },
            {
                "id": 80,
                "name": "United Kingdom",
                "code": "GB",
                "active": true
            },
            {
                "id": 229,
                "name": "Tanzania, United Republic of",
                "code": "TZ",
                "active": true
            },
            {
                "id": 232,
                "name": "United States Minor Outlying Islands",
                "code": "UM",
                "active": true
            },
            {
                "id": 233,
                "name": "United States",
                "code": "US",
                "active": true
            }
        ]
    }
}
  • Last updated on