Skip to main content
GET
/
api
/
creator
/
v1
/
products
List products visible to the creator
curl --request GET \
  --url https://app.openlight.tech/api/creator/v1/products \
  --header 'Authorization: Bearer <token>'
{ "products": [ { "id": "<string>", "brand_id": "<string>", "asin": "<string>", "title": "<string>", "status": "<string>", "commission": { "type": "<string>", "rate": 123, "rate_bps": 123, "flat_cents": 123, "currency_code": "<string>" }, "image_url": "<string>", "detail_page_url": "<string>", "marketplace_id": "<string>", "country_code": "<string>", "price_cents": 123, "currency": "<string>" } ], "next_cursor": "<string>" }
This endpoint returns products for brands where the current creator has an approved partnership. Requests must include brand_id. 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. If the brand’s partnership_status is not approved, this endpoint returns 403 forbidden_resource. Response fields:
  • id: Product ID.
  • brand_id: Brand ID.
  • asin: Amazon ASIN.
  • title: Product title.
  • image_url: Product image URL; may be omitted.
  • detail_page_url: Amazon product detail page URL; may be omitted.
  • marketplace_id: Amazon marketplace ID; may be omitted.
  • country_code: Amazon country/region code; may be omitted.
  • price_cents: Product price in minor currency units; may be omitted.
  • currency: Price currency; may be omitted.
  • status: Product status.
  • commission: Product commission configuration; may be null. When present, it includes type, rate, rate_bps, flat_cents, and currency_code.

Authorizations

Authorization
string
header
required

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

Query Parameters

brand_id
string
required

品牌 ID。Brand ID.

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

Products visible to the creator

products
object[]
required

商品列表。List of products.

next_cursor
string | null
required

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