Nexscope -- ASIN Sales Estimates
This skill queries daily sales estimates and last known price for a given Amazon ASIN via the Nexscope data source, returning day-level data points over a specified date range across 10 Amazon marketplaces.
Core Concepts
The Nexscope ASIN Sales Estimates tool provides daily estimated unit sales and latest known price for a single ASIN across Amazon marketplaces. Sellers can query sales changes within a specified date range to:
- Monitor competitor sales: Understand competitor daily order volumes and assess their market share
- Validate product opportunities: Use actual sales data to verify if product demand is sufficient
- Track seasonal patterns: Observe sales fluctuations across months to identify peak and off-peak seasons
- Assess pricing impact: Analyze the relationship between price and sales changes to inform pricing decisions
- Track new product performance: Follow the sales ramp-up curve after a new listing launches
Data granularity: Each record represents 1 day, containing estimated units sold and latest known price (USD).
Data Fields
Output Fields
| Field | API Name | Description | Example |
|---|
| ASIN | asin | Queried ASIN | B0CXXX1234 |
| Data ID | id | Data point identifier | sales_estimate_B0CXXX1234_20260301 |
| Resource Type | type | Fixed value | sales_estimate_result |
| Parent ASIN | parentAsin | Parent ASIN (for variants) | B0CXXX0000 |
| Is Parent | isParent | Whether this is a parent product | true / false |
| Is Variant | isVariant | Whether this is a variant product | true / false |
| Is Standalone | isStandalone | Whether this is a standalone product (non-variant) | true / false |
| Variant List | variants | Array of variant ASINs under this parent | ["B0CX1", "B0CX2"] |
| Daily Estimates | dailyEstimates | Array of daily data points | See below |
| Cost Token | costToken | Tokens consumed by this call | 1 |
Each Object in dailyEstimates Array
| Field | API Name | Description | Example |
|---|
| Date | date | Data date (YYYY-MM-DD) | 2026-03-15 |
| Estimated Daily Sales | estimatedUnitsSold | Estimated units sold that day | 42 |
| Latest Known Price | lastKnownPrice | Latest known price (USD) | 29.99 |
Supported Marketplaces
10 Amazon marketplaces: us (United States), uk (United Kingdom), de (Germany), in (India), ca (Canada), fr (France), it (Italy), es (Spain), mx (Mexico), jp (Japan). Default marketplace is us. Use us when the user does not specify a marketplace.
API Invocation
- API Endpoint:
POST /tool-jungle-scout/sales-estimates/query (see references/api.md for full parameters/responses/error codes)
- Python Script:
python scripts/amazon_sales_estimates.py '<JSON params>' [--inline]
- Cost Constraints: This tool consumes credits. The same parameter combination in the same session is only called once by default, with 24h local caching in the script. Failed or empty results should not trigger automatic retries with different keywords, pagination, or postal codes. Inform the user before making additional queries that will incur extra costs.
Output Strategy (default script behavior):
- Always write the full response to
<cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-junglescout-sales-estimates-<timestamp>.json (<cwd> is the working directory at script execution time, which in Claude Code is the current project directory; <session> is taken from the SESSION_ID environment variable, auto-grouped by user task; do not write to /tmp, error out if the current directory is not writable)
- Response body less than or equal to 8 KB: print the full JSON to stdout after saving to disk
- Response body greater than 8 KB: after saving, stdout prints only a summary (top-level fields, common counts like
total/costToken, length of the largest list field + first 3 samples)
- Add
--inline to force full output to stdout (still saves to disk)
Data Reading Tips: Check the summary first to determine if it is sufficient. When specific fields are needed, use jq or ConvertFrom-Json to extract from the saved JSON file on demand, avoiding loading the entire JSON into context.
Authentication
Set the NEXSCOPE_API_KEY environment variable. If authentication fails (401/402) or you see insufficient balance errors, visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to get an API Key or top up credits.
How to Build Queries
All four parameters are required: marketplace, asin, startDate, endDate.
Principles for Building API Calls
- Marketplace mapping: "US marketplace" ->
us, "Japan marketplace" -> jp, "Germany marketplace" -> de; default to us when not specified
- Date format: Must be
YYYY-MM-DD, e.g., 2026-03-01
- endDate restriction:
endDate must be before the current date (cannot include today or future dates)
- ASIN format: Standard Amazon ASIN, typically starting with B0, 10 characters total
- Common time ranges:
- "Past 30 days" -> endDate is yesterday, startDate is 30 days before
- "Last month" -> 1st to last day of the previous month
- "Q3 vs Q4" -> two separate calls for Jul-Sep and Oct-Dec
Common Query Scenarios
1. Monitor competitor sales over the past 30 days
{
"marketplace": "us",
"asin": "B0CXXX1234",
"startDate": "2026-03-18",
"endDate": "2026-04-16"
}
2. Compare Q3 vs Q4 sales performance
Two separate calls:
- Q3:
startDate=2025-07-01, endDate=2025-09-30
- Q4:
startDate=2025-10-01, endDate=2025-12-31
3. Validate product opportunity -- view full-year sales
{
"marketplace": "us",
"asin": "B0CXXX5678",
"startDate": "2025-04-01",
"endDate": "2026-03-31"
}
4. Track new product launch performance
{
"marketplace": "de",
"asin": "B0DYYY9999",
"startDate": "2026-01-15",
"endDate": "2026-04-15"
}
5. Monitor sales during major promotion events (e.g., Prime Day)
{
"marketplace": "us",
"asin": "B0CXXX1234",
"startDate": "2025-07-01",
"endDate": "2025-07-21"
}
Display Rules
- Line chart preferred: Use a line chart to display daily sales changes, with date on the X-axis and estimated daily sales on the Y-axis; if price data is available, overlay a second Y-axis to show price trends
- Table as supplement: Also provide a data table for precise lookup, with columns: Date, Estimated Sales, Latest Known Price
- Summary statistics: After the data, summarize key metrics -- total sales, average daily sales, estimated total revenue (total sales x average price)
- Trend summary: Briefly summarize the trend direction (rising/falling/stable/seasonal fluctuations), and highlight peak and trough dates
- Error handling: When a query fails, explain the reason based on the error response and suggest adjusting parameters (e.g., endDate must not include today or future dates)
Important Limitations
- endDate cannot include today:
endDate must be before the current date; cannot query today's or future sales
- Single ASIN per call: Each call queries only one ASIN; comparing multiple ASINs requires multiple calls
- All parameters required:
marketplace, asin, startDate, endDate are all mandatory
- Price is in USD:
lastKnownPrice is denominated in USD, not local currency
User Expression and Scenario Quick Reference
Applicable -- ASIN sales estimates and sales trend analysis:
| User Says | Scenario |
|---|
| "How many units does this ASIN sell per day" | Query recent daily sales estimates |
| "How is my competitor selling lately" | Monitor competitor sales over the past 30 days |
| "Does this product have seasonality" | Full-year sales data to assess seasonal patterns |
| "Show me the sales trend for this product" | Sales trend over a specified time range |
| "How are Q4 peak season sales" | Specific quarter sales query |
| "Is this product worth pursuing" | Validate product opportunity via historical sales |
| "How many units sold during the promotion event" | Sales monitoring during promotional periods |
Not applicable -- Beyond ASIN sales estimate scope:
- Keyword search volume (requires keyword historical search volume tool)
- BSR rank history (requires BSR tracking tool)
- Category-wide sales / market size
- Non-Amazon platform sales data
- Real-time/current moment sales (data has a lag and does not include today)
Boundary judgment: When users say "sales", "daily sales", or "how many sold", if they want to see a specific ASIN's daily estimated sales over a time range, this skill applies. If they want keyword search volume, category rankings, or real-time live sales, it does not apply.