TikTok Intelligence FM

TikTok Top Selling Products MCP

Query TikTok Shop top-selling product rankings by day, week, month, market, and category. Call via REST API or MCP with your Nexscope API key.

CostRecent Avg. 22 · Range 11–22 credits / callOnline Test

TikTok Top Selling Products AI Prompts & Use Cases

After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.

New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.

1. Find Top-Selling TikTok Shop Products

Prompt: Find Top-Selling TikTok Shop Products in [target marketplace]. Show the available results and clearly identify missing information. For this selection, choose United States, United Kingdom, Mexico, Spain, Germany, Italy, France, Indonesia, Vietnam, Malaysia, Thailand, Philippines, Brazil, Japan or Singapore.

2. Review A Specific Reporting Period

Prompt: Find Top-Selling TikTok Shop Products in [target marketplace]. Use [my chosen reporting period] and show the period with the returned figures. Keep dated snapshots distinct from current data.

3. Continue The Results Within A Page Limit

Prompt: Find Top-Selling TikTok Shop Products in [target marketplace]. Start at [my selected page] and return [my requested page size] within the documented limits. Ask before requesting another page and do not describe one page as the complete dataset.

4. Prioritize The Results For Review

Prompt: Find Top-Selling TikTok Shop Products in [target marketplace]. Prioritize [my chosen ranking metric] in [my chosen order]. Keep the ranking limited to the selected filters and reporting period. For this selection, choose sales, GMV, total sales, total GMV or growth rate.

5. Find Bestsellers In A Product Category

Prompt: Find Top-Selling TikTok Shop Products in [target marketplace]. Use [my selected product category name , matched to tiktok category id] to narrow the results. Report only what the selected records support.

What You Need to Provide

Replace bracketed inputs with your own values. Use only the documented marketplace, period and input formats.

Returned estimates and rankings describe the selected data and period; missing values are not zero and a page of results is not the full market.

Step 1 · Connect

Connect Your AI Assistant

Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.

POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

Using an API key? Get your key from API Access and include it in the Authorization header shown above.

Call this MCP tool

MCP tool name

nexscope_tiktok_top_selling_products

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "tiktok-top-selling-products-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_top_selling_products",
    "arguments": {
      "dateInfo": {
        "type": "day",
        "value": "2026-08-01"
      },
      "orderby": {
        "field": "units_sold",
        "order": "desc"
      },
      "page": 1,
      "pageSize": 10,
      "region": "US"
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`region`	`string`	required	Market region code. Options: US (United States), GB (United Kingdom), MX (Mexico), ES (Spain), DE (Germany), IT (Italy), FR (France), ID (Indonesia), VN (Vietnam), MY (Malaysia), TH (Thailand), PH (Philippines), BR (Brazil), JP (Japan), SG (Singapore) Example: US
`dateInfo`	`object`	required	Date specification object, containing type and value fields Example: { "type": "day", "value": "2026-08-01" }
`dateInfo.type`	`string`	required	Time granularity: day, week, month Example: day
`dateInfo.value`	`string`	required	Date value: day format YYYY-MM-DD, week format YYYY-weekNumber (e.g., 2025-18), month format YYYY-MM Example: 2026-01-01
`category`	`string`	optional	Product category name (English), matched to TikTok category ID. Non-English input must be translated to English first
`orderby`	`object`	optional	Sort rule object, containing field and order fields Example: { "field": "units_sold", "order": "desc" }
`orderby.field`	`string`	optional	Sort field: units_sold (sales), gmv (GMV), total_units_sold (total sales), total_gmv (total GMV), growth_rate (growth rate) Example: units_sold
`orderby.order`	`string`	optional	Sort direction: desc (descending), asc (ascending), default desc Example: desc
`page`	`integer`	optional	Page number, default 1 Example: 1
`pageSize`	`integer`	optional	Items per page, max 10, default 10 Example: 10

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`errcode`	`integer`	optional	Business status code, `200` indicates success.
`errmsg`	`string`	optional	Business status description.
`page`	`integer`	optional	Current page number.
`pageSize`	`integer`	optional	The current number of items per page.
`total`	`integer`	optional	Number of records.
`products`	`array`	optional	List of hot-selling products, product object fields are shown in the table below.
`columns`	`array`	optional	Rendered columns.
`type`	`string`	optional	Rendering style.
`costTime`	`integer`	optional	Interface time spent (milliseconds).
`costToken`	`integer`	optional	Consume token; some responses may be omitted.
`matchedCategoryIdPath`	`string`	optional	Path to the matched category ID; may be returned when `category` is passed in.
`matchedCategoryNamePath`	`string`	optional	Matched category name path; may be returned when `category` is passed in.
`title`	`string`	optional	Product name.
`productId`	`string`	optional	Product ID.
`region`	`string`	optional	Area code.
`price`	`number`	optional	Product price.
`minPrice`	`number`	optional	Lowest price; only price range products are returned.
`maxPrice`	`number`	optional	Highest price; only price range products are returned.
`currency`	`string`	optional	Currency symbol or logo.
`totalSaleCnt`	`integer`	optional	Total sales.
`totalSale1dCnt`	`integer`	optional	Sales volume in the last 1 day (returned when `dateType=day`).
`totalSale7dCnt`	`integer`	optional	Sales volume in the past 7 days (returned when `dateType=week`).
`totalSale30dCnt`	`integer`	optional	Sales volume in the last 30 days (returned when `dateType=month`).
`totalSaleGmvAmt`	`number`	optional	Total sales.
`totalSaleGmv1dAmt`	`number`	optional	Sales in the last 1 day (returned when `dateType=day`).
`totalSaleGmv7dAmt`	`number`	optional	Sales in the last 7 days (returned when `dateType=week`).
`totalSaleGmv30dAmt`	`number`	optional	Sales in the last 30 days (returned for `dateType=month`).
`growthRate`	`number`	optional	Growth rate (percent).
`shopName`	`string`	optional	Store name.
`shopTotalUnitsSold`	`integer`	optional	The total sales volume of the store.
`shopSellerId`	`string`	optional	Store seller ID.
`categoryName`	`string`	optional	Product category.
`categoryIds`	`array`	optional	Product category ID path (level one to level three).
`productCommissionRate`	`number`	optional	Product commission ratio (basis points, 1000=10%).
`imageUrl`	`string`	optional	Product image URL.
`coverUrl`	`array`	optional	Product cover image URL list.
`shopAvatar`	`string`	optional	Store avatar URL.
`sourceType`	`string`	optional	Product source type.
`offShelvesText`	`string`	optional	Whether it is removed from the shelves ("Yes" = removed from the shelves, "No" = on sale).

Format Illustration

Illustrative example with fictional data, not a live tool call.

Illustrative Question

Query TikTok Shop top-selling product rankings by day, week, month, market, and category. Focus on the US.

Illustrative Response Explanation

The illustrative result shows title: Example product; product id: example-productId; price: 19.99. These figures describe only the shown record. Missing measures cannot be calculated from this example.

About this sample: Illustrative example with fictional records, not a live tool call. Identifiers, prices and counts are demonstration values.

Published sample data is not available for this page. A format illustration or workflow guide is not a substitute for a published result.

View the MCP Request & Response Format

Examples