# Black Hair API

## Docs

- [GET /v1/alerts/reformulations — Formula Change Alerts](https://docs.blackhairapi.com/api/alerts/reformulations.md): Retrieve a paginated list of detected ingredient formula changes across tracked products, with before-and-after snapshots and severity ratings.
- [GET /v1/brands/{id} — Retrieve a Single Hair Care Brand](https://docs.blackhairapi.com/api/brands/get.md): Fetch a single hair care brand by its UUID, including its description, social handles, and a count of its associated products.
- [GET /v1/brands — List and Search Hair Care Brands](https://docs.blackhairapi.com/api/brands/list.md): Retrieve all hair care brands in the Black Hair API catalog, with optional filters for brand name and Black-owned status.
- [GET /v1/ingredients/products — Find Products by Ingredient](https://docs.blackhairapi.com/api/ingredients/by-product.md): Search the Black Hair API product catalog for items containing a specific ingredient, or find products that deliberately exclude it.
- [GET /v1/ingredients/lookup — Analyze an Ingredient](https://docs.blackhairapi.com/api/ingredients/lookup.md): Use AI-powered analysis to retrieve safety, compatibility, porosity guidance, and buildup risk for any hair care ingredient by name.
- [GET /v1/products/{id} — Retrieve a Hair Care Product](https://docs.blackhairapi.com/api/products/get.md): Fetch a single hair care product by its UUID, with an option to expand the full parsed ingredient analysis in the same request.
- [GET /v1/products — List and Search Hair Care Products](https://docs.blackhairapi.com/api/products/list.md): Search and filter the full Black Hair API product catalog by name, hair type, category, ingredient exclusions, and brand ownership.
- [POST /v1/recommend/ — AI Hair Product Recommendations](https://docs.blackhairapi.com/api/recommend.md): Generate ranked, AI-powered product recommendations tailored to a customer's curl pattern, porosity, concerns, and optional budget ceiling.
- [Authentication: Secure Every Black Hair API Request](https://docs.blackhairapi.com/authentication.md): Learn how to generate, pass, and protect your Black Hair API key to authenticate every request to the /v1/ endpoints and handle auth errors correctly.
- [Hair Profiles: Match Products to Textured Hair Types](https://docs.blackhairapi.com/concepts/hair-profiles.md): Hair profiles describe curl pattern, porosity, texture, and concerns so the API can filter and rank products for Black and textured hair.
- [Ingredient Analysis: AI-Powered Curl Safety Ratings](https://docs.blackhairapi.com/concepts/ingredient-analysis.md): The API uses GPT-4o-mini to analyse every ingredient and return structured safety, porosity compatibility, and buildup risk data for textured hair.
- [Black Hair API Plans, Rate Limits, and Feature Access](https://docs.blackhairapi.com/concepts/plans-and-limits.md): Understand the four API tiers — Starter, Growth, Pro, and Enterprise — their monthly request caps, per-minute rate limits, and feature availability.
- [AI-Powered Hair Product Recommendations via the API](https://docs.blackhairapi.com/guides/ai-recommendations.md): Send a hair profile to the Black Hair API and receive ranked product picks with plain-English explanations matched to hair type, porosity, and concerns.
- [Track Product Formula Changes with Reformulation Alerts](https://docs.blackhairapi.com/guides/reformulation-alerts.md): Monitor ingredient list changes across the Black Hair API catalog and get notified when a brand reformulates a product you care about.
- [Search and Filter Hair Care Products Using the API](https://docs.blackhairapi.com/guides/search-products.md): Search the Black Hair API catalog by keyword, hair type, category, and ingredient flags to surface the right products for any hair profile.
- [Black Hair API: Capabilities, Data Model, and Use Cases](https://docs.blackhairapi.com/introduction.md): Discover what Black Hair API offers: a product catalog with ingredient intelligence, AI recommendations, and reformulation alerts for textured hair apps.
- [Quickstart: Make Your First Black Hair API Request](https://docs.blackhairapi.com/quickstart.md): Get your API key, make your first authenticated request to the product catalog, and parse a real ingredient response — all in under five minutes.