Amazon History KP

Amazon Product Price Series MCP

Track an Amazon product's price, best-seller rank, ratings, and sales over time. Call via REST API or MCP with your Nexscope API key.

CostRecent 10 credits / callOnline Test

Amazon Product Price Series 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. Check Product Price History

Prompt: Show the available lowest-new-price history for Amazon ASIN [ASIN] in [MARKETPLACE] over [NUMBER_OF_DAYS], up to 365 days.

2. Check List Price History

Prompt: Show the available lowest-new-price history for Amazon ASIN [ASIN] in [MARKETPLACE] over [NUMBER_OF_DAYS], up to 365 days. Include the available historical series for list or strikethrough prices. Keep missing dates explicit.

3. Check Deal Price History

Prompt: Show the available lowest-new-price history for Amazon ASIN [ASIN] in [MARKETPLACE] over [NUMBER_OF_DAYS], up to 365 days. Include the available historical series for deal and flash-sale prices. Keep missing dates explicit.

4. Check Prime Price History

Prompt: Show the available lowest-new-price history for Amazon ASIN [ASIN] in [MARKETPLACE] over [NUMBER_OF_DAYS], up to 365 days. Include the available historical series for Prime-exclusive new prices. Keep missing dates explicit.

5. Check FBA Offer Price History

Prompt: Show the available lowest-new-price history for Amazon ASIN [ASIN] in [MARKETPLACE] over [NUMBER_OF_DAYS], up to 365 days. Include the available historical series for third-party FBA new prices. Keep missing dates explicit.

6. Check FBM Offer Price History

Prompt: Show the available lowest-new-price history for Amazon ASIN [ASIN] in [MARKETPLACE] over [NUMBER_OF_DAYS], up to 365 days. Include the available historical series for third-party FBM new prices. Keep missing dates explicit.

7. Check Coupon Price History

Prompt: Show the available lowest-new-price history for Amazon ASIN [ASIN] in [MARKETPLACE] over [NUMBER_OF_DAYS], up to 365 days. Include the available historical series for coupon-applied Buy Box prices. Keep missing dates explicit.

8. Check Category Rank History

Prompt: Show the available lowest-new-price history for Amazon ASIN [ASIN] in [MARKETPLACE] over [NUMBER_OF_DAYS], up to 365 days. Include the available historical series for main-category best-seller rank. Keep missing dates explicit.

9. Check Seller Count History

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/json

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

Using an API key? Get your key from API Access and include it in the Authorization header shown above.

Call this MCP tool

MCP tool name

