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. On /mcp/v3, Buyer Accounts use search(kind: "catalog") for the same advertiser-scoped collection and get(kind: "catalog", id, advertiserId: "12345") for one catalog. The get read can include a bounded page of items for creative selection; continue with its cursor rather than fetching an unbounded feed.

Request

curl

curl "https://api.apostra.com/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

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

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