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 position in the brand's catalogue, best first. It is the real rank, so it may start above 1 and skip values. Products that were never ranked simply have no rank — the key is omitted, as with any other missing field.
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.

The two collections are genuinely different: bestsellers holds only ranked products, best first, while latest is the brand's newest products, most recent first. Up to 10 products are returned per collection.

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. A brand we know but have no products for returns empty arrays.

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"
    }
  ]
}