Generate Campaign Product Promotion Links in Batch

POST

/affiliate_partner/202505/campaigns/{campaign_id}/products/promotion_links/generate_batch

Generate promotion links for multiple products in an online campaign. For OPS or seller-initiated campaigns, use the joined campaign ID created after the partner joins the campaign, not the original campaign ID.

Authorizations

• accessToken

Parameters

Path Parameters

campaign_id

required

string

The ID of the campaign

Query Parameters

category_asset_cipher

string

The partner identifier used in API requests. Retrieve this value by using the Get Authorized Category Assets API.

Request Body

Media typeapplication/json

object

product_ids

The list of product IDs. The max length is 50.

Array<string>

Example^generated

{
  "product_ids": [
    "example"
  ]
}

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

product_promotion_links

The list of products for which the promotion links are generated successfully.

Array<object>

object

product_id

The ID of the product to promote.

string

link

This is the product promotion link that agencies can share with collaborated creators. Creators can copy/paste this link into the web browser. Creators will be re-directed to the add-product-link page in the Tikotk app. Creators can decide whether to add products to their showcases in the pop-up window.

string

failed_product_ids

The list of products for which the promotion links failed to be generated.

Array<string>

Example^generated

{
  "code": 1,
  "message": "example",
  "request_id": "example",
  "data": {
    "product_promotion_links": [
      {
        "product_id": "example",
        "link": "example"
      }
    ],
    "failed_product_ids": [
      "example"
    ]
  }
}