Skip to main content

Smart Match SKU to SKU.io Products

POST 
/api/tiktok-shop/integration-instances/:integration_instance_id/products/skus/:product_sku_id/smart-match

Suggest SKU.io Products to map a TikTok Shop SKU (TikTokShopProductSku) to, before the user maps it. Mirrors Shopify's smart-match, but operates at TikTok's per-SKU listing grain (Shopify matches per-variant).

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

The endpoint is keyed on the flattened SKU row ({{product_sku_id}} — the id returned by List Product SKUs). No request body: matching is derived from the SKU's seller_sku, its variant name, and the parent product title.

Match tiers returned in data:

  • exact_match — a non-archived SKU.io Product whose sku exactly equals the TikTok seller_sku (match_type = sku). Null when none.
  • barcode_match — always null for TikTok Shop: TikTok SKUs carry no barcode. The key is retained purely so the shared frontend mapping modal renders identically to Shopify's.
  • similar_matches — up to 5 non-archived fuzzy matches (LIKE on name/sku, plus the first three >2-char words of the parent title), excluding the exact match (match_type = fuzzy).

Returns 403 if the SKU does not belong to the given integration instance.

Authentication: requires a Bearer token (Personal Access Token).

Request​

Responses​

OK

Response Headers
    Content-Type