List catalogs

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

Field	Type	Required	Notes
`advertiserId`	string (path)	Yes	Unique identifier for the advertiser
`type`	enum (query)	No	Filter by catalog type: `offering`, `product`, `inventory`, `store`, `promotion`, `hotel`, `flight`, `job`, `vehicle`, `real_estate`, `education`, `destination`
`take`	integer (query)	No	Results to return. Default `50`, max `250`
`skip`	integer (query)	No	Results 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 account.

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

List available accounts Preview catalog activation

⌘I

Getting Started

Advertisers

Campaigns

Product Discovery

Webhooks

Creatives

Signals & Brand

Audiences & Inventory

Measurement & Conversions

Reporting & Activity

Planning & Governance

Connections

Account & Billing

Request

Parameters

Response

Errors

Advertiser tasks

Advertiser overview

Sync catalogs

​Request

​Parameters

​Response

​Errors

​Related

Advertiser tasks

Advertiser overview

Sync catalogs

Request

Parameters

Response

Errors

Related