> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List catalogs

> See the catalog feeds synced for an advertiser

`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

```bash curl theme={null}
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

```json theme={null}
{
  "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](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Advertiser tasks" href="/v2/buyer/advertisers/tasks" icon="list-check">
    All advertiser operations
  </Card>

  <Card title="Advertiser overview" href="/v2/object-guides/advertiser" icon="user-tie">
    Fields, lifecycle, and concepts
  </Card>

  <Card title="Sync catalogs" href="/v2/buyer/advertisers/tasks/sync-catalogs" icon="arrows-rotate">
    Push catalog feeds and items
  </Card>
</CardGroup>