Brand Feeds | Luigi's Box AI Documentation

Skip to content

Pre-launch API. The concepts described here are settled, but the API shape is not: request and response fields, parameters and defaults can still change. Build against it, and talk to your Luigi's Box contact before you put an integration into production.

Brand feeds describe brand pages and metadata used by discovery experiences. The configured object type is brand.

Core fields

Source field	Type	Requirement	Description
`id`	String	Required	Type-prefixed brand identifier, such as `brand/northwear`.
`title`	String	Required	Brand name shown to users.
`url`	String	Recommended	Canonical brand page URL.
`image_url`	String	Optional	Brand logo or image URL.
`description`	String	Optional	Public brand description.

You can add searchable brand metadata such as country, style, audience, or product line.

Guidance

Use consistent spelling, spacing, and capitalization for source values.
Correct inconsistent product brand values at the source instead of relying on the brand feed to change them.

Examples

<?xml version="1.0" encoding="UTF-8"?>
<brands>
  <brand>
    <id>brand/northwear</id>
    <title>Northwear</title>
    <url>https://example.com/brands/northwear</url>
    <image_url>https://cdn.example.com/brands/northwear-logo.png</image_url>
    <description>Outdoor clothing designed for everyday use.</description>
  </brand>
</brands>

{
  "brands": [
    {
      "id": "brand/northwear",
      "title": "Northwear",
      "url": "https://example.com/brands/northwear",
      "image_url": "https://cdn.example.com/brands/northwear-logo.png",
      "description": "Outdoor clothing designed for everyday use."
    }
  ]
}

id,title,url,image_url,description
brand/northwear,Northwear,https://example.com/brands/northwear,https://cdn.example.com/brands/northwear-logo.png,Outdoor clothing designed for everyday use.

Product feed alignment

Product feeds use the canonical @brand field to reference brand objects by typed brand ID, for example "@brand": "brand/northwear". Use the same stable, typed ID in the product feed and the brand feed so the mapping produces a matching reference.

See also

Was this page helpful?

Thanks.