nexscope_amazon_product_price_series

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "amazon-product-price-series-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_product_price_series",
    "arguments": {
      "asin": "B072MQ5BRX",
      "days": 90,
      "domain": "1",
      "showPrice": 1,
      "showPriceDeal": 1,
      "showPriceList": 1,
      "showPricePrime": 1
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress 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
`asin`	`string`	required	Amazon Standard Identification Number (ASIN), single ASIN only, max length 1000 Example: B072MQ5BRX
`domain`	`string`	required	Amazon domain ID. Options: 1 (United States), 2 (United Kingdom), 3 (Germany), 4 (France), 5 (Japan), 6 (Canada), 8 (Italy), 9 (Spain), 10 (India), 11 (Mexico), 12 (Brazil) Example: 1
`days`	`integer`	optional	Limit historical data to this many days, default 90, max 365 Example: 90
`showPrice`	`integer`	optional	Set to 1 to return the lowest new price curve in the market Example: 1
`showPriceList`	`integer`	optional	Set to 1 to return the list/strikethrough price curve Example: 1
`showPriceDeal`	`integer`	optional	Set to 1 to return the deal/flash sale price curve Example: 1
`showPricePrime`	`integer`	optional	Set to 1 to return the Prime-exclusive new price curve Example: 1
`showPriceFba`	`integer`	optional	Set to 1 to return the third-party FBA new price curve Example: 1
`showPriceFbm`	`integer`	optional	Set to 1 to return the third-party FBM new price curve Example: 1
`showPriceCoupon`	`integer`	optional	Set to 1 to return the coupon-applied Buy Box price curve Example: 1
`showBsrMain`	`integer`	optional	Set to 1 to return the main category BSR curve Example: 1
`showSellerCount`	`integer`	optional	Set to 1 to return the seller count curve Example: 1

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`asin`	`string`	optional	ASIN。
`buyboxPrice`	`array`	optional	Buy Box price; elements contain `time` (time) and `value` (Buy Box price).
`price`	`array`	optional	The lowest new product price on the market; elements include `time` and `value`.
`priceList`	`array`	optional	Strikethrough price; elements contain `time` and `value`.
`priceDeal`	`array`	optional	Deal price; elements contain `time` and `value`.
`pricePrime`	`array`	optional	Prime price; elements contain `time` and `value`.
`priceFba`	`array`	optional	FBA price; elements contain `time` and `value`.
`priceFbm`	`array`	optional	FBM price; elements contain `time` and `value`.
`priceCoupon`	`array`	optional	Coupon price; elements contain `time` and `value`.
`bsrMain`	`array`	optional	Category BSR; each element contains `categoryName` (category name) and `points` (time series point).
`bsrSub`	`array`	optional	Small class BSR; each element contains `categoryName` (category name) and `points` (time series point).
`sellerCount`	`array`	optional	Number of sellers; elements contain `time` and `value`.
`rating`	`array`	optional	Rating; elements contain `time` and `value`.
`ratingCount`	`array`	optional	Score number; elements contain `time` and `value`.
`monthlySold`	`array`	optional	Subbody sales; elements contain `time` and `value`.
`costToken`	`integer`	optional	Consume token.
`time`	`—`	optional	Time; the specific type shall be subject to the source file or upstream official documentation.
`value`	`—`	optional	The indicator value corresponding to the time point; the specific type shall be subject to the source file or upstream official documentation.
`categoryName`	`—`	optional	Category name; the specific type shall be subject to the source file or upstream official documentation.
`points`	`—`	optional	This category is a BSR time series point, and the elements include `time` and `value`; the specific type is subject to the source file or the upstream official document.

Example Q&A

Based on a published documentation sample, not a live tool call.

Your Question

Show the price and main-category rank history for ASIN 2317012837 on Amazon France.

Example Answer

The sample includes a price point of 7.92 at September 16, 2025, 14:00, and a main-category rank of 127,988 in “Livres” at October 1, 2025, 21:20. These points have different timestamps and should be charted on their own timelines.

About this sample: These are historical observations, not current price or rank. Missing values and −1 sentinels must not be plotted as ordinary prices or ranks.

View the Published Sample Data (JSON)

Published REST data example. Use Parameters & Response for MCP arguments when calling this tool.

Data Example

Sample request and response

Request parameters

{
  "asin": "2317012837",
  "domain": "4",
  "days": 365,
  "showPrice": 1,
  "showBsrMain": 1
}

Response

{
  "code": 0,
  "msg": null,
  "data": {
    "rating": [
      {
        "time": "2022-12-15 12:52",
        "value": 4.2
      },
      {
        "time": "2026-06-13 03:56",
        "value": 4.3
      }
    ],
    "ratingCount": [
      {
        "time": "2025-01-07 20:04",
        "value": 71
      },
      {
        "time": "2025-11-01 23:20",
        "value": 72
      },
      {
        "time": "2025-11-30 01:00",
        "value": 73
      },
      {
        "time": "2026-01-17 23:48",
        "value": 74
      },
      {
        "time": "2026-02-04 04:04",
        "value": 75
      },
      {
        "time": "2026-04-08 19:36",
        "value": 76
      }
    ],
    "monthlySold": [],
    "bsrMain": [
      {
        "categoryName": "Livres",
        "points": [
          {
            "time": "2025-10-01 21:20",
            "value": 127988
          },
          {
            "time": "2025-10-04 07:48",
            "value": 192506
          },
          {
            "time": "2025-10-12 04:52",
            "value": 305245
          },
          {
            "time": "2025-10-24 03:56",
            "value": 397080
          },
          {
            "time": "2025-10-30 20:16",
            "value": 433084
          },
          {
            "time": "2025-11-09 17:40",
            "value": 444229
          },
          {
            "time": "2025-11-17 16:24",
            "value": 71421
          },
          {
            "time": "2025-12-04 01:08",
            "value": 423267
          },
          {
            "time": "2025-12-11 15:48",
            "value": 256987
          },
          {
            "time": "2025-12-20 23:52",
            "value": 427938
          },
          {
            "time": "2025-12-21 23:38",
            "value": 434462
          },
          {
            "time": "2025-12-24 15:54",
            "value": 451873
          },
          {
            "time": "2025-12-29 08:12",
            "value": 465041
          },
          {
            "time": "2026-01-11 06:14",
            "value": 407326
          },
          {
            "time": "2026-02-04 04:04",
            "value": 518948
          },
          {
            "time": "2026-02-09 09:16",
            "value": 513236
          },
          {
            "time": "2026-02-12 22:14",
            "value": 529489
          },
          {
            "time": "2026-03-17 23:52",
            "value": 203378
          },
          {
            "time": "2026-04-09 05:08",
            "value": 445442
          },
          {
            "time": "2026-04-15 14:24",
            "value": 480714
          },
          {
            "time": "2026-04-30 02:14",
            "value": 513102
          },
          {
            "time": "2026-05-05 04:42",
            "value": 520832
          },
          {
            "time": "2026-05-08 00:56",
            "value": 525207
          },
          {
            "time": "2026-05-08 14:56",
            "value": 526010
          },
          {
            "time": "2026-05-09 15:30",
            "value": 530709
          },
          {
            "time": "2026-05-10 05:12",
            "value": 532386
          },
          {
            "time": "2026-05-30 08:04",
            "value": 544318
          },
          {
            "time": "2026-06-11 07:48",
            "value": 680863
          },
          {
            "time": "2026-06-12 14:16",
            "value": 675017
          },
          {
            "time": "2026-06-13 03:56",
            "value": 678309
          },
          {
            "time": "2026-06-16 06:32",
            "value": 676795
          },
          {
            "time": "2026-07-09 12:48",
            "value": 92365
          },
          {
            "time": "2026-07-18 22:08",
            "value": 327412
          },
          {
            "time": "2026-07-28 00:40",
            "value": 62295
          },
          {
            "time": "2026-07-31 03:44",
            "value": 172703
          },
          {
            "time": "2026-08-03 05:48",
            "value": 264256
          },
          {
            "time": "2026-08-08 22:30",
            "value": 384008
          },
          {
            "time": "2026-08-13 03:50",
            "value": 435153
          },
          {
            "time": "2026-08-13 15:55",
            "value": 438969
          },
          {
            "time": "2026-08-21 00:54",
            "value": 261357
          },
          {
            "time": "2026-08-24 09:59",
            "value": 336952
          },
          {
            "time": "2026-08-26 18:52",
            "value": 374853
          },
          {
            "time": "2026-08-27 20:37",
            "value": 389923
          },
          {
            "time": "2026-09-02 12:56",
            "value": 465001
          },
          {
            "time": "2026-09-03 13:23",
            "value": 483515
          },
          {
            "time": "2026-09-08 14:39",
            "value": 544497
          },
          {
            "time": "2026-09-11 19:16",
            "value": 578773
          },
          {
            "time": "2026-09-23 01:20",
            "value": 663366
          },
          {
            "time": "2026-09-23 20:15",
            "value": 669274
          },
          {
            "time": "2026-09-24 06:05",
            "value": 670812
          },
          {
            "time": "2026-09-27 23:05",
            "value": 679964
          },
          {
            "time": "2026-10-02 05:38",
            "value": 693369
          }
        ]
      }
    ],
    "price": [
      {
        "time": "2025-09-16 14:00",
        "value": 7.92
      },
      {
        "time": "2025-11-09 17:40",
        "value": 8
      },
      {
        "time": "2025-12-04 01:08",
        "value": 8.950000000000001
      },
      {
        "time": "2026-03-13 00:08",
        "value": 18.95
      },
      {
        "time": "2026-05-05 04:42",
        "value": 15.950000000000001
      },
      {
        "time": "2026-08-13 03:50",
        "value": 32
      },
      {
        "time": "2026-09-27 23:05",
        "value": 28.52
      }
    ],
    "asin": "2317012837",
    "buyboxPrice": [
      {
        "time": "2024-11-24 06:00",
        "value": 8.950000000000001
      },
      {
        "time": "2025-12-11 15:48",
        "value": -1
      },
      {
        "time": "2026-06-11 07:48",
        "value": 15.950000000000001
      },
      {
        "time": "2026-07-09 12:48",
        "value": -1
      }
    ],
    "bsrSub": [
      {
        "categoryName": "Jeux",
        "points": [
          {
            "time": "2025-10-01 21:20",
            "value": 1408
          },
          {
            "time": "2025-10-04 07:48",
            "value": 2220
          },
          {
            "time": "2025-10-12 04:52",
            "value": 3773
          },
          {
            "time": "2025-10-24 03:56",
            "value": 5196
          },
          {
            "time": "2025-10-30 20:16",
            "value": 5778
          },
          {
            "time": "2025-11-09 17:40",
            "value": 6023
          },
          {
            "time": "2025-11-17 16:24",
            "value": 971
          },
          {
            "time": "2025-12-04 01:08",
            "value": 6622
          },
          {
            "time": "2025-12-11 15:48",
            "value": 4157
          },
          {
            "time": "2025-12-20 23:52",
            "value": 7095
          },
          {
            "time": "2025-12-21 23:38",
            "value": 7188
          },
          {
            "time": "2025-12-24 15:54",
            "value": 7449
          },
          {
            "time": "2025-12-29 08:12",
            "value": 7652
          },
          {
            "time": "2026-01-11 06:14",
            "value": 6104
          },
          {
            "time": "2026-02-04 04:04",
            "value": 7372
          },
          {
            "time": "2026-02-09 09:16",
            "value": 7218
          },
          {
            "time": "2026-02-12 22:14",
            "value": 7494
          },
          {
            "time": "2026-03-17 23:52",
            "value": 2693
          },
          {
            "time": "2026-04-09 05:08",
            "value": 6382
          },
          {
            "time": "2026-04-15 14:24",
            "value": 6853
          },
          {
            "time": "2026-04-30 02:14",
            "value": -1
          }
        ]
      },
      {
        "categoryName": "Jeux de société",
        "points": [
          {
            "time": "2023-04-21 12:06",
            "value": -1
          },
          {
            "time": "2026-04-30 02:14",
            "value": 1370
          },
          {
            "time": "2026-05-05 04:42",
            "value": 1412
          },
          {
            "time": "2026-05-08 00:56",
            "value": 1407
          },
          {
            "time": "2026-05-08 14:56",
            "value": 1403
          },
          {
            "time": "2026-05-09 15:30",
            "value": 1423
          },
          {
            "time": "2026-05-10 05:12",
            "value": 1429
          },
          {
            "time": "2026-05-11 18:40",
            "value": 1426
          },
          {
            "time": "2026-05-30 08:04",
            "value": 1490
          },
          {
            "time": "2026-06-11 07:48",
            "value": 1542
          },
          {
            "time": "2026-06-12 14:16",
            "value": 1537
          },
          {
            "time": "2026-06-13 03:56",
            "value": 1541
          },
          {
            "time": "2026-06-16 06:32",
            "value": 1498
          },
          {
            "time": "2026-07-09 12:48",
            "value": 156
          },
          {
            "time": "2026-07-18 22:08",
            "value": 596
          },
          {
            "time": "2026-07-28 00:40",
            "value": 106
          },
          {
            "time": "2026-07-31 03:44",
            "value": 311
          },
          {
            "time": "2026-08-03 05:48",
            "value": 509
          },
          {
            "time": "2026-08-08 22:30",
            "value": 729
          },
          {
            "time": "2026-08-13 03:50",
            "value": 830
          },
          {
            "time": "2026-08-13 15:55",
            "value": 837
          },
          {
            "time": "2026-08-21 00:54",
            "value": 486
          },
          {
            "time": "2026-08-24 09:59",
            "value": 625
          },
          {
            "time": "2026-08-26 18:52",
            "value": 719
          },
          {
            "time": "2026-08-27 20:37",
            "value": 757
          },
          {
            "time": "2026-09-02 12:56",
            "value": 919
          },
          {
            "time": "2026-09-03 13:23",
            "value": 955
          },
          {
            "time": "2026-09-08 14:39",
            "value": 1075
          },
          {
            "time": "2026-09-11 19:16",
            "value": 1129
          },
          {
            "time": "2026-09-23 01:20",
            "value": 1282
          },
          {
            "time": "2026-09-23 20:15",
            "value": 1285
          },
          {
            "time": "2026-09-24 06:05",
            "value": 1286
          },
          {
            "time": "2026-09-27 23:05",
            "value": 1314
          },
          {
            "time": "2026-10-02 05:38",
            "value": 1378
          }
        ]
      }
    ]
  }
}

View the MCP Request & Response Format

Examples