Download CSV Mappings

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

Downloads TikTok Shop SKUs as a CSV file for bulk mapping. Columns: tiktok_sku_id, tiktok_product_id, seller_sku, product_title, sku_name, price, map_to_sku.

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

Unmapped SKUs are included with an empty map_to_sku — those are the rows to fill in. Edit the map_to_sku column and re-upload via Upload CSV Mappings.

scope selects the base set (selected | unmapped | all) and the filters parameters narrow it further. The filters use the same names as the SKU listing endpoint and apply within every scope, so the file matches the rows that listing would return. Archived SKUs are excluded unless filters[archived] is supplied.

A scope that matches nothing returns the header-only template rather than an error.

Authentication: Requires Bearer token.

The response is a text/csv file download, not JSON.

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.