Version 0.1. Version 0.1 is out. The specification and the software are free to use.

For retailers

Every brand's images and article data, in one consistent way

Brands that use Open Brand Exchange deliver their images and article data in one consistent way, whether you download by hand or use software.

Go to the directory An API key for your software
An article in the brand portal: images per colour, the download choice between original, web and square, and the EAN of every size.

Brand portal

What a brand portal gives you

Every brand runs its own portal, with its own name on it: for example "Kestrel · Brand portal".

  • Request access

    Request access on the brand's portal. The brand approves, and you receive an invitation by email.

  • Search and filter

    By brand, season, collection, product type or colour. Every article with all its images and data.

  • Paste your EAN list

    Paste the EANs from your POS and see right away which articles are there and which are still missing.

  • Download the way you want

    One photo, one article, your selection or everything in a filter as a zip. Original (if the brand allows it), web or square.

  • Article data as a spreadsheet

    EAN per size, colour, material, care and description, ready for your own system.

  • What is allowed

    Usage rights, the embargo date and whether an image was made with AI are shown with every image.

A retailer pastes six EANs into the brand portal: five are found, one is not in the catalog.

Article data

What is on the care label comes with every article.

Composition per part, care instructions in label order and the country of origin are part of every article, next to the EAN of each size. Your shop shows them as text or as care symbols in its own style. The fields follow the EU textile labelling rules and the ISO 3758 care codes, so they can also feed a digital product passport later.

  • Composition per part (outer, lining, filling, sole) with percentages
  • Care instructions as standard codes, in the order of the label
  • Country of origin and the EAN of every size and colour
Example from the test brand

Kestrel Trail · Trail Running Shorts KT-2001 · Black

Composition
Outer: 100% recycled polyesterLining: 88% polyamide, 12% elastane
Care
  1. Machine wash at 30 °C wash_30
  2. Do not bleach do_not_bleach
  3. Do not tumble dry do_not_tumble_dry
  4. Do not iron do_not_iron
  5. Do not dry clean do_not_dry_clean
Made in
Vietnam
Sizes and EAN
Size S: 02000200101017Size M: 02000200101024Size L: 02000200101031
The same article in the API
{
  "style_number": "KT-2001",
  "materials": [
    { "part": "outer", "fibers": [{ "fiber": "recycled_polyester", "percentage": 100 }] },
    { "part": "lining", "fibers": [{ "fiber": "polyamide", "percentage": 88 }, { "fiber": "elastane", "percentage": 12 }] }
  ],
  "care": [
    { "code": "wash_30", "text": null },
    { "code": "do_not_bleach", "text": null },
    { "code": "do_not_tumble_dry", "text": null },
    { "code": "do_not_iron", "text": null },
    { "code": "do_not_dry_clean", "text": null }
  ],
  "country_of_origin": "VN",
  "variants": [
    { "size": "S", "gtin": "02000200101017", "color": { "code": "BLK" } },
    { "size": "M", "gtin": "02000200101024", "color": { "code": "BLK" } },
    { "size": "L", "gtin": "02000200101031", "color": { "code": "BLK" } }
  ]
}

For your software

An API key for your software

Does your PIM, POS or shop software fetch images by itself? Then request an API key for your software. It first fetches everything and after that only the changes, including what the brand withdraws. Images are matched to your articles by EAN.

For your developer: this is what it looks like.

HOST=https://brands.kestrel.example
curl -s $HOST/.well-known/obx                       # what does this brand offer?
TOKEN=$(curl -s -u "$CLIENT_ID:$CLIENT_SECRET" -d grant_type=client_credentials \
  $HOST/obx/v1/oauth/token | jq -r .access_token)
curl -s -H "Authorization: Bearer $TOKEN" "$HOST/obx/v1/changes?limit=500"   # everything, then only changes
curl -s -H "Authorization: Bearer $TOKEN" -X POST -H 'Content-Type: application/json' \
  -d '{"gtins":["2000100101025"]}' "$HOST/obx/v1/products:by-gtin"
# or let the obx tool keep a copy in a folder, only fetching what changed:
OBX_CLIENT_ID=$CLIENT_ID OBX_CLIENT_SECRET=$CLIENT_SECRET obx pull $HOST --out ./kestrel

  • Which software works with it

    Open Brand Exchange is an open standard: any software can support it. Photopilot is building it into its software for retailers, and other vendors can do the same. You do not need any particular software: a browser is enough. Specification for developers.

  • Finding a brand

    Brands that choose to be listed are in the directory. If a brand simply gives you the address of its portal, that works too. Go to the directory.

Is your brand not on it? Send them this

The fastest way to get a brand on board is for stores to ask for it. Copy this email, fill in the brackets and send it to your contact or sales rep at the brand.

More material, such as the brochure for retailers, is on the downloads page. Downloads.