Seller Get Sample Request Deeplink

GET

/affiliate_seller/202512/sample_applications/deeplink

Use this API to get a TikTok deeplink, use this deeplink to launch the TikTok app and land the user on the sample request page.

• The seller can encode the deeplink into an QR code and send it to a creator via email.

Authorizations

• accessToken

Parameters

Query Parameters

shop_cipher

required

string

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

product_id

required

string

The ID of a product that belongs to the authenticated shop. If neither campaign_id nor collaboration_id is provided, the product must be in an active open collaboration.

sku_id

required

string

The ID of a SKU that belongs to the product identified by product_id.

campaign_id

string

If the product belongs to a TAP campaign, campaign_id is required. The specified campaign must be active and contain the product identified by product_id.

Supported campaign types:

• MY_CAMPAIGNS
• SELLER_CAMPAIGNS

collaboration_id

string

If the product belongs to a seller collaboration, collaboration_id is required. Do not provide collaboration_id together with campaign_id.

valid_days

integer format: int64

7 days by default. 14 days maximum. 1 day minimum.

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

deeplink

Use this deeplink to invoke TikTok:

string

Example

{
  "code": 0,
  "data": {
    "deeplink": "snssdk1180://roma_redirect/?_pia_=1&app_key=aaaa&callback_dp_key=f3318dbad42e495eaa12f3b9bec5af92&enter_from=deeplink&product_id=1729504817131129797&roma_group_key=spark_page_seller_free_sample_apply&roma_page_key=p&sample_apply_source=1&sku_id=1729504817131195333&spark_page=seller_free_sample_apply&track_data=%7B%22is_from_selection_scenarios%22%3A%221%22%2C%22selection_channel%22%3A%22deeplink%22%7D"
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}