search_brands is an experimental, read-only discovery task. It returns ranked public brand stubs from a brand agent’s roster. Use the returned brand_id with get_brand_identity for full identity data or get_rights for licensing terms.
Schema
- Request:
search-brands-request.json - Response:
search-brands-response.json
Request
query is required. Callers can additionally constrain results with industries, countries, or buyer_brand. When buyer_brand is supplied, the agent should omit brands whose licensing restrictions make them incompatible.
Response
brands array is a successful response when no roster entry matches. Results are lightweight public stubs; authorized assets, detailed identity fields, and pricing remain on the follow-up tasks.
Fields
Each result includes
brand_id and localized names; house is present when a house affiliation is on record. relationship_trust reports whether that affiliation is reciprocated: only mutual and inline extend trust to house.domain. leaf_only, house_only, and unverifiable are one-sided or unverified states, while standalone means the brand declares no house. A missing relationship_trust means the agent has not computed a verdict and MUST NOT be interpreted as standalone. claimed_house_domain preserves a leaf’s unverified parent claim, and relationship_verified_at records the last bilateral confirmation for mutual results.
Other public discovery fields such as description, industries, logos, architecture type, and rights availability are optional.