Get Vendors

List all indexed vendors with listing counts, collection counts, and latest update timestamps.

GET /v1/vendors

cURL

PowerShell

curl -X GET "https://api.getcatalog.ai/v1/vendors?page=1&page_size=5" \
  -H "x-api-key: $CATALOG_API_KEY"

Success Response

{
  "data": [
    {
      "vendor": "12thtribe.com",
      "last_updated_by_catalog": "2025-11-16T00:21:21.414453+00:00",
      "listings_count": 1253,
      "collections_count": 42,
      "in_affiliate_network": false
    },
    {
      "vendor": "18east.co",
      "last_updated_by_catalog": "2026-01-04T18:48:00.329426+00:00",
      "listings_count": 387,
      "collections_count": 15,
      "in_affiliate_network": false
    },
    {
      "vendor": "1stclass-vintage.com",
      "last_updated_by_catalog": "2025-11-23T23:02:28.336691+00:00",
      "listings_count": 1484,
      "collections_count": 28,
      "in_affiliate_network": false
    },
    {
      "vendor": "2cuteclothing.com",
      "last_updated_by_catalog": "2025-12-19T17:47:02.397774+00:00",
      "listings_count": 254,
      "collections_count": 8,
      "in_affiliate_network": false
    },
    {
      "vendor": "31philliplim.com",
      "last_updated_by_catalog": "2025-11-23T23:25:40.15897+00:00",
      "listings_count": 2644,
      "collections_count": 56,
      "in_affiliate_network": true
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 5,
    "total_items": 540,
    "total_pages": 108,
    "has_next": true,
    "has_prev": false
  },
  "meta": {}
}

When to use: Discover available vendors before browsing their collections or building a product index. See Building a Product Index.

Request

x-api-key · string · required

Your API key for authentication

page · number

Page number (1-indexed, default: 1)

page_size · number

Items per page (default: 20, max: 100)

Response

data · array

Array of vendor summary objects

Show Vendor Summary Object

vendor · string

The vendor/brand name

listings_count · number

Total number of listings from this vendor

collections_count · number

Total number of collections from this vendor

last_updated_by_catalog · string

ISO 8601 timestamp of the most recently updated listing from this vendor

in_affiliate_network · boolean

Whether this vendor is part of the affiliate network

pagination · object

Pagination metadata

Show Pagination Object

page · number

Current page number

page_size · number

Number of items per page

total_items · number

Total number of vendors available

total_pages · number

Total number of pages

has_next · boolean

Whether there is a next page

has_prev · boolean

Whether there is a previous page

meta · object

Response metadata (currently empty for this endpoint)

cURL

PowerShell

curl -X GET "https://api.getcatalog.ai/v1/vendors?page=1&page_size=5" \
  -H "x-api-key: $CATALOG_API_KEY"

Success Response

{
  "data": [
    {
      "vendor": "12thtribe.com",
      "last_updated_by_catalog": "2025-11-16T00:21:21.414453+00:00",
      "listings_count": 1253,
      "collections_count": 42,
      "in_affiliate_network": false
    },
    {
      "vendor": "18east.co",
      "last_updated_by_catalog": "2026-01-04T18:48:00.329426+00:00",
      "listings_count": 387,
      "collections_count": 15,
      "in_affiliate_network": false
    },
    {
      "vendor": "1stclass-vintage.com",
      "last_updated_by_catalog": "2025-11-23T23:02:28.336691+00:00",
      "listings_count": 1484,
      "collections_count": 28,
      "in_affiliate_network": false
    },
    {
      "vendor": "2cuteclothing.com",
      "last_updated_by_catalog": "2025-12-19T17:47:02.397774+00:00",
      "listings_count": 254,
      "collections_count": 8,
      "in_affiliate_network": false
    },
    {
      "vendor": "31philliplim.com",
      "last_updated_by_catalog": "2025-11-23T23:25:40.15897+00:00",
      "listings_count": 2644,
      "collections_count": 56,
      "in_affiliate_network": true
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 5,
    "total_items": 540,
    "total_pages": 108,
    "has_next": true,
    "has_prev": false
  },
  "meta": {}
}