Download CSV Mappings

GET 
/api/tiktok-shop/integration-instances/:integration_instance_id/products/csv-mappings

Download a CSV of TikTok Shop SKU → SKU.io product mappings, scoped by selection, unmapped-only, or all (filtered).

Authorization

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

Columns: tiktok_sku_id, tiktok_product_id, seller_sku, product_title, sku_name, price, map_to_sku.

Users edit the map_to_sku column then re-upload via the upload endpoint to bulk-apply mappings. Mirrors Shopify's bulk mapping CSV flow but operates per-SKU (TikTok lists each SKU as its own variant).

Returns a binary CSV download (Content-Type: text/csv).

Request

Responses

200

Successful response

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.

404

Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.

429

Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.