List Vendors

Retrieve vendor summaries with product counts and latest update timestamps

Retrieve a summary of all vendors in the Catalog API, including their product counts and the timestamp of their most recently updated product.

Request

x-api-key · string · required

Your API key for authentication

This endpoint does not support query parameters for filtering, pagination, or search. It returns all vendor summaries in a single response.

Response

vendors · array

Array of vendor summary objects

Show Vendor Summary Object

vendor · string

The vendor/brand name

product_count · number

Total number of products from this vendor

latest_product_update_by_catalog · string

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

in_affiliate_network · boolean

Whether this vendor is part of the affiliate network

Error Responses

error · string

Error message describing what went wrong

details · string

Additional details about the error

code · string

Error code for programmatic handling. Possible values:

• TIMEOUT: Request timeout occurred
• DB_TIMEOUT: Database query timeout
• FUNCTION_NOT_FOUND: Database function not found
• DB_ERROR: Generic database error
• INTERNAL_ERROR: Unexpected server error

cURL

curl -X GET https://api.getcatalog.ai/api/vendors \
  -H "x-api-key: YOUR_API_KEY"

Success Response

{
  "vendors": [
    {
      "vendor": "skims.com",
      "latest_product_update_by_catalog": "2025-07-29T17:54:36.194088+00:00",
      "product_count": 4588,
      "in_affiliate_network": false
    },
    {
      "vendor": "thereformation.com",
      "latest_product_update_by_catalog": "2025-07-27T23:07:49.013718+00:00",
      "product_count": 5029,
      "in_affiliate_network": false
    },
    {
      "vendor": "universalstore.com",
      "latest_product_update_by_catalog": "2025-07-29T20:06:53.282267+00:00",
      "product_count": 7475,
      "in_affiliate_network": false
    }
  ]
}