API reference
Amazon Monitoring API
Subscriptions: fresh observations hourly, every 6 hours or daily, charged per delivery.
Add products once and receive fresh observations hourly, every 6 hours or daily, without posting tasks yourself. Each delivered observation is charged at your monitoring rate; adding, listing and deleting subscriptions is free.
If the balance cannot cover an observation, subscriptions switch to paused_balance and resume automatically once balance is added.
Endpoints
- POSTaddAdd products to monitoringAdd products once and receive fresh observations hourly, every 6 hours or daily.$0.0006 / observation
- POSTdeleteDelete monitored productsStop monitoring products by subscription id or by ASIN and marketplace.Free
- GETlistList monitored productsYour subscriptions with the latest observation of each product.Free
Frequencies and cost
Each delivered observation costs $0.0006 at list price (volume rates on request). Monthly estimates per monitored product (30-day month):
| frequency | Observations per month | Cost per product per month |
|---|---|---|
hourlyHourly | 720 | ≈ $0.43 |
every_6hEvery 6 hours | 120 | ≈ $0.07 |
dailyDaily | 30 | ≈ $0.02 |
Subscription object
A monitored product. monitoring/add returns it without latest_observation.
idSubscription id. Use it with monitoring/delete.
asinMonitored ASIN.
marketplaceMarketplace code.
frequencyhourly, every_6h or daily.
tagYour tag.
external_user_idYour opaque end-user id.
statusactive, or paused_balance while the balance cannot cover observations (resumes automatically once balance is added).
created_atWhen the subscription was created, ISO 8601 in UTC.
latest_observationThe latest observation delivered to this subscription (a product object, same shape as in task_get), or null before the first delivery. Returned by monitoring/list only.
Deleted subscription
Confirmation for one deleted subscription.
idSubscription id.
asinASIN.
marketplaceMarketplace code.
statusAlways deleted.
deleted_atWhen the subscription was deleted, ISO 8601 in UTC.