discover_brands

Use discover_brands for brand-level questions — "Italian streetwear brands", "minimalist Scandinavian labels", "Japanese technical outerwear", "brands with avant-garde tailoring". Semantic search over first-class brand profiles generated during store indexing. Brand country and shipping signals are best-effort and separate from product availability — once you pick a brand from the results, chain to discover_products with the brand filter (or store_domain if you have a domain) to surface actual in-stock items.

Parameters

Search

Parameter	Type	Required	Default	Description
`query`	`string`	No	—	Natural language brand search query. Omit to browse by structured filters alone — provide a query, filters, or both.
`limit`	`number`	No	`8`	Max number of brands to return (1–20)

Focus filters

Parameter	Type	Required	Default	Description
`ships_from_country`	`string`	No	—	ISO-3166 alpha-2 filter for best-effort store shipping origin (e.g. `"IT"`, `"US"`, `"GB"`). Not the same as brand origin.
`style`	`string`	No	—	Style filter — call `get_filters` for current values
`price_tier`	`string`	No	—	Brand price-tier focus filter (e.g. `budget`, `contemporary`, `luxury`)
`category_focus`	`string[]`	No	—	Category focus filters, e.g. `["clothing", "shoes"]`
`gender_focus`	`string[]`	No	—	Audience focus filters, e.g. `["women", "men"]`

Response

{
  "brands": [
    {
      "name": "Acne Studios",
      "about": "Swedish luxury fashion house founded 1996 in Stockholm, known for understated, minimalist ready-to-wear with subtle avant-garde edge.",
      "domains": ["acnestudios.com"],
      "shipsFromCountries": ["SE", "US"],
      "countryOfOrigin": "SE",
      "styles": ["minimalist", "avant-garde"],
      "categories": ["clothing", "shoes", "bags"],
      "materials": ["denim", "leather", "wool"],
      "genders": ["women", "men"],
      "priceTier": "luxury"
    }
  ]
}

Response fields

Field	Description
`name`	Brand display name — pass back as `brand` to `find_similar_brands` or to the `brand` filter on `discover_products`
`about`	Editorial brand bio (1–2 sentences) for brands the LLM confidently knows. Empty for indie brands it can't recall.
`domains`	Known domains the brand sells from
`shipsFromCountries`	Best-effort store shipping origins, ISO-3166 alpha-2
`countryOfOrigin`	Brand origin country (when confident)
`styles`	Canonical style tags
`categories`	Categories the brand covers
`materials`	Frequent materials across the brand's catalog
`genders`	Audience focus, e.g. `["women", "men"]`
`priceTier`	Brand-level price positioning: `value`, `mid`, `premium`, `luxury`, or `ultra-luxury`. Empty until enriched.

Examples

Geographic + style:

{
  "name": "discover_brands",
  "arguments": {
    "query": "Italian streetwear brands"
  }
}

Category focus:

{
  "name": "discover_brands",
  "arguments": {
    "query": "sustainable outerwear brands",
    "category_focus": ["clothing"],
    "gender_focus": ["women", "men"]
  }
}

Shipping origin:

{
  "name": "discover_brands",
  "arguments": {
    "query": "minimalist contemporary",
    "ships_from_country": "JP"
  }
}

For actual in-stock products from a discovered brand, call discover_products with the brand filter (or store_domain if you have a domain from the result). Use find_similar_brands when the user already has a brand in mind and wants alternatives in the same aesthetic neighborhood.