TikTok Shop MCP server for your AI

Activate hidden products that are in the Seller_deactivated or Platform_deactivated status and display them in the TikTok Shop catalog… Required body fields: product_ids.

Identify any issues with your product properties in advance to ensure your product is ready for listing.

Create and list products intended for sale exclusively in local shops.

Deactivate products that are in the Activate status and hide them from buyers.

Delete non-frozen products that you no longer need.

Edit all properties (e.g.

Retrieve the standard built-in product and sales attributes for listing a product in a particular category based on your shop's location… * Sales attributes (e.g.

Retrieve all available brands for your shop, including the built-in brands and any custom brands created using the Create Custom Brands API… * To check if a brand is fully authorized for use in a specific product category, specify the category ID.

Retrieve the list of product categories available for your shop.

Retrieve the additional requirements (beyond mandatory product attributes) for listing a product in a particular category based on your shop's location.

Retrieve all properties of a product, except those in the FREEZE or DELETED status.

Retrieve inventory information for multiple products or SKUs.

Edit some properties (e.g.

Retrieve the recommended category for a candidate product based on its title, description, and images.

Retrieve a list of products that meet the specified conditions.

Update the inventory quantity of SKUs belonging to a product.

Update the price of multiple SKUs belonging to a product in the ACTIVATE status and not included in any ongoing promotions.

Retrieve all open collaboration information from merchants, including commission rate, add to showcase and post content creator count.

This API allows the partner to retrieve a list of affiliate orders (orders which are affiliate-commission eligible) generated by a seller, returning the order ID and the product ID… ---

This API is used by Sellers to search for Creators in the Creator Marketplace.

Get the top 100 performing products of the target date range ---

Returns performance metrics at shop/seller level.

Returns a list of product performance overview metrics.

Returns a list of SKU performance metrics.

Returns a list of videos and associated metrics for a shop.

Returns the SPS overview for the authorized shop, including the score, tier, dimensions, benefits, and top issues.

Use this API to batch ship packages by providing multiple package IDs.

Use this API to ship orders (purchase labels).

Use this API ( for US ) to query the list of available shipping services when specifying packages' size or weight.

Returns information about a package, including handover time slot, tracking number, and shipping provider information.

For orders shipped by TikTok Shop, this API retrieves the URL of shipping documents (shipping label and packing slip) for a package specified by the package ID.

This API can use the order number to obtain the corresponding logistics tracking information.

Retrieve package IDs based on specified conditions.

Use this API to ship a package.

Use this API to confirm an order split.

If the seller entered an incorrect tracking number, this API allows the seller to update the tracking number and shipping provider for an order that has already been shipped.

Use this API to approve a buyer-initiated cancellation request identified by cancel_id.

Use this API to approve a buyer's return request.

Use this API to estimate the refundable amount for a cancellation, refund, or return-and-refund request.

Use this API to retrieve the seller reject-reason options currently applicable to the specified aftersales request.

Use this API to reject a buyer's return or refund request.

Used to search for aftersales request level data.

Use this API to search and retrieve one or more order cancellations.

Use this API to search returns by return ID, order ID, buyer, return type, return status, arbitration status, or create/update time window.

Use this API to get all messages in a conversation between a buyer and a shop.

Use this API to retrieve a shop's conversations with buyers.

Use this API to mark all messages sent by the buyer as read.

Use this API to send a message to the buyer in a conversation.

Use this API to create a product discount activity or a flash deal activity.

Get the details of a product discount or flash deal promotion activity.

Use this API to get a list of coupons, narrowed down further based on search parameters.

Get a list of product discount or flash deal promotion activities.

Use this API to add the products or SKUs to the list of a product discount activity or a flash deal activity.

Get the detailed order information of an order, including important attributes such as order status, shipping addresses, payment details, price and tax info, and package information.

Returns a list of orders created or updated during the timeframe indicated by the specified parameters.

Get the detailed pricing calculation information of an order or a line item, including vouchers, tax, etc.

If you have used the Add External Order References API to sync information from your external order management system (OMS) to corresponding orders in TikTok Shop, you may call this API to search for order information in TikTok Shop based o… ---

This API is used to obtain the shipping provider corresponding to the specified delivery option ---

This API is used to obtain a list of delivery options available through the seller's designated warehouse.

This API retrieves all warehouse information associated with the seller.

This API is currently unavailable to SEA markets.

Retrieves the statements generated for a shop and the key statement information based on a specified date range or their payment status… ---

Retrieves the SKU-level details of an order transaction.

Retrieves the details of a statement, including the transactions, which can be a standard order transaction, an adjustment transaction, or a reserve-related transaction… ---

Retrieves all active shops that belong to a seller.

Retrieves the cross-border operations that a cross-border seller is permitted to perform.

Retrieves the list of shops that a seller has authorized for an app.

Check if a TikTok shop is ready to list products.

Create a task to upgrade live products (status: ACTIVATE) from a 3-level to a 7-level category tree.

Create custom brands for your own use across all markets.

Create global products to be sold in one or multiple shops outside of the seller's base country.

This interface is only available for EU L2L sellers.

Initiates a translation task for one or more images.

Add a manufacturer for a seller.

Add a new EU responsible person who ensures a seller's products comply with EU regulations.

Delete global products that you no longer need.

Diagnose products to obtain information that helps you to improve the product content, enhancing product visibility and customer trust.

Edit all properties (e.g.

Retrieve the standard built-in product and sales attributes for listing a global product in a particular category, regardless of market variations… * Sales attributes (e.g.

Retrieve all available product categories, regardless of market variations.

Retrieve the additional requirements (beyond mandatory product attributes) for listing a global product in a particular category, regardless of market variations… ---

Retrieves the global listing rules for a local shop that belongs to a global seller.

Retrieve all properties of a global product that is in the "DRAFT", "UNPUBLISHED", or "PUBLISHED" status, and the corresponding local product IDs in the published markets.

Retrieves the globally associated replicas in other markets if the product has been replicated through local replication.

Retrieves the image translation task status and translated images for one or more previously submitted images.

Retrieve the full details of a single opportunity lead by its ID, including market trend data, competition level, and recommended actions.

Return the SKPP diagnostic for one product.

Obtain SEO suggestions for product titles of live products (status: ACTIVATE) to enhance product visibility.

Retrieve a list of product recommended packages.

Obtain AI-optimized product titles and descriptions for live products (status: ACTIVATE).

Return the shop-level SKPP products roll-up.

Retrieve a paginated list of submission records for the authorized seller, including submission status, review results, and linked opportunity/product information.

Search and retrieve a paginated list of opportunity leads available to the authorized seller, with optional filters by type, status, category, etc and ordered by the algorithm ranking model.

Batch query SKPP status for the seller's products.

Optimize images used in your TikTok Shop by changing the background to white.

Description of [POST]/product/:version/Partial_Edit_Global_Product ---

Edit the details of a manufacturer in the EU languages supported by TikTok Shop.

Edit the details of an EU responsible person in the EU languages supported by TikTok Shop.

For compliant vendor to rescan all of the product information so that the compliant vendor can issue a compliance testing report.

Diagnose multiple existing live (status: ACTIVATE) products to obtain information that helps you to improve the product content, enhancing product visibility and customer trust.

Publish and convert a global product to local products in one or multiple shops in supported markets.

Retrieve the recommended categories for a candidate global product based on its title, description, and images.

Recover products that are in the Deleted status.

Description of [POST]/product/:version/Replicate_Product ---

Retrieve a list of global products that meet the specified conditions.

Retrieve a list of manufacturers in the EU languages supported by TikTok Shop based on their IDs or keyword.

Retrieve a list of responsible persons in the EU languages supported by TikTok Shop based on their ID or keywords.

Retrieve size charts that a seller has created.

#### Appeal Size Chart Verification Initiates an appeal process for a product that was blocked during the listing phase due to a size chart verification failure… Required body fields: product_id, appeal_message.

Submit an existing product (already listed on TikTok Shop) as a response to a specific opportunity lead.

Update the inventory of unpublished global products if you have access to the Multi-Warehouse feature.

This API allows sellers to configure auto-replenishment settings for one or more SKUs in bulk.

NOT CALLABLE OVER THIS CONNECTION: this endpoint takes a multipart/form-data file upload (data), which this MCP cannot send.

NOT CALLABLE OVER THIS CONNECTION: this endpoint takes a multipart/form-data file upload (data), which this MCP cannot send.

Execute resolution actions on resolvable conflict items within the scope of seller authorization.

Retrieve conflicting target collaborations for the product and determine if they can be terminated Required body fields: creator_open_id_list, product_id_list.

Create an asynchronous offline export task for the specified doc_type and plan_type within a given time window.

Get the existing conversation or create a new conversation with the specified TikTok creator for later communication.

This API allows the seller to create an open collaboration.

This API is used to create a target collaboration.

Download the result file of a completed export task by taskId.

Use this API to manage sample rules in open collaborations, like valid time periods, or thresholds for creators to request samples.

This API is used to edit a Seller's open collaboration settings.

The user of this API is a partner developer, on behalf of Sellers.

Generate a Target Collaboration Link that the seller can share with the creator.

Get chat history in one conversation.

Get User's Conversation list.

Retrieve the list of export tasks created via Open API for the authorized seller (last 7 days).

This API allows you to obtain the advanced filters available in Seller Search Creator Marketplace.

Description of [POST]/affiliate_seller/:version/Get_Inbox_Category_Counts ---

Get the unread messages from the last minute.

Get the Creator Affiliate's Marketplace information and performance metrics in the last 30 days.

This API allows the seller to get the creator content details of specified open collaboration.

Use this API to get the status and the details of the sample rules for products under an open collaboration.

Get the open collaboration settings, including auto add settings.

Description of [POST]/affiliate_seller/:version/Get_Weekly_Creator_Outreach_Records Required body fields: page_index, page_size.

Mark the messages in the specified conversations to be read.

This API is used by Sellers to get target collaboration information.

Description of [POST]/affiliate_seller/:version/Query_Creator_Promotion_Details_in_Target_Collaboration Required body fields: creator_user_open_id, invitation_group_id.

This API is used to remove creators from open collaboration.

Remove open collaboration for product.

This API is used by Seller to remove affiliate target collaboration.

This API is used by Seller to search for all existing target collaborations.

Use this API to get a TikTok deeplink, use this deeplink to launch the TikTok app and land the user on the sample request page.

This API allows the seller to approve or reject the creator's sample application in an open collaboration.

This API is used to search the information of products with open collaboration by category, commission rate, and keywords.

This API is provided for sellers to query sample applications based on various criteria such as products, creators, or application statuses… ---

You, the seller, can use this API to get the fulfillment status of the specific sample application and whether the fulfillment resulted in orders… ---

The API for sending IM messages.

Description of [POST]/affiliate_seller/:version/Update_Conversation_Status Required body fields: action.

This API is used by Seller to update STANDARD target collaboration.

NOT CALLABLE OVER THIS CONNECTION: this endpoint takes a multipart/form-data file upload (data), which this MCP cannot send.

Get the top 100 performing creators of the target date range ---

Get the top 100 performing lives of the target date range ---

Get the top 100 performing videos of the target date range ---

Returns core stats for the specified live room, including GMV, order counts, buyer counts, product click counts, and view counts.

Returns GMV trend performance points for the specified live room, including GMV and created-order trend values.

Returns interactive trend performance points for the specified live room, including watch, comment, and share counts.

Returns the product list for the specified live room, including product IDs, names, GMV, unit price, inventory counts, and click counts.

Returns traffic performance for the specified live room, including source and sub-source watch counts for distribution analysis.

Returns user portrait indicators for the specified live room, including age, gender, fan, advertisement, and region distributions.

Returns viewer count trend data points for the specified live room, grouped by online, entering, and leaving viewers.

Returns minute-level performance for a LIVE session after the session is finished.

Returns a list of LIVE stream sessions and associated metrics for a shop.

Returns overall performance metrics for all LIVE stream sessions under a certain shop.

Returns sale performance for each product in a shop-related LIVE session from the official account or marketing accounts.

Returns hourly shop performance details for the requested date.

Returns detailed performance metrics for the specified product.

Returns performance metrics for the specified SKU.

Returns detailed performance metrics for a (requested) video.

Returns overall performance metrics for all videos under a shop.

Returns performance metrics for a list of products promoted in a given video.

Returns diagnosis details for a single SPS metric, including benchmark thresholds, trends, calculation details, and distribution details.

Returns problem order or chat details for a selected SPS metric.

Returns top products, logistics providers, or aftersales types for a selected SPS metric.

Returns SPS metric details and benchmark thresholds for the authorized shop.

Use this US-creator-only API to retrieve TikTok e-commerce video metrics, including anchor_display_rate, click_through_rate, orders, items_sold, and GMV, for the requested videos.

Use this API to combine packages into one fulfillment package.

If you send multiple packages to TikTok Shop warehouse in a single first-mile bundle, you can use the API to create a first-mile bundle on TikTok Shop and get the bundle ID.

If you send multiple packages to TikTok Shop warehouse in a single first-mile bundle, you can use the API to create a first-mile bundle on TikTok Shop and get the bundle ID.

NOT CALLABLE OVER THIS CONNECTION: this endpoint takes a multipart/form-data file upload (data), which this MCP cannot send.

NOT CALLABLE OVER THIS CONNECTION: this endpoint takes a multipart/form-data file upload (data), which this MCP cannot send.

This API is used to query whether an order requires extra customs clearance information, whether such information has been submitted, and the list of submitted customs clearance information… Required body fields: order_ids.

Use this API to check whether an order(s) can be split into multiple packages or not.

Use this API to retrieve the time slots available for pickup, drop-off, or van collection for the seller's specified package by using package ID.

Description of [POST]/fulfillment/:version/Get_Pod_Detail Required body fields: main_order_id, query_order_lines.

This API is currently exclusive to the following markets: US, UK, ES, IE, IT, DE, FR, JP.

Send the redeem info related to the order to the TTS to complete the fulfillment.

Use this API to query orders eligible for combined shipping.

Use this API to uncombine one or more orders from an already combined package.

Use this API to update the delivery status of the package from in transit status.

If the seller entered an incorrect tracking number, this API allows the seller to update the tracking number and shipping provider for a package that has already been shipped… Required body fields: tracking_number, shipping_provider_id.

This API is used to submit extra customs clearance information for discrepancies between declared information and physical goods.

Upload the invoice document.

Enables a seller or warehouse to validate whether a tracking number is covered by TikTok Shipping (TTS) or Collection by TikTok (CBT).

After an order is shipped via FBT, an MCF Order may be split into one or more consign orders for fulfillment.

This API is used to cancel an inbound order prior to warehouse arrival, preventing further processing and updating the order status… Required body fields: order_id, cancel_reason.

Finalize the selection of a specific warehouse placement option for a Fulfilled by TikTok (FBT) inbound plan.

Create FBT goods records, including SKU linkage, dimensions, hazmat details, shelf-life attributes, and return address information.

For orders created on other sales channels that require fulfillment via FBT, this API enables you to create corresponding orders (hereinafter referred to as MCF Orders)… Required body fields: external_order_id, goods, consignee.

Initializes a new inbound plan or updates an existing one by defining goods, or carton configurations and dimensions.

This API is used to retrieve the inbound order details including the planned inbound detail, actual inbound detail and inbound status, etc.

This API allows you to query the status of MCF Orders.

This API verifies whether a seller is registered as a Fulfillment by TikTok (FBT) merchant and participated in Multi Channel Fulfillment(MCF)… ---

This API verifies whether a seller is registered as a Fulfillment by TikTok (FBT) merchant.

This API is used to retrieve all Fulfilled by TikTok warehouse information including the warehouse name, warehouse address information, etc.

Get detailed information regarding inbound plan placement options.

Retrieves valid inbound shipping methods and arrival time windows for a specific plan.

This API uses an asynchronous Long-Running Operation (LRO) pattern to generate label files.

Search available inventory for MCF goods.

This API is used to retrieve detailed inventory information for goods and matched SKUs, including sellable inventory, reserved inventory, unsellable inventory, and in-transit inventory at the warehouse level.

This API is used to retrieve detailed inventory change records for goods at the warehouse level.

Search hazmat and expiration information for goods by TikTok Shop SKU IDs.

This API is used to retrieve a list of goods belonging to the merchant that meet the specified conditions.

Finalizes the shipment details for a specific inbound order, including carton information and shipping methods.

Update FBT goods information, including goods name, image URL, dimensions, hazmat details, shelf-life attributes, and return address information.

Bind or unbind TikTok Shop SKUs to FBT goods.

This API manages carton-level tracking information for inbound orders.

Use this API to cancel an order on behalf of a seller.

Use this API to create a seller-initiated aftersales request for an order on behalf of the buyer.

Use this API to check eligible aftersale solutions for an order, including whether the seller or buyer can initiate a refund, return, or cancel a specific order.

Use this API to evaluate which seller decisions are currently allowed for the specified aftersales request.

Use this API to retrieve the record entries for a specific return request.

Description of [GET]/return_refund/:version/Get_Review_Decision ---

Use this API to reject a buyer's cancellation request for the specified cancel_id.

API used to review (approve, reject, or offer alternatives to) a buyer's return request.

Used to search for RMA request level data ---

Use this API to upload return shipping documents, tracking numbers, and carriers for buyers.

Use this API to create a conversation with the specified buyer, on behalf of a shop.

Use this API to end an active customer service session assigned to an agent.

This API is used to get agent settings.

Use this API to retrieve information about a conversation by ID.

Get the average customer service performance of a shop for a selected time period ---

Description of [POST]/customer_service/:version/sessions Required body fields: begin_time_ge, begin_time_lt.

Use this API to update agent status on behalf of the agent.

NOT CALLABLE OVER THIS CONNECTION: this endpoint takes a multipart/form-data file upload (data), which this MCP cannot send.

Deactivate an ongoing or upcoming activity.

Use this API to get the full details of a coupon matching the {coupon_id}.

Use this API to remove products or SKUs from the existing product discount or flash sale promotion activity.

Use this API to republish a product discount activity or a flash deal activity that expired or was deactivated within the last 7 days.

Change the title and the beginning and end time of the existing product discount or flash sale promotion activity.

If you are using your own external OMS (order management system) to manage TikTok Shop orders, the corresponding order IDs between your OMS and TikTok Shop may be different… Required body fields: orders.

If you have used the Add External Order References API to sync order information between your external order management system (OMS) and TikTok Shop, you may call this API to get information on the synced orders.

Description of [POST]/order/:version/pod_details/search Required body fields: main_order_id, query_order_lines.

After the merchant completes blind box opening in a live room, use this callback to send blind box and batch box opening results for an order back to the platform.

get seller's available shipping template and return the reason why the template is not available，this api is now only available for JP and UK market ---

This API retrieves all global warehouse information associated with the seller.

This API can use the order number to obtain the corresponding logistics tracking information, it can obtain more comprehensive logistics tracking information, which is more detailed than the Get tracking API, but only for CBT orders now… ---

Shipping Template Exist ---

Create an engagement task that uses a self-defined custom message instead of predefined message templates from TikTok Shop… Required body fields: task_name, end_time, channel.

Create an engagement task that acts as a container for grouping messages with similar content and rules, allowing sellers to track and compare task performance across different types of content… Required body fields: template_id, task_name, end_time, channel.

Retrieve information about customer engagement features that the shop has permission to use.

Retrieve detailed performance metrics for a customer engagement task, including message reads, order conversions, and other key engagement statistics.

Get a library of customer engagement message templates predefined by TikTok Shop, which you can use directly in your customer engagement communications.

This API allows the partner to retrieve a list of unsettled transactions (incl.

Get the list of the withdrawal records (when Seller's withdraw money from TikTokShop) based on the specified date range.

Send messages to specific customers for a particular engagement task.

Deletes the shop's webhook URL for a specific event topic.

Query the shop scope of product interoperability groups.

Retrieves a shop's webhooks and the corresponding webhook URLs.

Updates the shop's webhook URL for a specific event topic.

Retrieves the list of business category assets authorized by a partner for an app.

This API enables a warehouse service provider to send package shipment information for an order.

To upload a large file to TikTok Shop, such as a video, first use this API to initialize the upload session.