Skip to main content
GET /v1/research/products/{id}/history and GET /v1/research/shops/{id}/history return every completed calendar month (UTC) of estimated sales and revenue in one response. This one prints a product’s months:
The response looks like this:
  • Months run up to history_through, the last completed month. The current month is never included, because it isn’t over.
  • A month Alura has no data for is null, not 0. data itself is null when Alura has no usable history for the item, so check it before looping.
  • est_revenue_usd values each month’s sales at the product’s current price, not the price it had that month. For a shop it uses the shop’s current average price.
  • Estimates for recent months can still change, because buyers keep reviewing orders for weeks. methodology_version says which method produced the numbers; see Sales estimates.
Sales history needs the Growth plan or above. On Free and Basic, the answer is 403 plan_required with upgrade_url, and nothing is charged. GET /v1/research/products/{id}/history costs 1 API credit for the whole history, as does GET /v1/research/shops/{id}/history. In an AI assistant, the get_sales_history tool covers both. History never fetches anything from Etsy: an item Alura doesn’t know answers 404 not_found.