Products

The products endpoint lets you retrieve product catalogs for any brand, including bestsellers and latest additions.

The product model

Each product represents an item in a brand's catalog.

Properties

Name
title
Type
string
Description
The product title.
Name
price
Type
number
Description
The product price.
Name
url
Type
string
Description
Direct URL to the product page.
Name
vendor
Type
string
Description
The product vendor or brand name.
Name
product_type
Type
string
Description
The product category or type.
Name
rank
Type
integer
Description
The product's rank within the catalog.
Name
handle
Type
string
Description
URL-friendly product handle/slug.
Name
status
Type
string
Description
The product status (e.g., active).
Name
description
Type
string
Description
The product description.
Name
created_at
Type
timestamp
Description
When the product was first indexed.
Name
updated_at
Type
timestamp
Description
When the product was last updated.

GET/v1/brands/:brand_id/products

Get products for a brand

This endpoint returns products for a given brand. Products are split into bestsellers and latest collections.

Optional attributes

Name
product_type
Type
string
Description
Filter by collection type. One of: all (default), bestsellers, latest.
Name
fields
Type
string
Description
Comma-separated list of product fields to include.

Request

GET

/v1/brands/nike.com/products

curl -G https://api.brandsearch.co/v1/brands/nike.com/products \
  -H "X-API-Key: bsk_your_api_key" \
  -d product_type=bestsellers

Response

{
  "brand_id": "nike.com",
  "bestsellers": [
    {
      "title": "Air Max 90",
      "price": 130.00,
      "url": "https://nike.com/air-max-90",
      "vendor": "Nike",
      "product_type": "Shoes",
      "rank": 1,
      "handle": "air-max-90",
      "status": "active",
      "created_at": "2024-06-01T00:00:00Z",
      "updated_at": "2025-03-20T00:00:00Z"
    },
    {
      "title": "Dri-FIT Running Tee",
      "price": 35.00,
      "url": "https://nike.com/dri-fit-tee",
      "vendor": "Nike",
      "product_type": "Clothing",
      "rank": 2,
      "handle": "dri-fit-running-tee",
      "status": "active",
      "created_at": "2024-08-15T00:00:00Z",
      "updated_at": "2025-03-18T00:00:00Z"
    }
  ],
  "latest": []
}