> ## Documentation Index
> Fetch the complete documentation index at: https://api.nektir.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Browse brands

> Build reviewed brand directories and brand pages without treating unreviewed source text as identity.

Nektir publishes only reviewed consumer brands. Products whose brand is unresolved remain searchable, but they do not appear in the brand directory and return null brand identifiers.

## Browse or search brands

```bash theme={"dark"}
curl "$NEKTIR_API_BASE/v1/brands?q=high%20west&limit=25"
```

Each row includes a stable brand ID and slug, current product and family counts, represented category IDs, and the latest successful inventory retrieval among its products. Counts and timestamps belong to the response's `X-Publication-Revision`.

```json theme={"dark"}
{
  "id": "<brand-uuid>",
  "slug": "high-west",
  "name": "High West",
  "product_count": 24,
  "family_count": 3,
  "category_ids": ["cat_premixed_cocktails", "cat_whiskey"],
  "inventory_retrieved_at": "<retrieval-time-or-null>"
}
```

Use `category_ids` to build a category-specific directory. Sorting is deterministic with `sort=name` or `sort=-name`; follow the opaque cursor in `meta.page.next_cursor`.

## Load reviewed aliases

```bash theme={"dark"}
curl "$NEKTIR_API_BASE/v1/brands/<brand-uuid>"
```

Brand detail adds `aliases`, the public reviewed spellings used by search. Candidate, rejected, and internal matching rules are never returned. An alias may describe a marketed title while the reviewed brand represents a parent identity, so applications should display `name` and treat aliases as search/navigation metadata.

## Browse products and families

Use the returned stable ID instead of sending brand text back to the API:

```bash theme={"dark"}
curl "$NEKTIR_API_BASE/v1/products?brand_ids=<brand-uuid>&sort=name"
curl "$NEKTIR_API_BASE/v1/product-families?brand_ids=<brand-uuid>&sort=name"
```

One brand can span multiple categories and product families. Brand, producer, corporate owner, and product family remain separate concepts.