Amazon
Use SIF (Search Intelligence Framework) data to analyze ASIN traffic source composition and exposure distribution, covering current period/previous period/newly entered/exited period comparisons.
nexscope_amazon_asin_traffic_summary/api/skill-api/v1/mcptools/callSend the user API key as a bearer token on every MCP JSON-RPC request.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxIf authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.
Use tools/call with the MCP tool name below. The arguments object should match the table on this page.
{
"jsonrpc": "2.0",
"id": "amazon-asin-traffic-summary-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_asin_traffic_summary",
"arguments": {
"desc": true,
"pageNum": 1,
"country": "US",
"searchValue": "B072MQ5BRX",
"last7d": true,
"pageSize": 10
}
}
}POST /api/skill-api/v1/mcphttps://www.nexscope.ai/mcp-map/amazon-asin-traffic-summary| 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 Example: {} |
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) Example: {} |
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) Example: {} |
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 |
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
data | any | required | Data value used by this API operation. |
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
msg | string | null | required | Msg value used by this API operation. |
ts | string | required | Epoch milliseconds. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
traceId | string | null | required | Trace id value used by this API operation. |
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.total | integer | optional | Number of data records actually returned Example: 1 |
data.data | array | optional | Return data, ASIN summary object array (see below) Example: [] |
data.data[] | object | required | Item in data data. |
data.data[].asin | string | optional |
{
"desc": true,
"pageNum": 1,
"country": "US",
"searchValue": "B072MQ5BRX",
"last7d": true,
"pageSize": 10
}{
"data": {
"total": 1,
"data": [
{
"asin": "B072MQ5BRX",
"productPrice": 1,
"productImageUrl": "https://example.com/image.jpg",
"productFeatures": [],
"customerRatingCount": 1,
"productStarRating": 1,
"productRatingScore": 1,
"isVariantProduct": false,
"isMonitored": false,
"dataPeriodStartDate": "2026-01-01",
"totalExposureScore": 1,
"totalExposureScorePrev": 1,
"totalTrafficKeywordCount": 1,
"totalTrafficKeywordCountIn": 1,
"totalTrafficKeywordCountOut": 1,
"totalTrafficKeywordCountPrev": 1,
"naturalSearchExposureScore": 1,
"naturalSearchExposureRatio": 1,
"naturalSearchExposureScorePrev": 1,
"naturalSearchKeywordCount": 1,
"naturalSearchKeywordCountIn": 1,
"naturalSearchKeywordCountOut": 1,
"naturalSearchKeywordCountPrev": 1,
"sponsoredProductsExposureScore": 1,
"sponsoredProductsExposureRatio": 1,
"sponsoredProductsExposureScorePrev": 1,
"sponsoredProductsKeywordCount": 1,
"brandAdExposureScore": 1,
"brandAdExposureRatio": 1,
"brandAdExposureScorePrev": 1,
"brandAdKeywordCount": 1,
"topBrandAdKeywordCount": 1,
"bottomBrandAdKeywordCount": 1,
"videoAdExposureScore": 1,
"videoAdExposureRatio": 1,
"videoAdExposureScorePrev": 1,
"videoAdKeywordCount": 1,
"amazonsChoiceExposureScore": 1,
"amazonsChoiceExposureRatio": 1,
"amazonsChoiceExposureScorePrev": 1,
"amazonsChoiceKeywordCount": 1,
"amazonsChoiceKeywordCountIn": 1,
"amazonsChoiceKeywordCountOut": 1,
"editorialRecommendationsExposureScore": 1,
"editorialRecommendationsExposureRatio": 1,
"editorialRecommendationsKeywordCount": 1,
"topRatedExposureScore": 1,
"topRatedExposureRatio": 1,
"topRatedKeywordCount": 1,
"frequentlyBoughtKeywordCount": 1,
"recommendPositionExposureScore": 1,
"recommendAdExposureScore": 1,
"recommendNonadExposureScore": 1,
"nonAcRecommendExposureScore": 1,
"recommendKeywordCount": 1,
"recommendAdKeywordCount": 1,
"recommendNonadKeywordCount": 1,
"ppcTrafficSources": [],
"naturalSearchTrafficSources": [],
"amazonRecommendationSources": [],
"promotionalDealSources": []
}
],
"columns": [],
"isParentAsin": false,
"variantsNum": 1,
"noKeywordVariantsNum": 1,
"costTime": 1,
"costToken": 1
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}data.data[].productTitle | string | optional | Product title Example: null |
data.data[].productCategory | string | optional | Product category Example: null |
data.data[].productPrice | number | optional | Product price Example: 1 |
data.data[].productImageUrl | string | optional | Product main image URL Example: https://example.com/image.jpg |
data.data[].productFeatures | array | optional | Product feature list Example: [] |
data.data[].customerRatingCount | integer | optional | Total customer rating count Example: 1 |
data.data[].productStarRating | number | optional | Product star rating (0-5 stars) Example: 1 |
data.data[].productRatingScore | number | optional | Product rating score value (0-5, as displayed on Amazon page) Example: 1 |
data.data[].isVariantProduct | boolean | optional | Whether it is a variant Example: false |
data.data[].recentMonthlySalesBucket | string | optional | Recent month sales bucket (only has value in keywordSummary path, e.g. "300+" or "1,000+") Example: null |
data.data[].isMonitored | boolean | optional | Whether it is being monitored Example: false |
data.data[].monitoringStartTime | string | optional | Product monitoring start time Example: null |
data.data[].dataPeriodStartDate | string | optional | Data period start date (yyyy-MM-dd) Example: 2026-01-01 |
data.data[].totalExposureScore | number | optional | Total exposure score. Composite exposure score of this product across all keywords Example: 1 |
data.data[].totalExposureScorePrev | number | optional | Previous period total exposure score Example: 1 |
data.data[].totalTrafficKeywordCount | integer | optional | Total traffic keyword count Example: 1 |
data.data[].totalTrafficKeywordCountIn | integer | optional | New incoming traffic keyword count for this period Example: 1 |
data.data[].totalTrafficKeywordCountOut | integer | optional | Outgoing traffic keyword count for this period Example: 1 |
data.data[].totalTrafficKeywordCountPrev | integer | optional | Previous period total traffic keyword count Example: 1 |
data.data[].naturalSearchExposureScore | number | optional | Natural search exposure total score Example: 1 |
data.data[].naturalSearchExposureRatio | number | optional | Natural search exposure ratio Example: 1 |
data.data[].naturalSearchExposureScorePrev | number | optional | Previous period natural search exposure score Example: 1 |
data.data[].naturalSearchKeywordCount | integer | optional | Natural search keyword count Example: 1 |
data.data[].naturalSearchKeywordCountIn | integer | optional | New incoming natural search keyword count for this period Example: 1 |
data.data[].naturalSearchKeywordCountOut | integer | optional | Outgoing natural search keyword count for this period Example: 1 |
data.data[].naturalSearchKeywordCountPrev | integer | optional | Previous period natural search keyword count Example: 1 |
data.data[].sponsoredProductsExposureScore | number | optional | SP ad exposure total score Example: 1 |
data.data[].sponsoredProductsExposureRatio | number | optional | SP ad exposure ratio Example: 1 |
data.data[].sponsoredProductsExposureScorePrev | number | optional | Previous period SP ad exposure score Example: 1 |
data.data[].sponsoredProductsKeywordCount | integer | optional | SP ad keyword count Example: 1 |
data.data[].brandAdExposureScore | number | optional | Brand ad exposure total score Example: 1 |
data.data[].brandAdExposureRatio | number | optional | Brand ad exposure ratio Example: 1 |
data.data[].brandAdExposureScorePrev | number | optional | Previous period brand ad exposure score Example: 1 |
data.data[].brandAdKeywordCount | integer | optional | Total brand ad keyword count Example: 1 |
data.data[].topBrandAdKeywordCount | integer | optional | Top-of-page brand ad keyword count Example: 1 |
data.data[].bottomBrandAdKeywordCount | integer | optional | Bottom-of-page brand ad keyword count Example: 1 |
data.data[].videoAdExposureScore | number | optional | Video ad exposure total score Example: 1 |
data.data[].videoAdExposureRatio | number | optional | Video ad exposure ratio Example: 1 |
data.data[].videoAdExposureScorePrev | number | optional | Previous period video ad exposure score Example: 1 |
data.data[].videoAdKeywordCount | integer | optional | Video ad keyword count Example: 1 |
data.data[].amazonsChoiceExposureScore | number | optional | Amazon's Choice exposure total score Example: 1 |
data.data[].amazonsChoiceExposureRatio | number | optional | Amazon's Choice exposure ratio Example: 1 |
data.data[].amazonsChoiceExposureScorePrev | number | optional | Previous period AC exposure score Example: 1 |
data.data[].amazonsChoiceKeywordCount | integer | optional | Amazon's Choice keyword count Example: 1 |
data.data[].amazonsChoiceKeywordCountIn | integer | optional | New incoming AC keyword count for this period Example: 1 |
data.data[].amazonsChoiceKeywordCountOut | integer | optional | Outgoing AC keyword count for this period Example: 1 |
data.data[].editorialRecommendationsExposureScore | number | optional | Editorial Recommendations exposure total score Example: 1 |
data.data[].editorialRecommendationsExposureRatio | number | optional | Editorial Recommendations exposure ratio Example: 1 |
data.data[].editorialRecommendationsKeywordCount | integer | optional | Editorial Recommendations keyword count Example: 1 |
data.data[].topRatedExposureScore | number | optional | Top Rated recommendation exposure total score Example: 1 |
data.data[].topRatedExposureRatio | number | optional | Top Rated recommendation exposure ratio Example: 1 |
data.data[].topRatedKeywordCount | integer | optional | Top Rated recommendation keyword count Example: 1 |
data.data[].frequentlyBoughtKeywordCount | integer | optional | Frequently Bought recommendation keyword count (Top Rated Frequently Bought) Example: 1 |
data.data[].recommendPositionExposureScore | number | optional | Recommendation position exposure total score Example: 1 |
data.data[].recommendAdExposureScore | number | optional | Recommendation position ad exposure score Example: 1 |
data.data[].recommendNonadExposureScore | number | optional | Recommendation position non-ad exposure score Example: 1 |
data.data[].nonAcRecommendExposureScore | number | optional | Non-AC recommendation position exposure score Example: 1 |
data.data[].recommendKeywordCount | integer | optional | Total recommendation position keyword count Example: 1 |
data.data[].recommendAdKeywordCount | integer | optional | Recommendation position ad keyword count Example: 1 |
data.data[].recommendNonadKeywordCount | integer | optional | Recommendation position non-ad keyword count Example: 1 |
data.data[].ppcTrafficSources | array | optional | PPC paid ad traffic source markers. Contains: SP ads, top brand ads, bottom brand ads, video ads Example: [] |
data.data[].naturalSearchTrafficSources | array | optional | Natural search traffic source markers Example: [] |
data.data[].amazonRecommendationSources | array | optional | Amazon recommendation traffic source markers. Contains: Best Seller, AC, ER, TR, TRFOB, etc. Example: [] |
data.data[].promotionalDealSources | array | optional | Promotional deal traffic source markers. Contains: Coupon, Limited Time Deal, Lowest Price in 30 Days, etc. Example: [] |
data.columns | array | optional | Render columns Example: [] |
data.type | string | optional | Render style Example: null |
data.title | string | optional | Title Example: null |
data.isParentAsin | boolean | optional | Whether the search value is a parent ASIN Example: false |
data.variantsNum | integer | optional | Number of variant products with keywords Example: 1 |
data.noKeywordVariantsNum | integer | optional | Number of variant products without keywords Example: 1 |
data.costTime | integer | optional | Latency (ms) Example: 1 |
data.costToken | integer | optional | Tokens consumed Example: 1 |
data.sourceType | string | optional | Provider-specific source platform type. Example: null |
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
data.page | integer | optional | Current page returned by the upstream provider. Example: null |
data.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
data.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |