List Product SKPP Statuses

POST

/product/202606/skpps/search

Batch query SKPP status for the seller’s products.

Authorizations

• accessToken

Parameters

Query Parameters

shop_cipher

required

string

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

locale

string

The BCP-47 locale codes for displaying category information. Default: The default locale of your shop. Possible values:

• en
• en-GB
• zh-CN
• de-DE
• id-ID
• it-IT
• ja-JP
• ms-MY
• pt-BR
• th-TH
• vi-VN。

Request Body

Media typeapplication/json

object

product_ids

Product IDs generated by Tiktok Shop; up to 100 per call.

Array<string>

<= 100 items

skpp_status

Optional filter. Possible values:QUALIFIED (already an SKPP product) / NOT_QUALIFIED (not yet meeting the standard, but eligible to take SKPP tasks).

string

page_size

Number of products returned per page. Range: 1–100. Default: 50.

integer format: int64

page_no

Page number, starting from 1. Default: 1.

integer format: int64

Example

{
  "product_ids": [
    "7345678901",
    "7345678902"
  ],
  "skpp_status": "QUALIFIED",
  "page_size": 50,
  "page_no": 1
}

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

products

Product list, each with its SKPP status.。

Array<object>

object

product_id

Product IDs generated by Tiktok Shop

string

title

Product title.

string

skpp_status

Possible values: QUALIFIED / NOT_QUALIFIED

string

affiliate_program_status

Affiliate Program enrolment status. Possible values: ACTIVE / INACTIVE.

string

total_score

Current SKPP total score, as of update_time.

integer format: int64

target_score

Score threshold to qualify for SKPP.

integer format: int64

rewards

Rewards data.

Array<object>

object

reward_type

Possible values: ADS_CREDIT / TOP_CREATOR_MATCHMAKING / SHOPTAB_PV.

string

status

Possible values: NOT_GRANTED (below threshold, locked) / PENDING (qualified, not yet granted) / AVAILABLE (granted).

string

value

Granted amount/quantity; present only when status = AVAILABLE. Currency-typed (ADS_CREDIT) leads with the currency symbol (e.g. $15); count-typed (TOP_CREATOR_MATCHMAKING, SHOPTAB_PV) are bare numbers.

string

ad_credit_claim_status

Ad-credit-only sub-status, returned only when reward_type = ADS_CREDIT and status = AVAILABLE. Possible values: UNCLAIMED (eligible, not yet claimed) / CLAIMED (claimed). Ad credit must be claimed manually.

string

total_count

Total products matching the filter.

integer format: int64

update_time

Date of the offline data snapshot that total_score and rewards are derived from, returned as a Unix timestamp in seconds, pinned to the last second of that date in UTC (23:59:59Z). The value is date-level only — the time component is always 23:59:59 UTC — because the SKPP scoring runs in an offline pipeline with no intraday granularity. Latency is typically T+1 (the evening of day N publishes the day N−1 snapshot) and at most T+2.

integer format: int64

Example

{
  "code": 0,
  "data": {
    "products": [
      {
        "product_id": "7345678901234567890",
        "title": "Premium Cotton T-Shirt",
        "skpp_status": "QUALIFIED",
        "affiliate_program_status": "ACTIVE",
        "total_score": 8,
        "target_score": 7,
        "rewards": [
          {
            "reward_type": "ADS_CREDIT",
            "status": "AVAILABLE",
            "value": "$15",
            "ad_credit_claim_status": "CLAIMED"
          }
        ]
      }
    ],
    "total_count": 1234,
    "update_time": 1779148799
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}