List Vendors

Retrieve vendor summaries with product counts and latest update timestamps

GET https://catalogai.vercel.app/api/vendors

cURL

curl -X GET https://catalogai.vercel.app/api/vendors \
  -H "x-api-key: YOUR_API_KEY"

Success Response

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

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

The response is an 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_updated_at · string

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

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://catalogai.vercel.app/api/vendors \
  -H "x-api-key: YOUR_API_KEY"

Success Response

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