列出品牌 - OpenLight API

List discoverable brands

curl --request GET \
  --url https://app.openlight.tech/api/creator/v1/brands \
  --header 'Authorization: Bearer <token>'

{
  "brands": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "logo_url": "<string>",
      "website": "<string>",
      "product_count": 123,
      "amazon_regions": [
        "<string>"
      ],
      "amazon_marketplaces": [
        "<string>"
      ]
    }
  ],
  "next_cursor": "<string>"
}

GET

api

creator

brands

List discoverable brands

curl --request GET \
  --url https://app.openlight.tech/api/creator/v1/brands \
  --header 'Authorization: Bearer <token>'

{
  "brands": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "logo_url": "<string>",
      "website": "<string>",
      "product_count": 123,
      "amazon_regions": [
        "<string>"
      ],
      "amazon_marketplaces": [
        "<string>"
      ]
    }
  ],
  "next_cursor": "<string>"
}

使用该接口获取当前创作者 Token 可发现的品牌列表。列表接口支持游标分页：limit 默认 25、最大 100，传入上一页返回的 next_cursor 作为 cursor 可继续读取下一页；没有更多结果时 next_cursor 为 null。响应字段：

id：品牌 ID。
name：品牌名称。
description：品牌简介，可能缺省。
logo_url：品牌 Logo 图片 URL，可能缺省。
website：品牌官网 URL，可能缺省。
status：品牌自身状态，不表示当前创作者与品牌的合作状态。
product_count：当前可见商品数量，可能缺省。
amazon_regions：品牌当前有 active 商品覆盖的 Amazon 国家/地区码，例如 US、UK、DE，可能缺省。
amazon_marketplaces：对应的 Amazon 站点域名，例如 amazon.com、amazon.co.uk、amazon.de，可能缺省。需要展示或判断具体亚马逊站点时优先使用该字段。
partnership_status：当前 Token owner 与该品牌的合作状态，可为 approved、pending、rejected、suspended 或 null。null 表示没有合作记录。

status 和 partnership_status 含义不同：前者是品牌自身状态，后者才是当前创作者与品牌的合作关系。

授权

Authorization

string

header

必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

查询参数

limit

integer

默认值:25

每页返回数量，默认 25，最大 100。Number of items per page; defaults to 25 and maxes out at 100.

必填范围: x <= 100

cursor

string

上一页响应返回的下一页游标。Cursor returned as next_cursor by the previous page.

响应

Creator-visible brands

brands

object[]

必填

品牌列表。List of brands.

Show child attributes

next_cursor

string | null

必填

下一页游标；为 null 表示没有更多结果。Cursor for the next page; null means there are no more results.

列出产品