Amazon data for product and market research
International · e-commerce · Live — endpoints, setup commands, and search examples for this platform.
Find competing products in a specific Amazon marketplace, compare prices and ratings, or use an ASIN to look up product details, historical trends, and buyer reviews. You can also check category best sellers, keyword search trends, and organic results.
Endpoint
amazon entry points. REST and MCP are two interfaces to the same tools.
| Item | Value |
|---|---|
| MCP(Streamable HTTP) | https://claudebaby.cn/mcp/amazon |
| MCP(SSE) | https://claudebaby.cn/sse/amazon |
| MCP(stdio) | claudebaby-mcp --platform amazon |
| REST data access | POST https://claudebaby.cn/v1/ecommerce/amazon/tools/{tool} |
| REST endpoint catalog | https://claudebaby.cn/v1/ecommerce/amazon/tools |
The MCP mount point has the same shape as other live platformssame shape: the same host and /mcp/ prefix, with only the final segment set to amazon. Replace the final segment with another platform name to get its endpoint.
Setup methods
Choose any of the three setup methods. Authentication, metering, and caching stay in the cloud; no upstream keys are stored locally.
# Claude Code: connect with one command
claude mcp add --transport http claudebaby-amazon https://claudebaby.cn/mcp/amazon \
--header "Authorization: Bearer $CB_KEY"
# After connecting, use /mcp in a session to see the tools{
"mcpServers": {
"claudebaby-amazon": {
"type": "http",
"url": "https://claudebaby.cn/mcp/amazon",
"headers": { "Authorization": "Bearer <your API key>" }
}
}
}# Local stdio: no secrets are stored locally; data still comes through the cloud gateway
uv tool install --from "git+https://github.com/lingling1989r/claudebaby.git#subdirectory=mcps" claudebaby-mcp
CLAUDEBABY_API_KEY=cb_live_xxx claudebaby-mcp --platform amazonIssue keys in the console; plaintext is shown once. Insufficient balance returns insufficient_balance(HTTP 402)。
Endpoint catalog
The tool name is the final REST path segment; the same tools are available through MCP and return the same envelope.
Total 20 endpoints.
| Endpoint | Input | Note |
|---|---|---|
| category_tree | site:string · node_id:string | Browse the Amazon category tree; omit node_id for the top two levels. |
| category_name_search | name*:string · site:string | Find Amazon sub-categories by name and get their node ids. |
| category_report | node_id*:string · site:string | Top-100 best sellers of an Amazon sub-category, real time. |
| 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. |
| category_trend | node_id*:string · trend_index:string · site:string | Historical trend of an Amazon sub-category market. |
| category_keywords | node_id*:string · page:integer · site:string | Core keywords of an Amazon sub-category market. |
| 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. |
| product_search_from_name | name*:string · page:integer · site:string | Search Amazon products by name; up to 20 per page. |
| product_detail | asin*:string · site:string | Full detail record of a single Amazon product (one ASIN per call). |
| product_trend | asin*:string · trend_type:string · site:string | Historical trend of an Amazon product (sales / price / rank). |
| product_reviews | asin*:string · review_type:string · site:string | Up to 100 Amazon user reviews of a product from the last year. |
| product_customers_say | asin*:string · site:string | Amazon `Customers Say` summary distilled from a product's reviews. |
| product_variations | asin*:string · page:integer · site:string | Child-ASIN variation breakdown of an Amazon parent product. |
| product_traffic_terms | asin*:string · page:integer · site:string | Keywords an Amazon product has recently been exposed under. |
| product_ranking_trend_by_keyword | asin*:string · keyword*:string · page:integer · site:string | Exposure-ranking trend of an Amazon product under one keyword. |
| 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. |
| keyword_detail | keyword*:string · site:string | Detail record of one trending Amazon keyword. |
| keyword_trend | keyword*:string · site:string | Historical trend of an Amazon keyword (volume / rank / CPC). |
| keyword_extends | keyword*:string · site:string · page:integer | Extended / long-tail keywords derived from an Amazon keyword. |
| keyword_search_results | keyword*:string · site:string · page:integer · position_type:string | Products holding organic positions for an Amazon keyword. |
Search example: anker
The example uses anker as the search term and calls amazon’s category_name_search. The search term is placed in the tool’s actual input field; other required fields remain placeholders. Replace <…> with your value. See the endpoint catalog above for parameters and descriptions, or https://claudebaby.cn/v1/ecommerce/amazon/tools.
export CB_KEY=cb_live_xxx
curl -s -X POST https://claudebaby.cn/v1/ecommerce/amazon/tools/category_name_search \
-H "Authorization: Bearer $CB_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "anker"}'{
"ok": true,
"data": {
"…": "category_name_search response; fields vary by tool"
},
"meta": {
"platform": "amazon",
"domain": "ecommerce",
"tool": "category_name_search",
"request_id": "req_…",
"credits": "<credits used by this call; see /pricing.json>"
}
}Run the request to see a real response (endpoint and route billing applies) — the example above data above is only the envelope, not fabricated sample data. To try it in a browser, use API details and enter your own key.
Billing
Choose top-ups or a plan; credits are reserved before a paid fetch and insufficient balances are rejected.
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.
Charge per call = credits per execution × executions; 1 credit = ¥0.02. See the tier for each endpoint in /pricing.json (including per-platform prices).