> ## Documentation Index > Fetch the complete documentation index at: https://docs.openlight.tech/llms.txt > Use this file to discover all available pages before exploring further. # List products > List products available to the seller or operator This endpoint returns products for a brand authorized to the current seller or operator token owner. 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`. 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`. ## OpenAPI ````yaml GET /api/seller/v1/products openapi: 3.1.0 info: title: OpenLight Public API version: 1.0.0 summary: OpenLight seller and creator public API description: | Public API for external seller and creator integrations. Console/internal APIs remain documented separately in docs/openapi.yaml. servers: - url: https://app.openlight.tech description: Production - url: http://localhost:8080 description: Local development security: - bearerAuth: [] tags: - name: Creator Brands - name: Creator Products - name: Creator Links - name: Creator Reports - name: Seller Brands - name: Seller Products paths: /api/seller/v1/products: get: tags: - Seller Products summary: List products for an authorized brand description: > Returns products for a brand authorized to the seller or operator token owner. operationId: listSellerProducts parameters: - $ref: '#/components/parameters/BrandIDQuery' - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/Cursor' responses: '200': description: Brand products content: application/json: schema: type: object required: - products - next_cursor properties: products: type: array description: 商品列表。List of products. items: $ref: '#/components/schemas/PublicProduct' next_cursor: $ref: '#/components/schemas/NextCursor' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' components: parameters: BrandIDQuery: name: brand_id in: query required: true description: 品牌 ID。Brand ID. schema: type: string Limit: name: limit in: query required: false description: >- 每页返回数量，默认 25，最大 100。Number of items per page; defaults to 25 and maxes out at 100. schema: type: integer default: 25 maximum: 100 Cursor: name: cursor in: query required: false description: 上一页响应返回的下一页游标。Cursor returned as `next_cursor` by the previous page. schema: type: string schemas: PublicProduct: type: object required: - id - brand_id - asin - title - status - commission properties: id: type: string description: 商品 ID。Product ID. brand_id: type: string description: 品牌 ID。Brand ID. asin: type: string description: Amazon ASIN。Amazon ASIN. title: type: string description: 商品标题。Product title. image_url: type: string description: 商品图片 URL；可能缺省。Product image URL; may be omitted. detail_page_url: type: string description: >- Amazon 商品详情页 URL；可能缺省。Amazon product detail page URL; may be omitted. marketplace_id: type: string description: Amazon marketplace ID；可能缺省。Amazon marketplace ID; may be omitted. country_code: type: string description: Amazon 国家/地区码；可能缺省。Amazon country/region code; may be omitted. price_cents: type: integer description: >- 商品价格的最小货币单位金额；可能缺省。Product price in minor currency units; may be omitted. currency: type: string description: 价格币种；可能缺省。Price currency; may be omitted. status: type: string description: 商品自身状态。Product status. commission: $ref: '#/components/schemas/PublicProductCommission' NextCursor: type: - string - 'null' description: >- 下一页游标；为 null 表示没有更多结果。Cursor for the next page; null means there are no more results. PublicProductCommission: type: - object - 'null' description: >- 商品佣金配置；没有可用佣金时为 null。Product commission configuration; null when no commission is available. required: - type - rate - rate_bps - flat_cents - currency_code properties: type: type: string description: 佣金类型。Commission type. rate: type: number description: 佣金比例。Commission rate. rate_bps: type: integer description: >- 佣金比例的基点值；10000 表示 100%。Commission rate in basis points; 10000 means 100%. flat_cents: type: integer description: 固定佣金的最小货币单位金额。Flat commission amount in minor currency units. currency_code: type: string description: 固定佣金币种。Currency code for flat commission. PublicErrorResponse: type: object required: - error properties: error: type: object description: 错误详情。Error detail. required: - code - message properties: code: type: string description: 机器可读错误码。Machine-readable error code. examples: - invalid_api_token - forbidden_resource message: type: string description: 面向开发者的错误说明。Developer-facing error message. responses: BadRequest: description: Invalid request or pagination parameters content: application/json: schema: $ref: '#/components/schemas/PublicErrorResponse' examples: invalid_request: summary: Invalid request value: error: code: invalid_request message: invalid_request invalid_pagination: summary: Invalid pagination value: error: code: invalid_pagination message: invalid_pagination Unauthorized: description: Missing or invalid API token content: application/json: schema: $ref: '#/components/schemas/PublicErrorResponse' Forbidden: description: Token cannot access the requested role or resource content: application/json: schema: $ref: '#/components/schemas/PublicErrorResponse' examples: forbidden_resource: summary: Forbidden resource value: error: code: forbidden_resource message: forbidden_resource ads_not_connected: summary: Ads not connected value: error: code: ads_not_connected message: ads_not_connected securitySchemes: bearerAuth: type: http scheme: bearer ````