List Brands by Sub-Category (V2)

​

Brands filtered by sub-category. Identical to List Brands by Category except that the subcategory parameter filters on the brand’s finer-grained tags; facets.subcategories enumerates the accepted values. New in V2 — there is no V1 equivalent.

Query Parameters
  • subcategory
    Type: string
    max length:  
    200

    Restrict results to a single brand sub-category. Omit to search across every sub-category. The facets.subcategories 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/subcategory
curl https://api.chartmetric.com/api/brand/v2/list/by/subcategory \
  --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