Resolve targeting dimension text - 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}/resolve Resolves localized buyer text to code candidates within one targeting dimension. Use this when a buyer says something like “only the LA DMA”; send only the returned code in campaign constraints.

Request

curl "https://api.apostra.com/api/v2/buyer/targeting/dimensions/nielsen_dma/resolve?q=LA%20DMA" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Field	Type	Required	Notes
`system`	enum	Yes	Currently `nielsen_dma`
`q`	string	Yes	Localized buyer text to resolve
`locale`	string	No	Currently `en-US`

Response

{
  "system": "nielsen_dma",
  "locale": "en-US",
  "query": "LA DMA",
  "ambiguous": false,
  "candidates": [
    {
      "system": "nielsen_dma",
      "code": "803",
      "name": "Los Angeles",
      "locale": "en-US",
      "confidence": 0.96,
      "matched": "LA DMA",
      "matchType": "alias"
    }
  ]
}

If ambiguous is true, multiple candidates are close enough that the caller should ask the buyer to clarify before creating or updating the campaign.