Products

The products endpoint lets you retrieve product catalogs for any brand, including bestsellers and latest additions. Unlike other list endpoints, products are returned as arrays within a single response object (no pagination).

The product model

Default fields

id, title, price, url, vendor, product_type, rank, created_at

All available fields

Name
id
Type
string
Description
Unique product identifier.
Name
title
Type
string
Description
The product title.
Name
price
Type
number
Description
The product price in USD.
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
type
Type
string
Description
Alternate type classification.
Name
rank
Type
integer
Description
The product's rank within the brand.
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
tags
Type
array
Description
Array of product tags.
Name
variants_count
Type
integer
Description
Number of product variants.
Name
created_at
Type
timestamp
Description
When the product was first added.
Name
updated_at
Type
timestamp
Description
When the product was last updated.
Name
published_at
Type
timestamp
Description
When the product was published on the store.

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. Use product_type to request one or both.

Unlike the brands and ads endpoints, this endpoint does not paginate — it returns all products in each requested collection.

Returns 404 brand_not_found if the brand does not exist.

Optional attributes

Name
product_type
Type
string
Description
Which collection to return. 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": [
    {
      "id": "8234567890",
      "title": "Air Max 90",
      "price": 130.00,
      "url": "https://nike.com/air-max-90",
      "vendor": "Nike",
      "product_type": "Shoes",
      "rank": 1,
      "created_at": "2024-06-01T00:00:00Z"
    },
    {
      "id": "8234567891",
      "title": "Dri-FIT Running Tee",
      "price": 35.00,
      "url": "https://nike.com/dri-fit-tee",
      "vendor": "Nike",
      "product_type": "Clothing",
      "rank": 2,
      "created_at": "2024-08-15T00:00:00Z"
    }
  ]
}