List adapter advertisers

GET /api/v2/storefront/esa/{esaId}/advertisers Reads a bounded advertiser page for a Google Ad Manager, FreeWheel, or AdsWizz source. Google Ad Manager pages come from its synced cache. FreeWheel performs a bounded authoritative sync before serving the first cached page. Follow nextCursor until it is null. Only treat an omitted advertiser as removed when authoritative is true, truncated is false, and errors is empty. For filtered GAM search, use GET /esa/{esaId}/gam/advertisers.

Request

curl "https://api.interchange.io/api/v2/storefront/esa/123/advertisers?limit=500" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Field	Type	Required	Notes
`esaId`	integer	Yes	Path. Embedded sales-agent connection id
`limit`	integer	No	Query. Page size from 1 to 500; defaults to 50
`cursor`	string	No	Query. Opaque cursor returned by `nextCursor`

Response

{
  "adapterType": "freewheel",
  "advertisers": [
    {
      "id": "fw-552",
      "name": "Nike CTV",
      "status": "active"
    }
  ],
  "nextCursor": null,
  "syncedAt": "2026-08-01T00:20:00Z",
  "authoritative": true,
  "truncated": false,
  "errors": []
}

advertisers[].id is the provider-native advertiser ID. adapterType namespaces that ID. syncedAt is the cache/sync timestamp when the provider supplies one.

Errors

400 VALIDATION_ERROR — esaId, limit, or cursor is invalid; the source is deactivated; or the ad server has no advertiser roster.
404 NOT_FOUND — no embedded sales agent with this esaId on your account.
503 SERVICE_UNAVAILABLE — the ad server is temporarily unreachable.

See Errors for the full error contract.

Buyer routing tasks

All buyer-routing operations

Buyer routing overview

How buyers resolve to advertisers

List GAM advertisers

Filter the cached Google Ad Manager roster by name

Set default advertiser

Pick the catch-all advertiser

⌘I

Getting Started

Operating Your Storefront

Inventory Sources

Real-Time Targeting (TMP)

Approvals & Reviews

Buyer Onboarding

Demand & Signals

Proposals & Agents

Buyer Routing

Analytics & Activity

Billing

Account

Request

Parameters

Response

Errors

Buyer routing tasks

Buyer routing overview

List GAM advertisers

Set default advertiser

​Request

​Parameters

​Response

​Errors

​Related

Buyer routing tasks

Buyer routing overview

List GAM advertisers

Set default advertiser

Request

Parameters

Response

Errors

Related