Get Open Collaboration Creator Content Details

GET

/affiliate_seller/202508/open_collaborations/creator_content_details

This API allows a seller to retrieve creator profiles, content counts, and promotion details for a specified product in open collaboration.

Authorizations

• accessToken

Parameters

Query Parameters

shop_cipher

required

string

Identifies the shop. Obtain it from the Get Authorized Shops API.

page_token

string

Pagination token. Omit this parameter or pass an empty string for the first request. For subsequent requests, pass the next_page_token returned by the previous response and reuse the same product_id and page_size.

page_size

required

integer format: int64

>= 1 <= 100

The value of “page_size” must be greater than 0 and less than or equal to 100.

product_id

required

string

The product ID that needs to be queried.

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

next_page_token

Pagination token for the next page. Pass this value as page_token in the next request. An empty token means there are no more results.

string

total_count

Total count of creators that satisfy all the input search conditions.

integer format: int64

creator_content_details

Creator profiles, content counts, and promotion details for the specified product.

Array<object>

object

creator_profile

Creator’s profile details.

object

username

The creator’s username.

string

nickname

The creator’s nickname.

string

follower_count

Number of followers of the creator.

integer format: int64

avatar

The creator’s avatar details.

object

url

The URL for the creator’s TikTok profile avatar.

string

creator_open_id

Creator Open ID. More details

string

video_count

This field indicates the number of videos posted by the creator.

integer format: int64

live_count

This field indicates the number of lives posted by the creator.

integer format: int64

promotion_status

Promotion status of the creator. Field values:

• NORMAL: When the creator is promoting normally, it returns to NORMAL status
• TERMINATING:When the creator is asked by the merchant to terminate the promotion, the status will return to TERMINATING, indicating that the creator’s promotion rights will expire soon.

string

promotion_end_time

End time of creator promotion.

integer format: int64

product

Product details.

object

id

Product’s unique id.

string

image_url

The product image url.

string

Example

{
  "code": 0,
  "data": {
    "next_page_token": "b2Zmc2V0PTEw",
    "total_count": 1,
    "creator_content_details": [
      {
        "creator_profile": {
          "username": "example_creator",
          "nickname": "nickname",
          "follower_count": 10023,
          "avatar": {
            "url": "https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/fa0387fa5a204dcfa44d5be75877a163~tplv-o3syd03w52-origin-webp.webp?from=3478900499"
          },
          "creator_open_id": "uACafQAAAABmUU2qon4R0vUYvUVS3QC6CICP2m5A2-wd77j8R9G0yg"
        },
        "video_count": 101,
        "live_count": 2,
        "promotion_status": "NORMAL",
        "promotion_end_time": 1734682697
      }
    ],
    "product": {
      "id": "1734823553672710512",
      "image_url": "https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/fa0387fa5a204dcfa44d5be75877a163~tplv-o3syd03w52-origin-webp.webp?from=3478900499"
    }
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}