List targeting dimensions - 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 Returns targeting dimensions that have local display-label dictionaries. Campaign constraints store codes; these dictionaries provide the labels and resolver metadata agents need when buyers use names in conversation.

Request

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

Response

{
  "locale": "en-US",
  "dimensions": [
    {
      "system": "nielsen_dma",
      "name": "Nielsen DMA",
      "description": "Nielsen Designated Market Area codes used with geo_metros targeting.",
      "locale": "en-US",
      "targetingFields": ["geo_metros", "geo_metros_exclude"],
      "entryCount": 210
    }
  ]
}

Use this endpoint when an agent needs to discover which dimensions can be resolved. Use Resolve targeting dimension text when the buyer gives a localized name such as “LA DMA”.