Skip to main content
GET /api/v2/storefront/esa/{esaId}/gam/advertisers Lists the Google Ad Manager advertiser records cached from the network behind a GAM-backed embedded sales agent. Use it to find the id you pass when setting the default advertiser or a buyer-specific mapping target. Results are cursor-paginated; filter by name or numeric id with q.

​
Request

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

​
Parameters

FieldTypeRequiredNotes
esaIdintegerYesPath. Embedded sales-agent connection id
qstringNoQuery. Advertiser name substring or exact numeric advertiser id
querystringNoQuery. Alias for q
limitintegerNoQuery. Page size, max 500
cursorstringNoQuery. Pagination cursor from a prior nextCursor

​
Response

{
  "advertisers": [
    {
      "id": "4567890123",
      "name": "Acme Beverages",
      "status": "ACTIVE",
      "currencyCode": "USD"
    }
  ],
  "nextCursor": "eyJvZmZzZXQiOjUwfQ",
  "syncedAt": "2026-06-01T09:30:00.000Z"
}
advertisers[].id is the GAM advertiser id you pass as gamAdvertiserId. nextCursor is null on the last page. syncedAt is when the cache was last refreshed from the network, or null if it has never synced. currencyCode may be null.

​
Errors

  • 400 VALIDATION_ERROR — esaId is not a positive integer, or the ESA is not Google Ad Manager-backed.
See Errors for the full error contract.

Buyer routing tasks

All buyer-routing operations

Buyer routing overview

How buyers resolve to advertisers

Ensure GAM advertiser

Create or find an advertiser by name

Set default advertiser

Pick the catch-all advertiser