§00
Call the public API
Anyone can browse the tool catalog. To call a live REST or MCP tool, create an account and generate an API key in the console. REST accepts a Bearer token or X-API-Key. Data calls use credits. The example checks your key, then requests the 1688 category tree.
REST · curl
export CB_KEY="your_api_key"
curl -i https://claudebaby.cn/api/me -H "Authorization: Bearer $CB_KEY"
curl -i -X POST https://claudebaby.cn/v1/ecommerce/1688/tools/ali1688_category_tree -H "Authorization: Bearer $CB_KEY" -H "Content-Type: application/json" -d '{}'§01
Platforms and mount points
Overview of mount points for live platforms, grouped like the home-page matrix: domestic / international × social / e-commerce.
| Platform | Market / domain | MCP（Streamable HTTP） | Endpoints |
|---|---|---|---|
| 1688 | Domestic · e-commerce | https://claudebaby.cn/mcp/1688 | 5 |
| amazon | International · e-commerce | https://claudebaby.cn/mcp/amazon | 20 |
| douyin | Domestic · social | https://claudebaby.cn/mcp/douyin | 4 |
| International · social | https://claudebaby.cn/mcp/facebook | 3 | |
| International · social | https://claudebaby.cn/mcp/linkedin | 3 | |
| International · social | https://claudebaby.cn/mcp/reddit | 3 | |
| shopee | International · e-commerce | https://claudebaby.cn/mcp/shopee | 11 |
| temu | International · e-commerce | https://claudebaby.cn/mcp/temu | 7 |
| tiktok | International · social | https://claudebaby.cn/mcp/tiktok | 4 |
| tiktokshop | International · e-commerce | https://claudebaby.cn/mcp/tiktokshop | 10 |
| walmart | International · e-commerce | https://claudebaby.cn/mcp/walmart | 12 |
| x | International · social | https://claudebaby.cn/mcp/x | 4 |
| xiaohongshu | Domestic · social | https://claudebaby.cn/mcp/xiaohongshu | 4 |
| youtube | International · social | https://claudebaby.cn/mcp/youtube | 4 |
REST data access uses the unified endpoint POST https://claudebaby.cn/v1/{domain}/{platform}/tools/{tool}; the tool name is the final path segment and arguments use a JSON body. MCP and REST expose the same tools. Select a platform for its setup command and search example.
§02
Business-layer MCP (default entry point)
The Business layer provides cross-platform semantic integration; native platform APIs remain available for advanced queries.
| Capability | Status | Note |
|---|---|---|
| business_capabilities | Live | List the business-layer tools and cross-platform capabilities. |
| source_support | Live | Check whether a data source or a named source capability is supported before querying it. |
| product_research | Live | Search comparable products across supported marketplaces and return source-aware partial results. |
| market_research | Planned | Compare market size, growth, concentration and demand signals. |
| content_search | Planned | Search and merge content from supported social platforms. |
| topic_monitor | Planned | Aggregate topic, brand and keyword signals across social platforms. |
Remote endpoint: https://claudebaby.cn/mcp/business; REST endpoint: POST https://claudebaby.cn/v1/business/business/tools/{tool}. Only tools marked live in the capability catalog are callable.
§02a
All endpoint multipliers and pricing status
Standard e-commerce costs 1 credit per execution. A ×N badge means N credits per execution. Composite subcalls and pages are billed separately. Credits are held before execution, settled on success and released on failure; timeouts await reconciliation.
| Call type | Route | Base credits | Multiplier | Credits / call | Base price / call | Calls with 30 trial credits |
|---|---|---|---|---|---|---|
| instagram / user.posts | Standard | 1 | ×18 | 18 | ¥0.36 | 1 |
| tiktok / user.posts | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| xiaohongshu / search.notes | Standard | 1 | ×23 | 23 | ¥0.46 | 1 |
| facebook / page.posts | Extended | 1 | ×113 | 113 | ¥2.26 | 0 |
| linkedin / user.profile | Fallback | 1 | ×131 | 131 | ¥2.62 | 0 |
| amazon / product.search | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
All endpoint multipliers and pricing status
| Call type | Route | Base credits | Multiplier | Credits / call | Base price / call | Calls with 30 trial credits |
|---|---|---|---|---|---|---|
| bilibili / search.videos | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| bilibili / user.profile | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| bilibili / user.videos | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| bilibili / video.comments | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| bilibili / video.detail | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| douyin / post.comments | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| douyin / post.detail | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| douyin / search.videos | Standard | 1 | ×23 | 23 | ¥0.46 | 1 |
| douyin / user.profile | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| gongzhonghao / account.articles | Standard | 1 | ×23 | 23 | ¥0.46 | 1 |
| gongzhonghao / account.profile | Standard | 1 | ×23 | 23 | ¥0.46 | 1 |
| gongzhonghao / article.comments | Standard | 1 | ×23 | 23 | ¥0.46 | 1 |
| gongzhonghao / article.detail | Standard | 1 | ×23 | 23 | ¥0.46 | 1 |
| instagram / post.detail | Standard | 1 | ×18 | 18 | ¥0.36 | 1 |
| instagram / search.users | Standard | 1 | ×18 | 18 | ¥0.36 | 1 |
| instagram / user.posts | Standard | 1 | ×18 | 18 | ¥0.36 | 1 |
| instagram / user.profile | Standard | 1 | ×18 | 18 | ¥0.36 | 1 |
| kuaishou / search.videos | Standard | 1 | ×23 | 23 | ¥0.46 | 1 |
| kuaishou / user.profile | Standard | 1 | ×5 | 5 | ¥0.10 | 6 |
| lemon8 / post.detail | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| lemon8 / search.posts | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| lemon8 / user.profile | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| linkedin / company.profile | Standard | 1 | ×18 | 18 | ¥0.36 | 1 |
| linkedin / post.detail | Standard | 1 | ×18 | 18 | ¥0.36 | 1 |
| linkedin / user.profile | Standard | 1 | ×18 | 18 | ¥0.36 | 1 |
| threads / user.posts | Standard | 1 | ×5 | 5 | ¥0.10 | 6 |
| tiktok / post.comments | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| tiktok / post.detail | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| tiktok / user.posts | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| tiktok / user.profile | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| toutiao / article.detail | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| toutiao / post.comments | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| toutiao / user.profile | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| toutiao / video.detail | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| weibo / hot.list | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| weibo / post.detail | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| weibo / search.posts | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| weibo / user.profile | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| x / post.detail | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| x / search.posts | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| x / user.posts | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| x / user.profile | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| xiaohongshu / note.detail | Standard | 1 | ×23 | 23 | ¥0.46 | 1 |
| xiaohongshu / search.notes | Standard | 1 | ×23 | 23 | ¥0.46 | 1 |
| xiaohongshu / user.notes | Standard | 1 | ×23 | 23 | ¥0.46 | 1 |
| xiaohongshu / user.profile | Standard | 1 | ×23 | 23 | ¥0.46 | 1 |
| xigua / search.videos | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| xigua / user.videos | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| youtube / channel.profile | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| youtube / channel.videos | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| youtube / search.videos | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| youtube / video.detail | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| zhihu / answer.detail | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| zhihu / hot.list | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| zhihu / question.answers | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| zhihu / user.profile | Standard | 1 | ×3 | 3 | ¥0.06 | 10 |
| facebook / page.profile | Extended | 1 | ×113 | 113 | ¥2.26 | 0 |
| facebook / page.posts | Extended | 1 | ×113 | 113 | ¥2.26 | 0 |
| facebook / post.detail | Extended | 1 | ×113 | 113 | ¥2.26 | 0 |
| linkedin / user.profile | Fallback | 1 | ×131 | 131 | ¥2.62 | 0 |
| linkedin / company.profile | Fallback | 1 | ×131 | 131 | ¥2.62 | 0 |
| linkedin / post.detail | Fallback | 1 | ×131 | 131 | ¥2.62 | 0 |
| amazon / category.tree | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / category.search | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / category.report | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / category.report_history | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / category.trend | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / category.keywords | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / product.search | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / product.search_from_name | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / product.detail | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / product.trend | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / product.reviews | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / product.customers_say | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / product.variations | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / product.traffic_terms | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / product.keyword_ranking | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / keyword.list | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / keyword.detail | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / keyword.trend | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / keyword.extends | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| amazon / keyword.search_results | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / category.tree | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / category.search | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / category.report | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / product.search_from_name | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / product.detail | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / product.trend | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / product.variations | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / product.traffic_terms | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / keyword.list | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / keyword.detail | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / keyword.extends | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| walmart / keyword.search_results | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / category.tree | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / category.search | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / category.report | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / category.trend | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / product.search | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / product.search_from_name | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / product.detail | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / product.trend | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / keyword.list | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / keyword.search_results | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| shopee / shop.detail | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| temu / category.tree | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| temu / category.search | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| temu / category.report | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| temu / product.search | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| temu / product.search_from_name | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| temu / product.detail | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| temu / product.trend | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / category.tree | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / category.search | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / category.report | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / category.trend | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / product.search | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / product.search_from_name | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / product.detail | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / product.trend | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / shop.detail | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| tiktokshop / shop.search | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| 1688 / category.tree | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| 1688 / product.search | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| 1688 / product.detail | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| 1688 / product.variations | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| 1688 / product.similar_sourcing | Standard | 1 | ×1 | 1 | ¥0.02 | 30 |
| reddit / posts.search | Standard | — | — | Pricing pending | — | — |
| reddit / comments.search | Standard | — | — | Pricing pending | — | — |
| reddit / comments.thread | Standard | — | — | Pricing pending | — | — |
Unpriced endpoints are temporarily unavailable. Fallback quotes include the cost budget for the failed primary attempt. See the actual invocation ledger.
§03
International · social
6 platforms. Each platform process reports its own endpoint catalog; the site only applies the live-platform gate.
| Platform | Endpoint | Input | Note |
|---|---|---|---|
| /v1/social/facebook/tools/facebook_page_profile | url*:string | Fetch a public Facebook page profile. | |
| /v1/social/facebook/tools/facebook_page_posts | url*:string · limit:integer | Fetch recent public posts from a Facebook page. | |
| /v1/social/facebook/tools/facebook_post_detail | url*:string | Fetch a public Facebook post and its engagement data. | |
| /v1/social/linkedin/tools/linkedin_user_profile | url*:string | Public profile of a LinkedIn member. | |
| /v1/social/linkedin/tools/linkedin_company_profile | url*:string | Public page of a LinkedIn company. | |
| /v1/social/linkedin/tools/linkedin_post_detail | url*:string | Single LinkedIn post or article. | |
| /v1/social/reddit/tools/reddit_search_posts | subreddit*:string · query*:string · days:integer · limit:integer | Search posts in a subreddit by keyword within a time window. Returns up to `limit` matches, oldest first. `limit` is also the cost control:… | |
| /v1/social/reddit/tools/reddit_get_thread | post_id*:string · top_n:integer | Fetch the comment tree of a single post, optionally only the top N. | |
| /v1/social/reddit/tools/reddit_search_comments | subreddit*:string · query*:string · days:integer · limit:integer | Search comments in a subreddit by keyword within a time window. Returns up to `limit` matches, oldest first. `limit` is also the cost contr… | |
| tiktok | /v1/social/tiktok/tools/tiktok_user_profile | username:string · user_id:string | Public profile of a TikTok account. |
| tiktok | /v1/social/tiktok/tools/tiktok_user_posts | user_id*:string · cursor:string · count:integer | Videos published by a TikTok account, newest first. |
| tiktok | /v1/social/tiktok/tools/tiktok_post_detail | post_id*:string · region:string | Single TikTok video with its author and engagement counters. |
| tiktok | /v1/social/tiktok/tools/tiktok_post_comments | post_id*:string · cursor:string · count:integer | Top-level comments of a TikTok video. |
| x | /v1/social/x/tools/x_user_profile | username:string · user_id:integer | Public profile of an X account. |
| x | /v1/social/x/tools/x_user_posts | username:string · user_id:integer · cursor:string | Posts published by an X account. |
| x | /v1/social/x/tools/x_post_detail | post_id*:string | Single X post with its author and counters. |
| x | /v1/social/x/tools/x_search_posts | query*:string · cursor:string | Keyword search over X posts. |
| youtube | /v1/social/youtube/tools/youtube_video_detail | video_id*:string | Single YouTube video with description and counters. |
| youtube | /v1/social/youtube/tools/youtube_channel_profile | channel_id*:string | Public profile of a YouTube channel. |
| youtube | /v1/social/youtube/tools/youtube_channel_videos | channel_id*:string · cursor:string | Videos published by a YouTube channel. |
| youtube | /v1/social/youtube/tools/youtube_search_videos | query*:string · cursor:string · order_by:string | Keyword search over YouTube videos. |
§04
International · e-commerce
5 platforms. Each platform process reports its own endpoint catalog; the site only applies the live-platform gate.
| Platform | Endpoint | Input | Note |
|---|---|---|---|
| amazon | /v1/ecommerce/amazon/tools/category_tree | site:string · node_id:string | Browse the Amazon category tree; omit node_id for the top two levels. |
| amazon | /v1/ecommerce/amazon/tools/category_name_search | name*:string · site:string | Find Amazon sub-categories by name and get their node ids. |
| amazon | /v1/ecommerce/amazon/tools/category_report | node_id*:string · site:string | Top-100 best sellers of an Amazon sub-category, real time. |
| amazon | /v1/ecommerce/amazon/tools/category_report_from_history | node_id*:string · start_date*:string · end_date*:string · site:string | Top-100 best sellers of an Amazon sub-category in a past date range. |
| amazon | /v1/ecommerce/amazon/tools/category_trend | node_id*:string · trend_index:string · site:string | Historical trend of an Amazon sub-category market. |
| amazon | /v1/ecommerce/amazon/tools/category_keywords | node_id*:string · page:integer · site:string | Core keywords of an Amazon sub-category market. |
| amazon | /v1/ecommerce/amazon/tools/product_search | search_name:string · brand:string · seller_name:string · price_min:string · price_max:string · month_sales_min:string · month_sales_max:string · rating_min:string · rating_max:string · rating_count_min:string · rating_count_max:string · page:integer · site:string | Search live Amazon products with multi-dimensional filters. |
| amazon | /v1/ecommerce/amazon/tools/product_search_from_name | name*:string · page:integer · site:string | Search Amazon products by name; up to 20 per page. |
| amazon | /v1/ecommerce/amazon/tools/product_detail | asin*:string · site:string | Full detail record of a single Amazon product (one ASIN per call). |
| amazon | /v1/ecommerce/amazon/tools/product_trend | asin*:string · trend_type:string · site:string | Historical trend of an Amazon product (sales / price / rank). |
| amazon | /v1/ecommerce/amazon/tools/product_reviews | asin*:string · review_type:string · site:string | Up to 100 Amazon user reviews of a product from the last year. |
| amazon | /v1/ecommerce/amazon/tools/product_customers_say | asin*:string · site:string | Amazon `Customers Say` summary distilled from a product's reviews. |
| amazon | /v1/ecommerce/amazon/tools/product_variations | asin*:string · page:integer · site:string | Child-ASIN variation breakdown of an Amazon parent product. |
| amazon | /v1/ecommerce/amazon/tools/product_traffic_terms | asin*:string · page:integer · site:string | Keywords an Amazon product has recently been exposed under. |
| amazon | /v1/ecommerce/amazon/tools/product_ranking_trend_by_keyword | asin*:string · keyword*:string · page:integer · site:string | Exposure-ranking trend of an Amazon product under one keyword. |
| amazon | /v1/ecommerce/amazon/tools/keyword_list | site:string · page:integer · rank_min:string · rank_max:string · search_volume_min:string · search_volume_max:string | Live trending keyword list for an Amazon site, by weekly search volume. |
| amazon | /v1/ecommerce/amazon/tools/keyword_detail | keyword*:string · site:string | Detail record of one trending Amazon keyword. |
| amazon | /v1/ecommerce/amazon/tools/keyword_trend | keyword*:string · site:string | Historical trend of an Amazon keyword (volume / rank / CPC). |
| amazon | /v1/ecommerce/amazon/tools/keyword_extends | keyword*:string · site:string · page:integer | Extended / long-tail keywords derived from an Amazon keyword. |
| amazon | /v1/ecommerce/amazon/tools/keyword_search_results | keyword*:string · site:string · page:integer · position_type:string | Products holding organic positions for an Amazon keyword. |
| shopee | /v1/ecommerce/shopee/tools/shopee_category_tree | site:string · node_id:string | Browse the Shopee category tree for one site. |
| shopee | /v1/ecommerce/shopee/tools/shopee_category_search_from_name | name*:string · site:string | Find Shopee categories by name and get their node ids. |
| shopee | /v1/ecommerce/shopee/tools/shopee_category_request | node_id*:string · query_date:string · page:integer · site:string | Best-selling products under a Shopee category (sub-categories only). |
| shopee | /v1/ecommerce/shopee/tools/shopee_category_trend | node_id*:string · trend_index:string · site:string | Historical trend of a Shopee category market. |
| shopee | /v1/ecommerce/shopee/tools/shopee_product_search | node_id:string · price_min:string · price_max:string · month_sales_min:string · month_sales_max:string · star_min:string · star_max:string · comment_count_min:string · comment_count_max:string · site:string · page:integer | Search Shopee products with filters, sorted by monthly sales. |
| shopee | /v1/ecommerce/shopee/tools/shopee_product_search_from_name | name*:string · site:string · page:integer | Search Shopee products by name; up to 20 per page. |
| shopee | /v1/ecommerce/shopee/tools/shopee_product_request | product_id*:string · site:string | Full detail record of a single Shopee product. |
| shopee | /v1/ecommerce/shopee/tools/shopee_product_trend | product_id*:string · start_date:string · end_date:string · site:string | Historical trend of a Shopee product (star / comments / price / sales). |
| shopee | /v1/ecommerce/shopee/tools/shopee_keyword_search | keyword:string · rank_min:string · rank_max:string · search_volume_min:string · search_volume_max:string · site:string · page:integer | Trending keywords on Shopee, by monthly search volume. |
| shopee | /v1/ecommerce/shopee/tools/shopee_keyword_relation_results | keyword*:string · site:string · page:integer | Products related to a Shopee keyword, up to 20 per page. |
| shopee | /v1/ecommerce/shopee/tools/shopee_shop_request | shop_id*:string · site:string | Shopee seller profile plus a top-500 snapshot of its products. |
| temu | /v1/ecommerce/temu/tools/temu_category_tree | site:string · node_id:string | Browse the Temu category tree for one site. |
| temu | /v1/ecommerce/temu/tools/temu_category_search_from_name | name*:string · site:string | Find Temu categories by name and get their node ids. |
| temu | /v1/ecommerce/temu/tools/temu_category_request | node_id*:string · page:integer · site:string | Best-selling products under a Temu category. |
| temu | /v1/ecommerce/temu/tools/temu_product_search | node_id:string · brand:string · seller_name:string · price_min:string · price_max:string · sales_min:string · sales_max:string · star_min:string · star_max:string · comment_count_min:string · comment_count_max:string · site:string · page:integer | Search Temu products with filters, sorted by monthly sales. |
| temu | /v1/ecommerce/temu/tools/temu_product_search_from_name | name*:string · site:string · page:integer | Search Temu products by name; 20 per page. |
| temu | /v1/ecommerce/temu/tools/temu_product_request | product_id*:string · site:string | Full detail record of a single Temu product. |
| temu | /v1/ecommerce/temu/tools/temu_product_trend | product_id*:string · start_date:string · end_date:string · site:string | Historical trend of a Temu product (sales / price / comments / star). |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_category_tree | site:string · node_id:string | Browse the TikTok Shop category tree for one site. |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_category_search_from_name | name*:string · site:string | Find TikTok Shop categories by name and get their node ids. |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_category_request | node_id*:string · page:integer · site:string | Best-selling products under a TikTok Shop category. |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_category_trend | node_id*:string · trend_index:string · site:string | Historical trend of a TikTok Shop category market. |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_product_search | node_id:string · brand:string · seller_name:string · price_min:string · price_max:string · month_sales_min:string · month_sales_max:string · star_min:string · star_max:string · review_count_min:string · review_count_max:string · site:string · page:integer | Search TikTok Shop products with filters. |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_product_search_from_name | name*:string · site:string · page:integer | Search TikTok Shop products by name. |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_product_request | product_id*:string · site:string | Full detail record of a single TikTok Shop product. |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_product_trend | product_id*:string · trend_type:string · site:string | Historical trend of a TikTok Shop product. |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_shop_request | shop_id*:string · site:string | TikTok Shop seller details. |
| tiktokshop | /v1/ecommerce/tiktokshop/tools/tiktok_shop_search | node_id:string · month_sales_min:string · month_sales_max:string · star_min:string · star_max:string · site:string · page:integer | Search TikTok Shop sellers with filters. |
| walmart | /v1/ecommerce/walmart/tools/walmart_category_tree | node_id:string | Browse the Walmart category tree (US site only). |
| walmart | /v1/ecommerce/walmart/tools/walmart_category_search_from_name | name*:string | Find Walmart categories by name and get their node ids. |
| walmart | /v1/ecommerce/walmart/tools/walmart_category_report_by_node_id | node_id*:string | Real-time top-100 best sellers of a Walmart category. |
| walmart | /v1/ecommerce/walmart/tools/walmart_product_search_from_name | name*:string · page:integer | Search Walmart products by name; up to 20 per page. |
| walmart | /v1/ecommerce/walmart/tools/walmart_product_detail_by_product_id | product_id*:string | Full detail record of a single Walmart product. |
| walmart | /v1/ecommerce/walmart/tools/walmart_product_trend_by_product_id | product_id*:string · trend_type:string · start_date:string · end_date:string | Historical trend of a Walmart product (sales volume / amount and more). |
| walmart | /v1/ecommerce/walmart/tools/walmart_product_variation_sales_by_product_id | product_id*:string · start_date:string · end_date:string · page:integer | Child-item sales breakdown of a Walmart product. |
| walmart | /v1/ecommerce/walmart/tools/walmart_product_traffic_terms | product_id*:string · page:integer | Keywords a Walmart product has recently been exposed under. |
| walmart | /v1/ecommerce/walmart/tools/walmart_keyword_list | rank_min*:integer · rank_max*:integer · page:integer | Real-time hot keyword list for Walmart, by monthly search volume. |
| walmart | /v1/ecommerce/walmart/tools/walmart_keyword_detail | keyword*:string | Detail record of one Walmart hot keyword. |
| walmart | /v1/ecommerce/walmart/tools/walmart_keyword_extends | keyword*:string · page:integer | Extended keywords derived from a Walmart hot keyword. |
| walmart | /v1/ecommerce/walmart/tools/walmart_keyword_search_results | keyword*:string · page:integer | Natural-position product list for a Walmart hot keyword. |
§05
Domestic · social
2 platforms. Each platform process reports its own endpoint catalog; the site only applies the live-platform gate.
| Platform | Endpoint | Input | Note |
|---|---|---|---|
| douyin | /v1/social/douyin/tools/douyin_user_profile | username*:string | Public profile of a Douyin account. |
| douyin | /v1/social/douyin/tools/douyin_post_detail | post_id*:string | Single Douyin video with its author and counters. |
| douyin | /v1/social/douyin/tools/douyin_post_comments | post_id*:string · cursor:string · count:integer | Top-level comments of a Douyin video. |
| douyin | /v1/social/douyin/tools/douyin_search_videos | query*:string · cursor:string · sort_type:string · publish_time:string | Keyword search over Douyin videos. |
| xiaohongshu | /v1/social/xiaohongshu/tools/xiaohongshu_search_notes | query*:string · page:integer · sort_type:string · note_type:string · time_filter:string | Keyword search over Xiaohongshu notes. |
| xiaohongshu | /v1/social/xiaohongshu/tools/xiaohongshu_user_profile | user_id:string · url:string | Public profile of a Xiaohongshu account. |
| xiaohongshu | /v1/social/xiaohongshu/tools/xiaohongshu_user_notes | user_id:string · url:string · cursor:string | Notes published by a Xiaohongshu account. |
| xiaohongshu | /v1/social/xiaohongshu/tools/xiaohongshu_note_detail | note_id:string · url:string | Single Xiaohongshu note (image or video). |
§06
Domestic · e-commerce
1 platforms. Each platform process reports its own endpoint catalog; the site only applies the live-platform gate.
| Platform | Endpoint | Input | Note |
|---|---|---|---|
| 1688 | /v1/ecommerce/1688/tools/ali1688_category_tree | node_id:string | Browse the 1688 category tree. |
| 1688 | /v1/ecommerce/1688/tools/ali1688_product_search | node_id:string · supplier_name:string · price_min:string · price_max:string · cumulative_sales_min:string · cumulative_sales_max:string · recent_sales_min:string · recent_sales_max:string · repurchase_rate_min:string · sku_count_min:string · stock_count_min:string · page:integer | Search 1688 offers / suppliers with multi-dimensional filters. |
| 1688 | /v1/ecommerce/1688/tools/ali1688_product_request | product_id*:string | Full detail record of a single 1688 offer. |
| 1688 | /v1/ecommerce/1688/tools/ali1688_product_variations | product_id*:string | SKU / variation data of a 1688 offer. |
| 1688 | /v1/ecommerce/1688/tools/ali1688_similar_product | search_name*:string · page:integer | Sourcing / wholesale suppliers for a product name — procurement cost view. |
§07
Contract
REST and MCP share the same contract and return the same envelope.
| Item | Definition |
|---|---|
| Authentication | Authorization: Bearer <API Key> (also accepts X-API-Key） |
| Response | {"ok", "data", "meta"}；meta Platform / endpoint / credits / pagination cursor only |
| Billing | Charge per call = credits per execution × executions; see Pricing |
| Errors | {"error": {"code", "message", "retryable"}}; see error-code catalog |
| Request correlation | Every response includes X-Request-Id |
Machine-readable versions of the same contracts: /openapi.json (schema and error codes), /v1/meta/tools (live endpoint catalog), /.well-known/mcp.json (MCP mount points). To test each endpoint in a browser, use API details.
