The List Brands endpoint returns all hair care brands registered in the Black Hair API catalog. You can search by brand name or filter to return only Black-owned brands. Each brand in the response includes a product_count reflecting the total number of products associated with it — useful for building navigation, filters, or recommendation surfaces in your app.
Endpoint GET https://api.blackhairapi.com/v1/brands/
Header Value Description X-API-Keybha_...Your Black Hair API key. All requests must include this header.
Requests without a valid X-API-Key header return a 401 Unauthorized response. Keep your key secret and never expose it in client-side code.
Query parameters Search brands by name using a case-insensitive partial match. For example, q=mielle returns “Mielle Organics”.
Filter by Black-owned status. Pass true to return only Black-owned brands, or false to return only brands that are not Black-owned. Omit the parameter to return all brands regardless of ownership.
Response A successful request returns HTTP 200 with a JSON object containing a data array of brand objects.
An array of brand objects matching your query. The brand’s unique identifier.
The brand’s display name.
A URL-safe identifier for the brand, derived from the name (e.g., "shea-moisture").
The country where the brand was founded or is headquartered (e.g., "US", "NG").
Whether the brand is Black-owned.
The brand’s official website URL.
The total number of products in the catalog associated with this brand.
Examples curl -G https://api.blackhairapi.com/v1/brands/ \ -H "X-API-Key: bha_your_api_key" \ --data-urlencode "is_black_owned=true"
Example response { "data" : [ { "id" : "f6a7b8c9-d0e1-2345-fabc-678901234567" , "name" : "SheaMoisture" , "slug" : "sheamoisture" , "origin_country" : "US" , "is_black_owned" : true , "website" : "https://sheamoisture.com" , "product_count" : 87 }, { "id" : "b2c3d4e5-f6a7-8901-bcde-f12345678901" , "name" : "Mielle Organics" , "slug" : "mielle-organics" , "origin_country" : "US" , "is_black_owned" : true , "website" : "https://mielleorganics.com" , "product_count" : 34 }, { "id" : "c3d4e5f6-a7b8-9012-cdef-123456789012" , "name" : "Camille Rose" , "slug" : "camille-rose" , "origin_country" : "US" , "is_black_owned" : true , "website" : "https://camillerose.com" , "product_count" : 29 }, { "id" : "d4e5f6a7-b8c9-0123-defa-234567890124" , "name" : "Melanin Haircare" , "slug" : "melanin-haircare" , "origin_country" : "US" , "is_black_owned" : true , "website" : "https://melaninhaircare.com" , "product_count" : 21 }, { "id" : "d4e5f6a7-b8c9-0123-defa-234567890123" , "name" : "Alikay Naturals" , "slug" : "alikay-naturals" , "origin_country" : "US" , "is_black_owned" : true , "website" : "https://alikaynaturals.com" , "product_count" : 18 }, { "id" : "a7b8c9d0-e1f2-3456-abcd-890123456789" , "name" : "Adwoa Beauty" , "slug" : "adwoa-beauty" , "origin_country" : "US" , "is_black_owned" : true , "website" : "https://adwoabeauty.com" , "product_count" : 12 } ] }
Error responses Status Code Description 401UnauthorizedThe X-API-Key header is missing or the key is invalid. 429Too Many RequestsYou have exceeded your plan’s monthly request limit. Upgrade to continue.
