List Brands by Category (V2)

​

Brands filtered by category, with the brand’s own follower counts on each supported platform.

Replaces GET /api/brand/list/by/interest. Three differences worth noting when migrating:

V1 V2
Response is a map keyed by category name Response is a flat data array with total and facets
Fixed 20 brands per category, brandCount ignored limit / offset honored
followers = summed Instagram followers of artists interested in the brand instagram_followers / tiktok_followers = the brand’s own account followers

The interest_id field has no V2 equivalent: categories are derived tags rather than rows with IDs. Use the category name, which facets.categories enumerates.

Query Parameters
  • category
    Type: string
    max length:  
    200

    Restrict results to a single brand category (e.g. Music, Electronics & Computers). Omit to search across every category. The facets.categories block of the response lists every value accepted here.

  • search
    Type: string
    max length:  
    200

    Free-text search over brand names. Omit to search across every brand.

  • sortColumn
    Type: string enum

    Column used to sort brands. One of name, artistCount, instagramFollowers, tiktokFollowers. Defaults to instagramFollowers.

    values
    • name
    • artistCount
    • instagramFollowers
    • tiktokFollowers
  • sortOrderDesc
    Type: boolean

    If true (default), sort sortColumn in descending order.

  • limit
    Type: integer
    min:  
    1
    max:  
    100

    Maximum number of brands to return. Defaults to 20, max 100.

  • offset
    Type: integer
    min:  
    0

    Number of items to skip from the start of the result set; pair with limit to paginate.

  • countries[]
    Type: array string[]
    min length:  
    2
    max length:  
    2

    Restrict results to brands based in these countries, as ISO 3166-1 alpha-2 codes (e.g. 'US', 'BR').

Responses
  • application/json
Request Example for get/api/brand/v2/list/by/category
curl https://api.chartmetric.com/api/brand/v2/list/by/category \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "data": [
      {
        "id": 138,
        "name": "Apple",
        "image_url": "https://storage.googleapis.com/cm-brand-images/138.jpg",
        "category": "Electronics & Computers",
        "country": "US",
        "description": "Consumer electronics and software company.",
        "instagram_followers": 33500000,
        "tiktok_followers": 2100000,
        "youtube_followers": 19800000,
        "social_links": {
          "instagram": "https://www.instagram.com/apple",
          "tiktok": "https://www.tiktok.com/@apple",
          "youtube": "https://www.youtube.com/@Apple"
        },
        "artist_count": 141435
      }
    ],
    "total": 1,
    "facets": {
      "categories": [
        {
          "name": "Electronics & Computers",
          "count": 412
        }
      ],
      "subcategories": [
        {
          "name": "Smartphones",
          "count": 37
        }
      ],
      "countries": [
        {
          "code": "US",
          "count": 288
        }
      ]
    }
  }
}

Success