Skip to main content
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.interchange.io/api/v2/buyer/targeting/dimensions/nielsen_dma/resolve?q=LA%20DMA" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

FieldTypeRequiredNotes
systemenumYesCurrently nielsen_dma
qstringYesLocalized buyer text to resolve
localestringNoCurrently 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.