List directed campaign products (alpha)

curl --request GET \
  --url https://api.interchange.io/api/v2/api/v2/buyer/storefront-connections/{connectionId}/accounts/{accountId}/directed-campaigns/products \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.interchange.io/api/v2/api/v2/buyer/storefront-connections/{connectionId}/accounts/{accountId}/directed-campaigns/products"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.interchange.io/api/v2/api/v2/buyer/storefront-connections/{connectionId}/accounts/{accountId}/directed-campaigns/products', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

GET

api

buyer

storefront-connections

{connectionId}

accounts

{accountId}

directed-campaigns

products

List directed campaign products (alpha)

curl --request GET \
  --url https://api.interchange.io/api/v2/api/v2/buyer/storefront-connections/{connectionId}/accounts/{accountId}/directed-campaigns/products \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.interchange.io/api/v2/api/v2/buyer/storefront-connections/{connectionId}/accounts/{accountId}/directed-campaigns/products"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.interchange.io/api/v2/api/v2/buyer/storefront-connections/{connectionId}/accounts/{accountId}/directed-campaigns/products', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Alpha. This operation requires both the directed-campaigns mirror gate and the narrower directed-campaign-writes gate. It is read-only, but it is available only for a mapped, subscribed account on a write-verified provider.

Returns the connected provider account’s AdCP products and pricing options without creating a discovery session or applying a buyer brief. Use its product_id and pricing_option_id values in the explicit packages sent to a directed create_campaign request. Never invent either identifier. Named operation: list_directed_campaign_products

Field	Location	Type	Required	Description
`connectionId`	path	integer	Yes	Active official-adapter connection ID
`accountId`	path	integer	Yes	Buyable provider-account row selected from the connection
`advertiserId`	query	numeric string	Yes	Advertiser already mapped to this account and subscription

curl \
  "https://api.interchange.io/api/v2/buyer/storefront-connections/42/accounts/81/directed-campaigns/products?advertiserId=12345" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Response

The response preserves each provider product. At minimum, every returned row has product_id, and every pricing choice has pricing_option_id; provider format, targeting, and pricing fields pass through when supplied.

{
  "products": [
    {
      "product_id": "tiktok_video_views",
      "name": "TikTok Video Views",
      "pricing_options": [
        {
          "pricing_option_id": "tiktok_video_views_cpm",
          "pricing_model": "cpm"
        }
      ]
    }
  ]
}

TikTok treats an empty/omitted brief as an account-catalog read: it returns its complete static product set and skips brief interpretation, historical performance scoring, recommendation ranking, proposals, and top-five truncation. Other providers must pass the same no-brief conformance check before write enrollment.

Errors and recovery

Error	Recovery
`FEATURE_NOT_ENABLED`	The customer lacks mirror or write-alpha access. Do not call the adapter directly.
`CAPABILITY_NOT_SUPPORTED`	This provider has not passed directed-write conformance.
Mapping/subscription validation error	Re-list the connection accounts and mappings, map the intended advertiser, and subscribe it before retrying.

See Directed campaigns (alpha) and Create campaign.

Get directed campaign subscription (alpha)Plan a directed campaign (alpha)

⌘I

Getting Started

Advertisers

Campaigns

Product Discovery

Webhooks

Creatives

Signals & Brand

Audiences & Inventory

Measurement & Conversions

Reporting & Activity

Planning & Governance

Connections

Account & Billing

List directed campaign products (alpha)

Response

Errors and recovery

​Response

​Errors and recovery

Response

Errors and recovery