List targeting dimension values - Apostra

Deprecated. This page documents the v2 buyer API, which is closed to new API clients and switches off on 1 December 2026. Use V3 instead: see Move a v2 buyer REST integration to V3. The conversion endpoint, Log event, stays open.

GET /api/v2/buyer/targeting/dimensions/{system} Returns code/name pairs for a targeting dimension. Store only codes in campaign constraints; use names for display and resolution.

Request

curl "https://api.apostra.com/api/v2/buyer/targeting/dimensions/nielsen_dma" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Field	Type	Required	Notes
`system`	enum	Yes	Currently `nielsen_dma`

Response

{
  "system": "nielsen_dma",
  "name": "Nielsen DMA",
  "locale": "en-US",
  "targetingFields": ["geo_metros", "geo_metros_exclude"],
  "entries": [
    { "code": "532", "name": "Albany-Schenectady-Troy" },
    { "code": "803", "name": "Los Angeles" }
  ]
}

For campaign display, request fields=geo_metro_names on list_campaigns or get_campaign; included labels return in geo_metro_names, excluded labels return in geo_metro_names_exclude, and both are derived from the same local table.