Skip to main content
Glama

Easyparser — Amazon Product & Seller Data

get_sales_history

Read-only

Retrieve a product's historical performance over up to 12 months: weekly aggregated trends for estimated views/traffic, sales, price, and Best Sellers Rank. This is Easyparser's 'time machine' — the deepest competitive-intelligence tool in this server.

Use this tool for trend forecasting, seasonality analysis, conversion-rate estimation, and investment/sourcing due diligence. Do NOT use it for a simple current price check — get_product_detail is 5x cheaper for that.

IMPORTANT cost rule: the base cost is 5 credits, and each month of history adds 1 credit (3 months = 8 credits, 12 months = 17 credits). Always ask the user how far back they need, or default to 3 months for a quick trend read. The history array in the response is aggregated by WEEK, not by day.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
asinYesAmazon Standard Identification Number — a 10-character alphanumeric product identifier (e.g. B0CJB6V2L5). Found in the product URL after /dp/ or /gp/product/.
domainNoAmazon marketplace domain extension. Determines the regional Amazon site the data is fetched from. Use the domain that matches the user's market — prices, availability and rankings differ across marketplaces..com
history_rangeNoDepth of historical data in months. '0' returns only the current snapshot (5 credits). '3', '6', '9', '12' add weekly history at +1 credit per month. Default '0'.0

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
dataNoParsed Amazon data for the operation.
successYesTrue when the request completed.
operationYesEasyparser operation that ran, e.g. DETAIL or OFFER.
request_idNoEasyparser request ID, useful for support and error logs.
credits_usedNoCredits charged for this request.
credits_remainingNoCredits left on the account after this request.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "additionalProperties": false,
      +  "properties": {
      +    "credits_remaining": {
      +      "description": "Credits left on the account after this request.",
      +      "type": "number"
      +    },
      +    "credits_used": {
      +      "description": "Credits charged for this request.",
      +      "type": "number"
      +    },
      +    "data": {
      +      "description": "Parsed Amazon data for the operation."
      +    },
      +    "operation": {
      +      "description": "Easyparser operation that ran, e.g. DETAIL or OFFER.",
      +      "type": "string"
      +    },
      +    "request_id": {
      +      "description": "Easyparser request ID, useful for support and error logs.",
      +      "type": "string"
      +    },
      +    "success": {
      +      "description": "True when the request completed.",
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "success",
      +    "operation"
      +  ],
      +  "type": "object"
      +}
  2. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.