Get Product SKPP Detail

GET

/product/202606/skpps/{product_id}

Return the SKPP qualification status, current and target scores, task progress and suggested actions, reward eligibility and status, and offline snapshot time for one product. This API is available only to sellers authorized for SKPP in the US market.

Authorizations

• accessToken

Parameters

Path Parameters

product_id

required

string

Product ID generated by Tiktok Shop.

Query Parameters

shop_cipher

required

string

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

locale

string

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

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

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_id

Platform product ID.

string

affiliate_program_status

Affiliate Program enrolment. 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

Reward list.

Array<object>

object

reward_type

Possible values: ADS_CREDIT / TOP_CREATOR_MATCHMAKING / SHOPTAB_PV / BIG_PROMOTION_CAMPAIGN / OFF_PLATFORM_BESTSELLER_ADS_CREDIT.

string

title

Localized reward name, resolved from the shared Seller-Center content by the request locale.

string

status

Possible values: NOT_GRANTED / PENDING / AVAILABLE

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).

string

value

Granted amount/quantity; currency-typed values lead with the currency symbol.

string

claim_conditions

Thresholds to unlock the reward; used by ADS_CREDIT.

Array<object>

object

condition_type

Possible values: GMV / ORDER.

string

current_value

Current progress; GMV-typed values lead with the currency symbol.

string

target_value

Threshold value; same formatting as current_value.

string

campaign_id

Returned only for reward_type = BIG_PROMOTION_CAMPAIGN.

string

task_details

Per-category score breakdown with suggested actions.

Array<object>

object

category

Key for the scoring category. Possible values:

• COMMISSION_RATE
• FULFILMENT
• PRICING
• FREE_SHIPING
• FOLLOWER_BENEFITS
• SAMPLING
• ADS_SPEND
• STOCK
• SHOPPABLE_VIDEOS
• INFORMATION_QUALITY
• CRM_HOSTING

string

Allowed values: COMMISSION_RATE FULFILMENT PRICING FREE_SHIPING FOLLOWER_BENEFITS SAMPLING ADS_SPEND STOCK SHOPPABLE_VIDEOS INFORMATION_QUALITY CRM_HOSTING

name

Localized category name, resolved from category via the shared content by the request locale.

string

current_value

Current value of this dimension’s metric (e.g. current price, commission rate, free-shipping status).

string

target_value

The threshold this dimension must reach to pass. It uses the same unit as current_value and may include a leading comparison operator, such as ≥ or ≤, to show the required direction.

string

passed

Whether this dimension meets its target_value.

boolean

action_suggestions

Suggested actions to complete this task; returned only when passed = false. A task may have multiple suggestions.

Array<object>

object

score_increase

SKPP points added to total_score when this action is completed; for tiered actions, the maximum tier.

integer format: int64

url

Link to the Seller Center page that completes the action.

string

update_time

Date of the offline data snapshot that total_score, rewards and the score breakdown 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

skpp_status

Possible values: QUALIFIED / NOT_QUALIFIED / NOT_ELIGIBLE.

string

Example

{
  "code": 0,
  "data": {
    "product_id": "7311223344556677889",
    "affiliate_program_status": "ACTIVE",
    "total_score": 6,
    "target_score": 8,
    "rewards": [
      {
        "reward_type": "BIG_PROMOTION_CAMPAIGN",
        "title": "Ad credit reward",
        "status": "AVAILABLE",
        "ad_credit_claim_status": "UNCLAIMED",
        "value": "100",
        "claim_conditions": [
          {
            "condition_type": "GMV",
            "current_value": "72",
            "target_value": "100"
          }
        ],
        "campaign_id": "7390000000000000000"
      }
    ],
    "task_details": [
      {
        "category": "INFORMATION_QUALITY",
        "name": "Improve product title",
        "current_value": "12",
        "target_value": "20",
        "passed": false,
        "action_suggestions": [
          {
            "score_increase": 8,
            "url": "https://seller.tiktokglobalshop.com/product/edit"
          }
        ]
      }
    ],
    "update_time": 1779148799,
    "skpp_status": "QUALIFIED"
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}