Skip to main content
Black Hair API gives developers programmatic access to the most comprehensive database of Black and textured hair care products on the internet. Each product in the catalog is enriched with structured ingredient intelligence — including sulphate, silicone, paraben, protein, and moisture flags — so you can surface the right products for your users’ exact curl patterns, porosity levels, and hair concerns. Beyond raw data, the API exposes AI-powered recommendation and reformulation-alert endpoints that help your application stay ahead of formula changes that could affect the hair health of the people you serve.

Quickstart

Make your first API call in under five minutes and start pulling live product data.

Authentication

Learn how to generate and securely pass your bha_ API key on every request.

Hair Profiles

Understand how curl types, porosity, and concerns map to products in the catalog.

Plans & Limits

Compare Starter, Growth, Pro, and Enterprise tiers and their request allowances.

​
Key capabilities

Black Hair API exposes four core capabilities you can combine to build rich, personalized hair care experiences:

Product catalog

Search and filter thousands of products by category, hair type, region, brand ownership, and ingredient flags in a single request.

Ingredient intelligence

Every product carries a machine-analysed ingredient breakdown: sulphates, silicones, parabens, protein level, moisture level, and porosity compatibility.

AI recommendations

Pass a hair profile — curl type, porosity, and concerns — and receive a ranked list of products tailored to that profile, powered by our recommendation engine.

Reformulation alerts

Subscribe to reformulation events so your users are notified the moment a brand changes a product formula, keeping routines built on your app trustworthy.

​
Who is this API for?

Black Hair API is built for developers creating products and services for the natural hair community. Whether you are building a hair-care e-commerce storefront that needs rich, structured product data, a mobile app that recommends routines based on curl type and porosity, a browser extension that surfaces ingredient warnings on retailer pages, or a content platform that tracks brand reformulations — this API gives you the data layer you need without having to scrape, clean, or maintain product information yourself.

​
Data model at a glance

Every product returned by the API carries three nested objects that power the capabilities above:
  • brand — name and is_black_owned flag, so you can filter or badge Black-owned products in your UI.
  • hair_profile — hair_types (e.g. ["3C", "4A"]), porosity (low, medium, or high), and concerns (e.g. ["dryness", "breakage"]).
  • ingredients — boolean flags (has_sulphates, has_silicones, has_parabens), numeric protein_level and moisture_level scores, porosity_match, and a flags array for any additional warnings.
This structure means you can filter the catalog on the server side — passing exclude_sulphates=true or hair_type=4C — and avoid post-processing large result sets in your application.
Black Hair API is currently in v0.1.0 (public beta). Endpoint paths and response shapes are stable, but we recommend subscribing to the changelog before pinning a production release.