Amazon Search Intelligence SF
Amazon ASIN Traffic Summary MCP
Compare traffic sources and keyword changes for an ASIN. Call the Amazon ASIN Traffic Summary API via REST or MCP with your Nexscope API key.
Amazon ASIN Traffic Summary 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. Compare ASIN Traffic
Prompt: Compare the available traffic summaries for up to 10 Amazon products [ASINS] in [MARKETPLACE].
2. Check The Latest Seven Days
Prompt: Compare the available traffic summaries for up to 10 Amazon products [ASINS] in [MARKETPLACE]. Use the latest seven-day reporting window.
3. Check A Custom Reporting Period
Prompt: Compare the available traffic summaries for up to 10 Amazon products [ASINS] in [MARKETPLACE]. Use the reporting period from [START_DATE] through [END_DATE] instead of the latest seven days. Keep the returned coverage and dates explicit.
4. Review Several Result Pages
Prompt: Compare the available traffic summaries for up to 10 Amazon products [ASINS] in [MARKETPLACE]. Collect up to 3 pages for this research task. Request 10 results per page. Stop sooner if there is no next page, an empty result or an error. Deduplicate matching identifiers and do not describe the sample as the full market.
5. Prioritize Results By Search Visibility
Prompt: Compare the available traffic summaries for up to 10 Amazon products [ASINS] in [MARKETPLACE]. Put [RANKING_PRIORITY] first, choosing all traffic keywords, natural traffic keywords, brand ad keywords, video ad keywords, AC recommended keywords, ER recommended keywords, TR recommended keywords, total keyword exposure score, total natural rank exposure score, Sponsored Products exposure score, total brand ad exposure score, total video ad exposure score, total AC recommendation exposure score, total TR recommendation exposure score or total ER recommendation exposure score. Use [ASCENDING_OR_DESCENDING] order.
6. Find Keywords By Traffic Source
Prompt: Compare the available traffic summaries for up to 10 Amazon products [ASINS] in [MARKETPLACE]. Filter for [KEYWORD_SEGMENT], choosing organic search, Sponsored Products ads, Sponsored Brands ads, video ads, all advertising traffic or Sponsored Products recommendations. Use one segment for this request.
7. Find New Search And Recommendation Keywords
Prompt: Compare the available traffic summaries for up to 10 Amazon products [ASINS] in [MARKETPLACE]. Show traffic keywords.
What You Need to Provide
Replace the bracketed placeholders with your own research inputs. Keep source estimates, reporting periods and missing information explicit.
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/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_amazon_asin_traffic_summaryhttps://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"jsonrpc": "2.0",
"id": "amazon-asin-traffic-summary-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_asin_traffic_summary",
"arguments": {
"country": "US",
"desc": true,
"last7d": true,
"pageNum": 1,
"pageSize": 10,
"searchValue": "B072MQ5BRX"
}
}
}MCP 2025-11-25 · Streamable HTTPProgress 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 |
|---|---|---|---|
searchValue | string | required | Search value, ASIN codes, comma-separated, max 10 ASINs, max length 1000 characters Example: B072MQ5BRX |
country | string | optional | Country site, default US. Options (13 total): US, UK, DE, CA, JP, FR, ES, IT, MX, AU, AE, BR, SA |
last7d | boolean | optional | Whether to get last 7 days data, default true. When false, use startDate/endDate range Example: false |
startDate | string | optional | Start date yyyy-MM-dd (effective when last7d=false; if omitted, the latest system week is used) Example: 2026-01-01 |
endDate | string | optional | End date yyyy-MM-dd (paired with startDate) Example: 2026-01-01 |
conditions | string | optional | Condition filters, comma-separated. Options: nf (natural traffic), sp (SP ads), sb (SB regular), sbv (video ads), ad (ad traffic), acAd (SP recommendation), totalPeriod.in (new incoming traffic keywords) |
sortBy | string | optional | Sort field. Options: totalKeywordNum (all traffic keywords), naturalKeywordNum (natural traffic keywords), brandKeywordNum (brand ad keywords), vedioKeywordNum (video ad keywords), acKeywordNum (AC recommended keywords), erKeywordNum (ER recommended keywords), trKeywordNum (TR recommended keywords), sumScore (total keyword exposure score), totalNfScore (total natural rank exposure score), totalSpSocre (total SP ad exposure score, note spelling), totalBrandScore (total brand ad exposure score), totalVedioScore (total video ad exposure score), totalAcScore (total AC recommendation exposure score), totalTrScore (total TR recommendation exposure score), totalErScore (total ER recommendation exposure score) |
pageNum | integer | optional | Page number, default 1 Example: 1 |
pageSize | integer | optional | Results per page, min 10, max 10000, default 10000 Example: 10 |
desc | boolean | optional | Whether to sort descending, default true Example: false |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
code | string | optional | return code |
msg | string | optional | news |
total | integer | optional | The actual amount of data returned this time |
data | array | optional | ASIN summary object array (Field suffix convention: `*Prev` is the value of the previous period; `*In` / `*Out` is the number of new entries/exits in this cycle relative to the previous period) |
columns | array | optional | render column |
type | string | optional | rendering style |
title | string | optional | Title |
isParentAsin | boolean | optional | Whether the search object is a parent ASIN |
variantsNum | integer | optional | Number of variations with keywords |
noKeywordVariantsNum | integer | optional | Number of variations without keywords |
costTime | integer | optional | Time consuming (ms) |
costToken | integer | optional | Consume token |
asin | string | optional | ASIN code |
productTitle | string | optional | Product title |
productCategory | string | optional | Product category |
productPrice | number | optional | Product selling price |
productImageUrl | string | optional | Main image URL |
productFeatures | array | optional | Product feature list |
customerRatingCount | integer | optional | Total customer ratings |
productStarRating | number | optional | Product star rating (0–5) |
productRatingScore | number | optional | Product rating value (0–5) |
isVariantProduct | boolean | optional | Is it a variant? |
recentMonthlySalesBucket | string | optional | Sales bucket in the past month; this field only has a value in the `keywordSummary` path, in the form of `"300+"` or `"1,000+"` |
isMonitored | boolean | optional | Has it been monitored? |
monitoringStartTime | string | optional | attention time |
dataPeriodStartDate | string | optional | Data period start date |
totalExposureScore | number | optional | Total exposure score |
totalExposureScorePrev | number | optional | Total exposure score last cycle |
totalTrafficKeywordCount | integer | optional | Total number of traffic keywords |
totalTrafficKeywordCountIn | integer | optional | Number of new traffic keywords this cycle |
totalTrafficKeywordCountOut | integer | optional | Number of exit traffic keywords this cycle |
totalTrafficKeywordCountPrev | integer | optional | Total number of traffic keywords in the last cycle |
naturalSearchExposureScore | number | optional | Total organic search exposure score |
naturalSearchExposureRatio | number | optional | Natural search exposure ratio |
naturalSearchExposureScorePrev | number | optional | Natural search exposure score last cycle |
naturalSearchKeywordCount | integer | optional | Number of natural search keywords |
naturalSearchKeywordCountIn | integer | optional | Number of new natural keywords this cycle |
naturalSearchKeywordCountOut | integer | optional | Number of natural keywords exiting this cycle |
naturalSearchKeywordCountPrev | integer | optional | Number of natural keywords in the previous cycle |
sponsoredProductsExposureScore | number | optional | SP ad impression total score |
sponsoredProductsExposureRatio | number | optional | SP advertising exposure ratio |
sponsoredProductsExposureScorePrev | number | optional | Last cycle SP exposure score |
sponsoredProductsKeywordCount | integer | optional | SP number of advertising keywords |
brandAdExposureScore | number | optional | Total brand advertising exposure score |
brandAdExposureRatio | number | optional | Brand advertising exposure proportion |
brandAdExposureScorePrev | number | optional | Brand advertising exposure score last cycle |
brandAdKeywordCount | integer | optional | Number of brand advertising keywords |
topBrandAdKeywordCount | integer | optional | Number of top brand ad keywords |
bottomBrandAdKeywordCount | integer | optional | Number of keywords for brand ads at the bottom |
videoAdExposureScore | number | optional | Total video ad exposure score |
videoAdExposureRatio | number | optional | Video ad exposure ratio |
videoAdExposureScorePrev | number | optional | Video ad exposure score last cycle |
videoAdKeywordCount | integer | optional | Number of video ad keywords |
amazonsChoiceExposureScore | number | optional | Amazon's Choice Impression Total Score |
amazonsChoiceExposureRatio | number | optional | Amazon's Choice impression share |
amazonsChoiceExposureScorePrev | number | optional | Last cycle AC exposure score |
amazonsChoiceKeywordCount | integer | optional | AC keyword count |
amazonsChoiceKeywordCountIn | integer | optional | Number of new AC keywords in this cycle |
amazonsChoiceKeywordCountOut | integer | optional | Number of AC keywords exiting this cycle |
editorialRecommendationsExposureScore | number | optional | ER total exposure score |
editorialRecommendationsExposureRatio | number | optional | ER exposure ratio |
editorialRecommendationsKeywordCount | integer | optional | ER keyword count |
topRatedExposureScore | number | optional | TR Recommended exposure total score |
topRatedExposureRatio | number | optional | TR recommended exposure ratio |
topRatedKeywordCount | integer | optional | TR keyword count |
frequentlyBoughtKeywordCount | integer | optional | Number of recommended keywords for high-frequency purchases |
recommendPositionExposureScore | number | optional | Recommended position exposure total score |
recommendAdExposureScore | number | optional | Recommended advertising exposure score |
recommendNonadExposureScore | number | optional | Recommended position non-advertising exposure score |
nonAcRecommendExposureScore | number | optional | Non-AC recommended position exposure score |
recommendKeywordCount | integer | optional | Total number of recommended keywords |
recommendAdKeywordCount | integer | optional | Number of recommended advertising keywords |
recommendNonadKeywordCount | integer | optional | Number of recommended non-advertising keywords |
ppcTrafficSources | array | optional | PPC Traffic Source Tags |
naturalSearchTrafficSources | array | optional | Organic search traffic source tag |
amazonRecommendationSources | array | optional | Amazon Recommended Source Mark |
promotionalDealSources | array | optional | Promotion source tag |
Format Illustration
Illustrative example with fictional data, not a live tool call.
Illustrative Question
Summarize the last seven days of traffic for ASIN B072MQ5BRX on Amazon US.
Illustrative Response Explanation
The illustrative result reports 80 traffic keywords, including 50 natural-search keywords. Its total exposure score is 1,000, compared with 800 in the previous period. Exposure scores are not visitor counts.
About this sample: Illustrative example only. Names, identifiers and numbers are fictional; no live tool call was made. Your results depend on your account, inputs and available data.
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
Illustrative example with fictional data, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "amazon-asin-traffic-summary-example",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_asin_traffic_summary",
"arguments": {
"country": "US",
"desc": true,
"last7d": true,
"pageNum": 1,
"pageSize": 10,
"searchValue": "B072MQ5BRX"
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "amazon-asin-traffic-summary-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"total\":1,\"data\":[{\"asin\":\"B072MQ5BRX\",\"totalTrafficKeywordCount\":80,\"naturalSearchKeywordCount\":50,\"totalExposureScore\":1000,\"totalExposureScorePrev\":800}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"total": 1,
"data": [
{
"asin": "B072MQ5BRX",
"totalTrafficKeywordCount": 80,
"naturalSearchKeywordCount": 50,
"totalExposureScore": 1000,
"totalExposureScorePrev": 800
}
]
}
},
"isError": false
}
}