Skip to main content
GET /api/v2/buyer/advertisers/{advertiserId}/catalogs Lists catalogs that have been synced for an advertiser. Catalogs are product, offering, or inventory feeds reused by discovery and creative generation.

​
Request

curl
curl "https://api.interchange.io/api/v2/buyer/advertisers/12345/catalogs?type=product&take=50" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldTypeRequiredNotes
advertiserIdstring (path)YesUnique identifier for the advertiser
typeenum (query)NoFilter by catalog type: offering, product, inventory, store, promotion, hotel, flight, job, vehicle, real_estate, education, destination
takeinteger (query)NoResults to return. Default 50, max 250
skipinteger (query)NoResults to skip for pagination. Default 0

​
Response

{
  "catalogs": [
    {
      "catalogId": "summer-sale-2026",
      "platformId": "cat_abc123",
      "type": "product",
      "name": "Summer Sale 2026",
      "url": "https://feeds.acme.com/products.xml",
      "feedFormat": "google_merchant_center",
      "updateFrequency": "daily",
      "itemCount": 1840,
      "lastSyncedAt": "2026-06-06T08:00:00Z",
      "advertiserId": "12345"
    }
  ],
  "total": 1
}
feedFormat is one of google_merchant_center, facebook_catalog, shopify, linkedin_jobs, custom (or null). updateFrequency is realtime, hourly, daily, weekly, or null.

​
Errors

  • 404 NOT_FOUND — advertiserId does not exist or is not visible to the authenticated customer.
See Errors for the full error contract.

Advertiser tasks

All advertiser operations

Advertiser overview

Fields, lifecycle, and concepts

Sync catalogs

Push catalog feeds and items