Brands

Brands are the core resource of the Brandsearch API. Each brand represents an e-commerce store with rich data including traffic metrics, social media presence, ad activity, product catalogs, and more. On this page, we'll look at the endpoints to list, search, and retrieve brands.

The brand model

The brand model contains extensive data about an e-commerce brand. Below are the most commonly used properties. Use the fields parameter to select exactly which fields you need.

Properties

Name
_id
Type
string
Description
Unique identifier for the brand (typically the domain, e.g., "nike.com").
Name
name
Type
string
Description
The brand name.
Name
title
Type
string
Description
The brand's website title.
Name
description
Type
string
Description
The brand's meta description.
Name
monthly_visits
Type
integer
Description
Estimated monthly website visits.
Name
rank
Type
integer
Description
Global traffic rank.
Name
niche
Type
string
Description
The brand's niche or industry category.
Name
last_meta_active_count
Type
integer
Description
Number of currently active Meta (Facebook/Instagram) ads.
Name
last_meta_total_count
Type
integer
Description
Total number of Meta ads ever created.
Name
product_count
Type
integer
Description
Number of products in the catalog.
Name
avg_price
Type
number
Description
Average product price.
Name
currency_code
Type
string
Description
Product currency code (e.g., "USD", "EUR").
Name
tiktok_followers
Type
integer
Description
TikTok follower count.
Name
instagram_followers
Type
integer
Description
Instagram follower count.
Name
facebook_url
Type
string
Description
Facebook page URL.
Name
instagram_url
Type
string
Description
Instagram profile URL.
Name
tiktok_url
Type
string
Description
TikTok profile URL.
Name
technologies
Type
array
Description
Technologies detected on the website.
Name
created_at
Type
timestamp
Description
Timestamp of when the brand was first indexed.

GET/v1/brands

List all brands

This endpoint allows you to list and search brands with filtering, sorting, and pagination. By default, 20 brands are returned per page.

Optional attributes

Name
page
Type
integer
Description
Page number (1-1000). Default 1.
Name
page_size
Type
integer
Description
Results per page (1-100). Default 20.
Name
monthly_visits_min
Type
integer
Description
Minimum monthly visits filter.
Name
monthly_visits_max
Type
integer
Description
Maximum monthly visits filter.
Name
meta_ads_active
Type
boolean
Description
Filter brands with active Meta ads (true) or without (false).
Name
meta_total_min
Type
integer
Description
Minimum total Meta ads count.
Name
meta_total_max
Type
integer
Description
Maximum total Meta ads count.
Name
sort_by
Type
string
Description
Sort field. One of: monthly_visits, last_meta_active_count, last_meta_total_count, created_at, rank, estimated_sales, interest_score, google_ads_total, combined_followers.
Name
sort_order
Type
string
Description
asc or desc (default desc).
Name
fields
Type
string
Description
Comma-separated list of fields to include in the response.
Name
exclude_fields
Type
string
Description
Comma-separated list of fields to exclude from the default response.

Request

GET

/v1/brands

curl -G https://api.brandsearch.co/v1/brands \
  -H "X-API-Key: bsk_your_api_key" \
  -d page_size=2 \
  -d sort_by=monthly_visits \
  -d meta_ads_active=true

Response

{
  "data": [
    {
      "_id": "nike.com",
      "name": "Nike",
      "title": "Nike. Just Do It.",
      "description": "Inspiring the world's athletes.",
      "monthly_visits": 150000000,
      "last_meta_active_count": 245,
      "last_meta_total_count": 12340,
      "product_count": 2800,
      "rank": 120
    },
    {
      "_id": "adidas.com",
      "name": "Adidas",
      // ...
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 2,
    "total": 85420,
    "total_pages": 42710
  }
}

GET/v1/brands/by-url/:url

Get a brand by URL

This endpoint allows you to retrieve a single brand by its domain URL. You can pass the bare domain (e.g., nike.com) or a full URL (e.g., https://www.nike.com).

Optional attributes

Name
fields
Type
string
Description
Comma-separated list of fields to include.
Name
exclude_fields
Type
string
Description
Comma-separated list of fields to exclude.

Request

GET

/v1/brands/by-url/nike.com

curl https://api.brandsearch.co/v1/brands/by-url/nike.com \
  -H "X-API-Key: bsk_your_api_key"

Response

{
  "_id": "nike.com",
  "name": "Nike",
  "title": "Nike. Just Do It.",
  "description": "Inspiring the world's athletes.",
  "monthly_visits": 150000000,
  "rank": 120,
  "niche": "Athletic Apparel",
  "last_meta_active_count": 245,
  "last_meta_total_count": 12340,
  "product_count": 2800,
  "avg_price": 89.99,
  "currency_code": "USD",
  "tiktok_followers": 5200000,
  "instagram_followers": 302000000,
  "facebook_url": "https://facebook.com/nike",
  "instagram_url": "https://instagram.com/nike",
  "tiktok_url": "https://tiktok.com/@nike",
  "technologies": ["Shopify", "Google Analytics"],
  "created_at": "2024-01-15T00:00:00Z"
}

GET/v1/brands/:brand_id

Get a brand by ID

This endpoint allows you to retrieve a single brand by its ID. The brand ID is typically the domain (e.g., nike.com).

Optional attributes

Name
fields
Type
string
Description
Comma-separated list of fields to include.
Name
exclude_fields
Type
string
Description
Comma-separated list of fields to exclude.

Request

GET

/v1/brands/nike.com

curl https://api.brandsearch.co/v1/brands/nike.com \
  -H "X-API-Key: bsk_your_api_key" \
  -G -d fields=name,monthly_visits,product_count

Response

{
  "_id": "nike.com",
  "name": "Nike",
  "monthly_visits": 150000000,
  "product_count": 2800
}