List brands - 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>"
}

Use this endpoint to list brands discoverable by the current creator token owner. List endpoints use cursor pagination: limit defaults to 25 and cannot exceed 100; pass the previous response’s next_cursor as cursor to read the next page. When there are no more results, next_cursor is null. Response fields:

id: Brand ID.
name: Brand name.
description: Brand description; may be omitted.
logo_url: Brand logo image URL; may be omitted.
website: Brand website URL; may be omitted.
status: The brand’s own status. It does not describe the creator’s partnership state.
product_count: Number of currently visible products; may be omitted.
amazon_regions: Amazon country/region codes where the brand currently has active products, such as US, UK, or DE; may be omitted.
amazon_marketplaces: Amazon marketplace domains, such as amazon.com, amazon.co.uk, or amazon.de; may be omitted. Prefer this field when an integration needs the concrete Amazon site.
partnership_status: The current token owner’s partnership status with the brand. It can be approved, pending, rejected, suspended, or null. null means no partnership record exists.

status and partnership_status are intentionally separate: status belongs to the brand itself, while partnership_status describes the current creator relationship.

Authorizations

Authorization

string

header

required

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

Query Parameters

limit

integer

default:25

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

Required range: x <= 100

cursor

string

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

Response

Creator-visible brands

brands

object[]

required

品牌列表。List of brands.

Show child attributes

next_cursor

string | null

required

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

List products