Nexscope logo
Start free

Amazon Asin Traffic Summary API

REST API and MCP service documentation generated from server-side API definitions. Responses shown here are the direct payload returned by each API execution.

API selector
Amazon Marketplace Intelligence

API overview

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.

Try this API
Endpoint
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-asin-traffic-summary/run
MCP method
nexscope_amazon_asin_traffic_summary

Authentication

All run endpoints require a user API key. Send it as a bearer token in the Authorization header.

Authorization: Bearer nk_xxxxxxxxxxxxxxxxx
Missing or invalid API keys return an authentication error. Manage keys from .
POSThttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-asin-traffic-summary/run

Run an API

Request parameters documented by ecommerce.amazon-asin-traffic-summary.

Slugamazon-asin-traffic-summary
HeadersAuthorization: Bearer nk_...
Content-Type: application/json
Request bodyAPI-specific JSON object.
Response bodyDirect API response payload. No data/result wrapper is added.

Status codes

CodeDescription
200API executed successfully. Body is the direct response payload.
400Request JSON or required API parameters are invalid.
401API key is missing, invalid, or cannot be matched to a user.
5xxAPI execution or upstream service failed.

Example request

curl -X POST https://api.nexscope.ai/api/skill-api/v1/skills/amazon-asin-traffic-summary/run \
  -H "Authorization: Bearer nk_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{   "pageSize": 10,   "last7d": true,   "searchValue": "B072MQ5BRX",   "country": "US",   "pageNum": 1,   "desc": true }'
All categories/ Amazon Marketplace Intelligence
POSThttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-asin-traffic-summary/run

Run this API

Send a JSON request to execute this API and receive the direct response payload.

Open tester

Endpoint

MethodPOST
Pathhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-asin-traffic-summary/run
AuthBearer API key
Content-Typeapplication/json

Request body

NameTypeRequiredDescription
searchValuestringrequired
Search value, ASIN codes, comma-separated, max 10 ASINs, max length 1000 characters
Example: B072MQ5BRX
countrystringoptional
Country site, default US. Options (13 total): US, UK, DE, CA, JP, FR, ES, IT, MX, AU, AE, BR, SA
last7dbooleanoptional
Whether to get last 7 days data, default true. When false, use startDate/endDate range
Example: false
startDatestringoptional
Start date yyyy-MM-dd (effective when last7d=false; if omitted, the latest system week is used)
Example: 2026-01-01
endDatestringoptional
End date yyyy-MM-dd (paired with startDate)
Example: 2026-01-01
conditionsstringoptional
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)
sortBystringoptional
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)
pageNumintegeroptional
Page number, default 1
Example: 1
pageSizeintegeroptional
Results per page, min 10, max 10000, default 10000
Example: 10
descbooleanoptional
Whether to sort descending, default true
Example: false

Request example

{
  "pageSize": 10,
  "last7d": true,
  "searchValue": "B072MQ5BRX",
  "country": "US",
  "pageNum": 1,
  "desc": true
}

Response body

Returns the documented upstream API response directly without an additional wrapper.

