Skip to main content
GET /api/v2/storefront/esa/{esaId}/advertisers Reads the advertiser roster live from the ad server behind an embedded sales agent. Returns the whole roster in one response. Available for AdsWizz sources. Google Ad Manager sources are rejected — a GAM network carries far too many advertisers to read live, so its picker reads the synced cache via GET /esa/{esaId}/gam/advertisers instead. FreeWheel and SpringServe expose no advertiser roster at all. There is no cursor and no filtering. An adapter only reaches this endpoint when its roster is small enough to return whole; if a roster ever outgrows that, it moves to a synced cache with its own paginated endpoint rather than growing parameters here.

​
Request

​
Parameters

​
Response

advertisers[].id is the ad-server advertiser id. name may be null when the ad server does not return one. adapterType echoes which adapter answered, so you do not need to re-read the connection to label the result.

​
Errors

  • 400 VALIDATION_ERROR — esaId is not a positive integer, the source is deactivated, or the ad server has no live advertiser roster read (including Google Ad Manager — use the GAM endpoint instead).
  • 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

The cached roster read for Google Ad Manager sources

Set default advertiser

Pick the catch-all advertiser