Skip to main content
GET
https://api.getcatalog.ai
/
v2
/
collections
curl -X GET "https://api.getcatalog.ai/v2/collections?vendor=skims.com&page=1&page_size=5" \
  -H "x-api-key: $CATALOG_API_KEY"

{
  "data": [
    {
      "id": "db1a9fa8-4849-4209-bf13-14e4c176a96e",
      "url": "https://www.skims.com/collections/skims-sale",
      "products_total": 926,
      "last_updated_by_catalog": "2025-11-24T06:17:29.338+00:00"
    },
    {
      "id": "44be194a-eae7-4737-a8d1-963cb4ac5c35",
      "url": "https://www.skims.com/collections/fits-everybody",
      "products_total": 545,
      "last_updated_by_catalog": "2025-11-24T05:36:15.802+00:00"
    },
    {
      "id": "f7540f32-06ce-421b-b134-77d4b2b041b5",
      "url": "https://www.skims.com/collections/clothing",
      "products_total": 419,
      "last_updated_by_catalog": "2025-11-24T05:49:21.729+00:00"
    },
    {
      "id": "897be031-3f73-447d-bd56-5d1c49fef1b9",
      "url": "https://www.skims.com/collections/holiday-shop",
      "products_total": 366,
      "last_updated_by_catalog": "2025-11-24T06:23:03.296+00:00"
    },
    {
      "id": "7f882285-7376-4e92-874e-d35ead59a761",
      "url": "https://www.skims.com/collections/bra-panty-sets",
      "products_total": 346,
      "last_updated_by_catalog": "2025-11-24T05:39:37.42+00:00"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 5,
    "total_items": 274,
    "total_pages": 55,
    "has_next": true,
    "has_prev": false
  },
  "meta": {}
}
When to use: Browse vendor collections before fetching products. Use with GET /v2/listings to get products from specific collections.

​
Request

​
x-api-key
string
required
Your API key for authentication
​
vendor
string
required
The vendor/brand name to filter by
​
page
number
Page number for pagination (minimum: 1, default: 1)
​
page_size
number
Number of collections per page (minimum: 1, maximum: 100, default: 20)

​
Response

​
data
array
Array of collection objects
​
pagination
object
Pagination metadata
​
meta
object
Response metadata (currently empty for this endpoint)
The request_id is available in the Request-ID response header for all responses.
curl -X GET "https://api.getcatalog.ai/v2/collections?vendor=skims.com&page=1&page_size=5" \
  -H "x-api-key: $CATALOG_API_KEY"

{
  "data": [
    {
      "id": "db1a9fa8-4849-4209-bf13-14e4c176a96e",
      "url": "https://www.skims.com/collections/skims-sale",
      "products_total": 926,
      "last_updated_by_catalog": "2025-11-24T06:17:29.338+00:00"
    },
    {
      "id": "44be194a-eae7-4737-a8d1-963cb4ac5c35",
      "url": "https://www.skims.com/collections/fits-everybody",
      "products_total": 545,
      "last_updated_by_catalog": "2025-11-24T05:36:15.802+00:00"
    },
    {
      "id": "f7540f32-06ce-421b-b134-77d4b2b041b5",
      "url": "https://www.skims.com/collections/clothing",
      "products_total": 419,
      "last_updated_by_catalog": "2025-11-24T05:49:21.729+00:00"
    },
    {
      "id": "897be031-3f73-447d-bd56-5d1c49fef1b9",
      "url": "https://www.skims.com/collections/holiday-shop",
      "products_total": 366,
      "last_updated_by_catalog": "2025-11-24T06:23:03.296+00:00"
    },
    {
      "id": "7f882285-7376-4e92-874e-d35ead59a761",
      "url": "https://www.skims.com/collections/bra-panty-sets",
      "products_total": 346,
      "last_updated_by_catalog": "2025-11-24T05:39:37.42+00:00"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 5,
    "total_items": 274,
    "total_pages": 55,
    "has_next": true,
    "has_prev": false
  },
  "meta": {}
}