NameTypeRequiredDescription
codestringoptional
Response code
msgstringoptional
Message
totalintegeroptional
Number of data records actually returned
Example: 1
dataarrayoptional
Return data, ASIN summary object array (see below)
Example: []
columnsarrayoptional
Render columns
Example: []
typestringoptional
Render style
titlestringoptional
Title
isParentAsinbooleanoptional
Whether the search value is a parent ASIN
Example: false
variantsNumintegeroptional
Number of variant products with keywords
Example: 1
noKeywordVariantsNumintegeroptional
Number of variant products without keywords
Example: 1
costTimeintegeroptional
Latency (ms)
Example: 1
costTokenintegeroptional
Tokens consumed
Example: 1
data[].asinstringoptional
ASIN code. Amazon Standard Identification Number
Example: B072MQ5BRX
data[].productTitlestringoptional
Product title
data[].productCategorystringoptional
Product category
data[].productPricenumberoptional
Product price
Example: 1
data[].productImageUrlstringoptional
Product main image URL
Example: https://example.com/image.jpg
data[].productFeaturesarrayoptional
Product feature list
Example: []
data[].customerRatingCountintegeroptional
Total customer rating count
Example: 1
data[].productStarRatingnumberoptional
Product star rating (0-5 stars)
Example: 1
data[].productRatingScorenumberoptional
Product rating score value (0-5, as displayed on Amazon page)
Example: 1
data[].isVariantProductbooleanoptional
Whether it is a variant
Example: false
data[].recentMonthlySalesBucketstringoptional
Recent month sales bucket (only has value in keywordSummary path, e.g. "300+" or "1,000+")
data[].isMonitoredbooleanoptional
Whether it is being monitored
Example: false
data[].monitoringStartTimestringoptional
Product monitoring start time
data[].dataPeriodStartDatestringoptional
Data period start date (yyyy-MM-dd)
Example: 2026-01-01
data[].totalExposureScorenumberoptional
Total exposure score. Composite exposure score of this product across all keywords
Example: 1
data[].totalExposureScorePrevnumberoptional
Previous period total exposure score
Example: 1
data[].totalTrafficKeywordCountintegeroptional
Total traffic keyword count
Example: 1
data[].totalTrafficKeywordCountInintegeroptional
New incoming traffic keyword count for this period
Example: 1
data[].totalTrafficKeywordCountOutintegeroptional
Outgoing traffic keyword count for this period
Example: 1
data[].totalTrafficKeywordCountPrevintegeroptional
Previous period total traffic keyword count
Example: 1
data[].naturalSearchExposureScorenumberoptional
Natural search exposure total score
Example: 1
data[].naturalSearchExposureRationumberoptional
Natural search exposure ratio
Example: 1
data[].naturalSearchExposureScorePrevnumberoptional
Previous period natural search exposure score
Example: 1
data[].naturalSearchKeywordCountintegeroptional
Natural search keyword count
Example: 1
data[].naturalSearchKeywordCountInintegeroptional
New incoming natural search keyword count for this period
Example: 1
data[].naturalSearchKeywordCountOutintegeroptional
Outgoing natural search keyword count for this period
Example: 1
data[].naturalSearchKeywordCountPrevintegeroptional
Previous period natural search keyword count
Example: 1
data[].sponsoredProductsExposureScorenumberoptional
SP ad exposure total score
Example: 1
data[].sponsoredProductsExposureRationumberoptional
SP ad exposure ratio
Example: 1
data[].sponsoredProductsExposureScorePrevnumberoptional
Previous period SP ad exposure score
Example: 1
data[].sponsoredProductsKeywordCountintegeroptional
SP ad keyword count
Example: 1
data[].brandAdExposureScorenumberoptional
Brand ad exposure total score
Example: 1
data[].brandAdExposureRationumberoptional
Brand ad exposure ratio
Example: 1
data[].brandAdExposureScorePrevnumberoptional
Previous period brand ad exposure score
Example: 1
data[].brandAdKeywordCountintegeroptional
Total brand ad keyword count
Example: 1
data[].topBrandAdKeywordCountintegeroptional
Top-of-page brand ad keyword count
Example: 1
data[].bottomBrandAdKeywordCountintegeroptional
Bottom-of-page brand ad keyword count
Example: 1
data[].videoAdExposureScorenumberoptional
Video ad exposure total score
Example: 1
data[].videoAdExposureRationumberoptional
Video ad exposure ratio
Example: 1
data[].videoAdExposureScorePrevnumberoptional
Previous period video ad exposure score
Example: 1
data[].videoAdKeywordCountintegeroptional
Video ad keyword count
Example: 1
data[].amazonsChoiceExposureScorenumberoptional
Amazon's Choice exposure total score
Example: 1
data[].amazonsChoiceExposureRationumberoptional
Amazon's Choice exposure ratio
Example: 1
data[].amazonsChoiceExposureScorePrevnumberoptional
Previous period AC exposure score
Example: 1
data[].amazonsChoiceKeywordCountintegeroptional
Amazon's Choice keyword count
Example: 1
data[].amazonsChoiceKeywordCountInintegeroptional
New incoming AC keyword count for this period
Example: 1
data[].amazonsChoiceKeywordCountOutintegeroptional
Outgoing AC keyword count for this period
Example: 1
data[].editorialRecommendationsExposureScorenumberoptional
Editorial Recommendations exposure total score
Example: 1
data[].editorialRecommendationsExposureRationumberoptional
Editorial Recommendations exposure ratio
Example: 1
data[].editorialRecommendationsKeywordCountintegeroptional
Editorial Recommendations keyword count
Example: 1
data[].topRatedExposureScorenumberoptional
Top Rated recommendation exposure total score
Example: 1
data[].topRatedExposureRationumberoptional
Top Rated recommendation exposure ratio
Example: 1
data[].topRatedKeywordCountintegeroptional
Top Rated recommendation keyword count
Example: 1
data[].frequentlyBoughtKeywordCountintegeroptional
Frequently Bought recommendation keyword count (Top Rated Frequently Bought)
Example: 1
data[].recommendPositionExposureScorenumberoptional
Recommendation position exposure total score
Example: 1
data[].recommendAdExposureScorenumberoptional
Recommendation position ad exposure score
Example: 1
data[].recommendNonadExposureScorenumberoptional
Recommendation position non-ad exposure score
Example: 1
data[].nonAcRecommendExposureScorenumberoptional
Non-AC recommendation position exposure score
Example: 1
data[].recommendKeywordCountintegeroptional
Total recommendation position keyword count
Example: 1
data[].recommendAdKeywordCountintegeroptional
Recommendation position ad keyword count
Example: 1
data[].recommendNonadKeywordCountintegeroptional
Recommendation position non-ad keyword count
Example: 1
data[].ppcTrafficSourcesarrayoptional
PPC paid ad traffic source markers. Contains: SP ads, top brand ads, bottom brand ads, video ads
Example: []
data[].naturalSearchTrafficSourcesarrayoptional
Natural search traffic source markers
Example: []
data[].amazonRecommendationSourcesarrayoptional
Amazon recommendation traffic source markers. Contains: Best Seller, AC, ER, TR, TRFOB, etc.
Example: []
data[].promotionalDealSourcesarrayoptional
Promotional deal traffic source markers. Contains: Coupon, Limited Time Deal, Lowest Price in 30 Days, etc.
Example: []
errcodeintegeroptional
Upstream status code returned by the provider.
errmsgstringoptional
Upstream status message returned by the provider.
messagestringoptional
Provider-specific message.
sourceTypestringoptional
Provider-specific source platform type.
sourceToolstringoptional
Provider-specific source tool name.
pageintegeroptional
Current page returned by the upstream provider.
pageSizeintegeroptional
Page size returned by the upstream provider.
pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
totalPageintegeroptional
Total page count returned by the upstream provider.
dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.

