HelpersGeo Targeting Helper

Geo Targeting Helper

List geographic targeting nodes. Called with no query parameters, returns the root continent list; called with one of the geoname-id parameters, returns that node's children (e.g. pass country_geoname_id to list its subdivisions). Used to populate the hierarchical geo-targeting picker.

curl -X GET "https://api.5centscdn.com/v2/ad-manager/101/helpers/geo?continent_geoname_id=6255148&country_geoname_id=6252001&subdivision_1_geoname_id=5332921&subdivision_2_geoname_id=5391959&city_geoname_id=5391811" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "result": "success",
  "geo": [
    {
      "continent_geoname_id": 6255149,
      "country_geoname_id": 6252001,
      "subdivision_1_geoname_id": 5332921,
      "subdivision_2_geoname_id": 5391959,
      "city_geoname_id": 5391811,
      "name": "United States"
    }
  ]
}
GET
/ad-manager/{pid}/helpers/geo
GET
Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: X-API-Key)
X-API-Keystring
Required

API key (sent in header)

path
pidinteger
Required

ID of the Ad Manager project.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
X-API-Keystring
Required

API Key for authentication. Provide your API key in the header.

Path Parameters

pidinteger
Required

ID of the Ad Manager project.

Example:
101

Query Parameters

city_geoname_idinteger
Example:
5391811

Responses

resultstring

Operation outcome.

Allowed values:successerror
geoarray

Geo nodes at the requested level. Each item carries exactly one geoname-id field identifying its level (continent_geoname_id, country_geoname_id, subdivision_1_geoname_id, subdivision_2_geoname_id, or city_geoname_id) plus a display name.