Response example

Direct response payload. No extra wrapper is added.

{
  "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
}

Responses

CodeDescription
200API executed successfully. Body is the direct response payload.
400Request JSON or required API parameters are invalid.
401API key is missing, invalid, or cannot be matched to a user.
5xxAPI execution or upstream service failed.

Data source, freshness, and limitations

Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.

Related APIs

Amazon Alexa Search

Initiate natural language Q&A through Amazon's storefront Alexa shopping assistant to get shopping guidance answers, recommended product groups, ASIN lists, and follow-up questions. Each call supports only 1 prompt; for follow-ups, the agent must summarize context and concatenate a new question for a new request. A url can be used to supplement Amazon page context.

Amazon Broad Product Search

Use SellerSprite data to search and filter Amazon products, supporting multi-dimensional criteria including price, monthly sales, BSR ranking, gross margin, ratings, fulfillment method, badges, seller origin, and more across multiple Amazon marketplaces.

Amazon Competitor Lookup

Use SellerSprite data to find and analyze competitors on Amazon, covering 12 marketplaces, with product metrics including sales, BSR, pricing, ratings, and growth trends.

Amazon Market Product Detail

Query Amazon product detail and historical trends by ASIN using Sorftime data, covering 14 marketplaces.

MCP

Use the MCP endpoint when an agent needs to discover and call API tools with JSON-RPC.

GET /api/skill-api/v1/mcp
POST /api/skill-api/v1/mcp
Authorization: Bearer nk_xxxxxxxxxxxxxxxxx
Content-Type: application/json

Call a tool

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_asin_traffic_summary",
    "arguments": {
      "pageSize": 10,
      "last7d": true,
      "searchValue": "B072MQ5BRX",
      "country": "US",
      "pageNum": 1,
      "desc": true
    }
  }
}

Online test

Execute the current API with your API key and JSON payload.

Try it

Send a real request with the same contract shown in the reference.

Endpoint
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-asin-traffic-summary/run
MCP method
nexscope_amazon_asin_traffic_summary
cURL
curl -X POST \
  https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-asin-traffic-summary/run \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "pageSize": 10, "last7d": true, "searchValue": "B072MQ5BRX", "country": "US", "pageNum": 1, "desc": true }'
Response
No response yet. Run the request to see the response here.