Inventory
27 tools for stock levels, order management, sales velocity, listings, triage, and live plus historical pricing data.
get_fba_inventoryReadGet FBA inventory snapshot. Fulfillable, reserved, inbound, and unfulfillable quantities per ASIN/SKU. Defaults to latest snapshot date.
When to use
Check current stock levels across FBA warehouses, including reserved, inbound, and unfulfillable quantities.
Parameters
| Name | Type | Description |
|---|---|---|
asin | string | Filter by ASIN. |
sku | string | Filter by SKU. |
sort_order | enum (desc) | Sort direction: asc or desc. |
limit | number (20) | Max rows to return (1-1000). |
snapshot_date | string | Snapshot date (YYYY-MM-DD). Defaults to latest. |
sort_by | enum (fulfillable_quantity) | Column to sort by: fulfillable_quantity, reserved_quantity, unfulfillable_quantity, asin. |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- Check unfulfillable_quantity regularly. These units need removal orders or will incur fees.
- High reserved_quantity relative to fulfillable_quantity may indicate slow processing or customer-reserved units.
- Use snapshot_date to compare inventory levels over time.
get_inventory_healthReadGet FBA inventory health. Age buckets, weeks of cover, LTSF charges, sell-through, and Amazon recommended order quantity field.
When to use
Inspect aging inventory, estimated long-term storage fees, weeks of cover, sell-through, and Amazon recommended order quantity values.
Parameters
| Name | Type | Description |
|---|---|---|
sku | string | Filter by SKU. |
sort_order | enum (desc) | Sort direction: asc or desc. |
limit | number (20) | Max rows to return (1-1000). |
snapshot_date | string | Snapshot date (YYYY-MM-DD). Defaults to latest. |
min_age_days | number | Only show items with inventory older than N days. |
excess_only | boolean (false) | Only show items with estimated LTSF charges > 0. |
sort_by | enum (available) | Column to sort by: available, weeks_of_cover_t30, estimated_ltsf_next_charge, sell_through, inv_age_365_plus_days, sku. |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- Use excess_only=true to quickly find items that will incur long-term storage fees.
- Sort by estimated_ltsf_next_charge descending to list the highest estimated long-term storage fee exposure first.
- Cross-reference with get_active_listings to get the ASIN for each SKU.
Watch out
- This report only has SKU, not ASIN. Use get_active_listings to map SKU to ASIN.
get_inventory_movementsReadGet inventory ledger movements. Shipments, receipts, adjustments, customer orders, and returns by date/ASIN/SKU.
When to use
Track inventory movements over time to understand stock changes, investigate discrepancies, or audit inbound shipments.
Parameters
| Name | Type | Description |
|---|---|---|
asin | string | Filter by ASIN. |
sku | string | Filter by SKU. |
sort_order | enum (desc) | Sort direction: asc or desc. |
limit | number (20) | Max rows to return (1-1000). |
start_date | string | Start date (YYYY-MM-DD). |
end_date | string | End date (YYYY-MM-DD). |
event_type | string | Filter by event type (e.g. Shipments, Receipts, CustomerOrders). |
sort_by | enum (date) | Column to sort by: date, quantity, asin. |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- Filter by event_type=Receipts to track inbound shipment receiving progress.
- Use event_type=CustomerOrders to see daily outbound order volume per ASIN.
- Compare inbound (Receipts) vs outbound (CustomerOrders) to validate sell-through rates.
Related tools
get_awd_inventoryReadGet AWD (Amazon Warehousing and Distribution) inventory snapshot. Inbound and on-hand quantities per SKU/FNSKU.
When to use
Check upstream inventory stored in AWD warehouses that will be automatically replenished to FBA.
Parameters
| Name | Type | Description |
|---|---|---|
sku | string | Filter by SKU. |
sort_order | enum (desc) | Sort direction: asc or desc. |
limit | number (20) | Max rows to return (1-1000). |
snapshot_date | string | Snapshot date (YYYY-MM-DD). Defaults to latest. |
sort_by | enum (total_onhand_quantity) | Column to sort by: total_onhand_quantity, total_inbound_quantity, sku. |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- AWD inventory is included in the days-of-cover calculation (get_days_of_cover).
- Cross-reference with get_active_listings to map SKU/FNSKU to ASIN.
- Use get_awd_shipments to track the status of inbound AWD shipments.
Watch out
- AWD data only has SKU and FNSKU, not ASIN. Use get_active_listings for the mapping.
get_awd_shipmentsReadGet AWD shipment-level data. Shipment IDs, statuses, and timestamps. For per-SKU quantities within a shipment, use get_awd_shipment_items.
When to use
Track the status of AWD inbound shipments, check delivery timelines, or filter by shipment status.
Parameters
| Name | Type | Description |
|---|---|---|
start_date | string | Filter shipments created after this date (YYYY-MM-DD). |
end_date | string | Filter shipments created before this date (YYYY-MM-DD). |
shipment_status | string | Filter by shipment status. |
sort_order | enum (desc) | Sort direction: asc or desc. |
limit | number (20) | Max rows to return (1-1000). |
sort_by | enum (created_at) | Column to sort by: created_at, updated_at, shipment_status. |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- Use get_awd_shipment_items to see per-SKU quantities within a specific shipment.
- Filter by shipment_status to monitor in-transit or receiving shipments.
get_awd_shipment_itemsReadGet per-SKU line items from AWD shipments. SKU, quantity per shipment. Use to prorate AWD/AGL freight charges to specific ASINs. Defaults to latest snapshot.
When to use
Break down an AWD shipment into per-SKU quantities for cost allocation or to verify shipment contents.
Parameters
| Name | Type | Description |
|---|---|---|
shipment_id | string | Filter by specific shipment ID. |
sku | string | Filter by specific SKU. |
snapshot_date | string | Snapshot date (YYYY-MM-DD). Defaults to latest. |
sort_order | enum (desc) | Sort order by snapshot_date. |
limit | number (20) | Max rows to return (1-1000). |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- Filter by shipment_id to see the per-SKU breakdown of a specific shipment.
- Use the quantities to prorate AWD/AGL freight charges to specific SKUs for profitability analysis.
Watch out
- AWD data only has SKU and FNSKU, not ASIN. Use get_active_listings for the mapping.
get_inbound_shipmentsReadGet FBA inbound shipment data. Shipment IDs, statuses, destination fulfillment centers, and timestamps. For per-SKU receiving progress, use get_shipment_receiving_status.
When to use
Track FBA inbound shipments, check which fulfillment center is receiving, or monitor shipment status (WORKING, SHIPPED, RECEIVING, CLOSED).
Parameters
| Name | Type | Description |
|---|---|---|
start_date | string | Filter shipments from this date (YYYY-MM-DD). |
end_date | string | Filter shipments before this date (YYYY-MM-DD). |
shipment_status | string | Filter by status (e.g., WORKING, SHIPPED, RECEIVING, CLOSED, CANCELLED). |
sort_by | enum (snapshot_date) | Column to sort by: snapshot_date, shipment_status, shipment_name. |
sort_order | enum (desc) | Sort direction: asc or desc. |
limit | number (20) | Max rows to return (1-1000). |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- Use get_shipment_receiving_status to see per-SKU quantities and receiving progress within a shipment.
- Filter by shipment_status=RECEIVING to find shipments currently being checked in at Amazon.
get_shipment_receiving_statusReadGet per-SKU receiving status for FBA inbound shipments. Shows quantity shipped vs quantity received by Amazon. Defaults to latest snapshot.
When to use
Track how many units Amazon has received per SKU in an inbound shipment, find receiving discrepancies, or verify shipment completeness.
Parameters
| Name | Type | Description |
|---|---|---|
shipment_id | string | Filter by specific shipment ID. |
sku | string | Filter by specific seller SKU. |
snapshot_date | string | Snapshot date (YYYY-MM-DD). Defaults to latest. |
sort_order | enum (desc) | Sort order by snapshot_date. |
limit | number (20) | Max rows to return (1-1000). |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- Compare quantity_shipped vs quantity_received to find receiving discrepancies.
- Filter by shipment_id to see the per-SKU breakdown of a specific inbound shipment.
Watch out
- Data uses SKU and FNSKU, not ASIN. Use get_active_listings for the SKU-to-ASIN mapping.
get_sales_velocityReadGet sales and traffic data. With ASIN: returns daily time series. Without ASIN: returns per-ASIN aggregated summary with average daily units over the date range.
When to use
Analyze sales velocity per ASIN for inventory planning, or get a daily time series to spot trends and anomalies.
Parameters
| Name | Type | Description |
|---|---|---|
asin | string | Filter by ASIN. |
sku | string | Filter by SKU. |
sort_order | enum (desc) | Sort direction: asc or desc. |
limit | number (20) | Max rows to return (1-1000). |
start_date | string | Start date (YYYY-MM-DD). |
end_date | string | End date (YYYY-MM-DD). |
sort_by | enum (units_ordered) | Column to sort by: units_ordered, ordered_product_sales, sessions, page_views, buy_box_percentage, unit_session_percentage, asin, date. |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- Omit the asin parameter to get a summary with avg_daily_units across all ASINs.
- Use with a specific ASIN to get the day-by-day time series for trend analysis.
- The avg_daily_units value is used by get_days_of_cover for reorder calculations.
get_active_listingsReadGet active listings. The ASIN/SKU/FNSKU registry. Use this to map SKUs to ASINs for cross-referencing with AWD and inventory health data.
When to use
Look up the ASIN/SKU/FNSKU mapping for any product, or get a complete inventory of your active listings with prices and quantities.
Parameters
| Name | Type | Description |
|---|---|---|
asin | string | Filter by ASIN. |
sku | string | Filter by SKU. |
sort_order | enum (desc) | Sort direction: asc or desc. |
limit | number (20) | Max rows to return (1-1000). |
sort_by | enum (asin) | Column to sort by: asin, sku, price, quantity. |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- This is the master registry for mapping between ASIN, SKU, and FNSKU.
- Use this to resolve SKU-only data from inventory health and AWD tools back to ASINs.
- Check the status field to verify listings are in active selling state.
get_suppressed_listingsReadGet suppressed/stranded listings. Items that are in FBA inventory but not buyable. Use this to detect stranded inventory that needs fixing.
When to use
Find listings that have been suppressed or stranded, meaning you have inventory at FBA but the listing is not live for customers to purchase.
Parameters
| Name | Type | Description |
|---|---|---|
asin | string | Filter by ASIN. |
sku | string | Filter by SKU. |
sort_order | enum (desc) | Sort direction: asc or desc. |
limit | number (20) | Max rows to return (1-1000). |
ob_date | string | Filter by observation date (YYYY-MM-DD). |
sort_by | enum (sku) | Column to sort by: asin, sku, quantity. |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- Any suppressed listing means you are paying storage fees on inventory that cannot sell.
- Fix suppressed listings as a priority since they represent pure cost with no revenue potential.
- Common causes include missing product information, listing policy violations, or brand disputes.
get_days_of_coverReadGet days-of-cover analysis. Joins FBA inventory + AWD inventory + sales velocity + active listings to calculate how many days of stock remain per ASIN. Sorted by most urgent (lowest cover) first by default.
When to use
Identify products at risk of going out of stock by checking how many days of inventory remain at the current sales velocity.
Parameters
| Name | Type | Description |
|---|---|---|
asin | string | Filter by ASIN. |
sku | string | Filter by SKU. |
limit | number (20) | Max rows to return (1-1000). |
sales_lookback_days | number (30) | Number of days to look back for sales velocity (7-90). |
min_days_of_cover | number | Only show ASINs with at least this many days of cover. |
max_days_of_cover | number | Only show ASINs with at most this many days of cover. |
sort_order | enum (asc) | Sort direction. Default asc shows most urgent first. |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- This is the single most important inventory health metric. Run it regularly.
- Set max_days_of_cover=30 to focus on ASINs that need reordering within the next month.
- The pipeline_total includes FBA fulfillable + reserved + inbound + AWD on-hand.
- Adjust sales_lookback_days for seasonal products (shorter for volatile periods, longer for stable).
get_inventory_risk_triageReadReturn inventory risk signals across FBA/AWD stock, sales velocity, inventory health, and suppressed-listing data.
When to use
Inspect stockout, overstock, aged inventory, stranded listing, and unfulfillable-unit risk states in one result set.
Parameters
| Name | Type | Description |
|---|---|---|
asin | string | Filter by ASIN. |
sku | string | Filter by SKU. |
sales_lookback_days | number (30) | Sales velocity lookback window in days (7-90). |
stockout_threshold_days | number (21) | Flag stockout risk at or below this many days of cover. |
overstock_threshold_days | number (180) | Flag overstock risk at or above this many days of cover. |
risk_focus | enum (all) | Risk category: all, stockout, overstock, aged_inventory, suppressed_listing, or unfulfillable_inventory. |
include_healthy | boolean (false) | Set true to include healthy rows after risks. |
limit | number (20) | Max risk rows to return (1-100). |
Tips
- Filter risk_focus=stockout to return rows at or below the selected days-of-cover threshold.
- Filter risk_focus=aged_inventory to return rows with aged inventory or estimated storage charges.
- Use ASIN or SKU filters when investigating a product called out by another tool.
Watch out
- Suppressed listing risk is skipped when the tenant does not yet have a suppressed listings table. Other inventory signals still run.
get_todays_salesReadAggregate today's orders into a revenue summary. Returns top ASINs by revenue with units and order counts, plus a totals summary row.
When to use
Get a quick real-time snapshot of today's sales performance broken down by ASIN.
Parameters
| Name | Type | Description |
|---|---|---|
limit | number (20) | Top N ASINs to return. |
fulfillment_channel | enum | Filter by fulfillment channel: AFN (FBA) or MFN (merchant). |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- This is near-real-time, unlike Business Reports which have a ~72 hour delay.
- The last row is always a TOTALS summary across all returned ASINs.
- Filter by fulfillment_channel=AFN to see only FBA orders.
Related tools
get_sales_summaryReadGet aggregated daily sales metrics from the Sales API. Returns total revenue, units, orders, and average unit price per day. Near-real-time (hours delay) vs Business Reports (72h delay). Does not break down by ASIN.
When to use
Get a clean daily revenue time series without the noise of per-order data. Best for spotting trends and comparing day-over-day performance at the account level.
Parameters
| Name | Type | Description |
|---|---|---|
start_date | string (7 days ago) | Start date (YYYY-MM-DD). |
end_date | string (today) | End date (YYYY-MM-DD). |
sort_by | enum (metric_date) | Column to sort by: metric_date, total_sales, unit_count, order_count, average_unit_price. |
sort_order | enum (asc) | Sort direction: asc or desc. |
limit | number (20) | Max rows to return (1-1000). |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- Data arrives hours after orders, much faster than Business Reports (72h delay).
- Use for account-level trends. For per-ASIN breakdown, use get_sales_velocity instead.
- Default sort is ascending by date, giving you a natural time series.
Watch out
- Does not break down by ASIN. Use get_sales_velocity for per-ASIN data.
get_ordersReadList orders with optional filters. Supports filtering by date range, order status, ASIN, and fulfillment channel.
When to use
Browse recent orders, check order statuses, or filter orders by specific criteria like ASIN or fulfillment method.
Parameters
| Name | Type | Description |
|---|---|---|
start_date | string | Start date (YYYY-MM-DD) for purchase_date. |
end_date | string | End date (YYYY-MM-DD) for purchase_date. |
order_status | string | Filter by order status (e.g. Pending, Shipped, Canceled). |
asin | string | Filter orders containing this ASIN. |
fulfillment_channel | enum | Filter by fulfillment channel: AFN (FBA) or MFN (merchant). |
sort_by | enum (purchase_date) | Column to sort by: purchase_date, order_total_amount, order_status. |
sort_order | enum (desc) | Sort direction: asc or desc. |
limit | number (20) | Maximum number of orders to return (max 1000). |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- Filter by order_status=Pending to monitor orders awaiting shipment.
- Use the asin filter to find all orders containing a specific product.
- Order data is near-real-time, unlike Business Reports.
Related tools
get_order_detailsReadGet full details for a single order including the order header and all line items.
When to use
Look up a specific order by ID to see full details including line items, shipping address, prices, and promotions.
Parameters
| Name | Type | Description |
|---|---|---|
order_id* | string | The Amazon order ID to look up. |
* required
Tips
- Use get_orders first to find the order_id, then use this tool for full details.
- The response includes both the order header and all line items with per-item pricing.
- Check promotion_ids and promotion_discount_amount to understand discount impact on specific items.
Related tools
get_returnsReadGet FBA return records. Filter by date range, ASIN, SKU, return reason, or disposition status.
When to use
Investigate return trends, find products with high return rates, or check the disposition of returned items.
Parameters
| Name | Type | Description |
|---|---|---|
start_date | string | Start date (YYYY-MM-DD) for return_date. |
end_date | string | End date (YYYY-MM-DD) for return_date. |
asin | string | Filter by ASIN. |
sku | string | Filter by SKU. |
reason | string | Filter by return reason (e.g. DEFECTIVE, CUSTOMER_RETURN). |
disposition | string | Filter by item disposition (e.g. SELLABLE, DAMAGED). |
sort_by | enum (return_date) | Column to sort by: return_date, quantity, asin, reason. |
sort_order | enum (desc) | Sort direction: asc or desc. |
limit | number (20) | Maximum number of rows to return (1-1000). |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- Filter by reason=DEFECTIVE to identify potential product quality issues.
- Check customer_comments for insights into why customers are returning products.
- High return rates on specific ASINs may indicate listing accuracy issues or product defects.
Related tools
get_reimbursementsReadGet FBA reimbursement records. Filter by date range, ASIN, or reason. Sorted by amount_total by default to surface highest-value reimbursements first.
When to use
Track FBA reimbursements for lost, damaged, or destroyed inventory, and identify patterns that may need investigation.
Parameters
| Name | Type | Description |
|---|---|---|
start_date | string | Start date (YYYY-MM-DD) for approval_date. |
end_date | string | End date (YYYY-MM-DD) for approval_date. |
asin | string | Filter by ASIN. |
reason | string | Filter by reimbursement reason (e.g. LOST_INBOUND, DAMAGED_WAREHOUSE). |
sort_by | enum (amount_total) | Column to sort by: approval_date, amount_total, reason, asin. |
sort_order | enum (desc) | Sort direction: asc or desc. |
limit | number (20) | Maximum number of rows to return (1-1000). |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- Sort by amount_total descending to focus on the highest-value reimbursements first.
- Filter by reason=LOST_INBOUND to track inventory that went missing during inbound shipments.
- Compare reimbursement amounts against product value to ensure you are being fully reimbursed.
Related tools
get_seasonality_indexReadGet the seasonality index for ASINs. A pre-computed 52-week demand curve built from historical sales, sessions, and revenue data. Index value of 1.0 = average week, >1.0 = above-average demand, <1.0 = below-average.
When to use
Plan inventory and advertising around seasonal demand patterns, or understand which weeks have peak and trough demand.
Parameters
| Name | Type | Description |
|---|---|---|
asin | string | Filter by ASIN. Omit for a summary of all ASINs ranked by seasonal amplitude. |
min_confidence | number | Only show data with at least this confidence score (0-1). |
event | string | Filter to weeks matching a retail event (e.g. Prime Day, BFCM, Christmas, New Year, Back to School). |
limit | number (20) | Max rows to return (1-1000). |
sort_order | enum (desc) | Sort direction. Default desc shows most seasonal first. |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- Use without ASIN to get a summary view ranked by amplitude (most seasonal products first).
- Use with a specific ASIN to get the full 52-week demand curve for inventory planning.
- Filter by event to see how your products perform during specific retail events.
- Combine with get_days_of_cover to ensure you have enough inventory ahead of peak weeks.
Related tools
get_current_rankLive APICheck the current search rank position for a keyword in real time. Returns the top results from Amazon catalog search. If a target ASIN is provided, highlights its position.
When to use
Spot-check where a product currently ranks for a specific keyword in Amazon search results, right now.
Parameters
| Name | Type | Description |
|---|---|---|
keyword* | string | Search keyword to check ranking for (1-200 characters). |
target_asin | string | Your ASIN to find in results. If provided, highlights its position. |
max_pages | number (3) | Number of result pages to check, 20 results per page (1-5). |
* required
Tips
- Use target_asin to quickly see if your product appears and at what position.
- Results reflect the current moment, so they may differ from daily rank snapshots.
- Increase max_pages to 5 if your product is expected to rank beyond page 3.
Watch out
- This is a live API call. Results vary throughout the day due to Amazon search personalization and A/B testing.
get_buybox_statusHybridCheck current Buy Box status for ASINs, or provide a date window to return stored Buy Box win-rate history from daily pricing snapshots.
When to use
Check whether you currently own the Buy Box, or use a date window to measure how consistently you kept it over time.
Parameters
| Name | Type | Description |
|---|---|---|
asins* | array | ASINs to check Buy Box status for (1-20, string array). |
start_date | string | Start date (YYYY-MM-DD). When provided, switches to pricing-history mode. |
end_date | string | End date (YYYY-MM-DD). Defaults to today when using history mode. |
limit | number (100) | Max historical rows to return (1-1000). |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
* required
Tips
- Losing the Buy Box directly impacts sales since most purchases go through the Buy Box winner.
- Compare your price against the Buy Box price to understand competitiveness.
- Check total offer listings count to gauge competitive intensity.
- Provide start_date/end_date to get daily ownership history plus range win-rate columns from stored pricing snapshots.
Watch out
- Without a date window this is a live point-in-time snapshot. With a date window it uses daily pricing snapshots, so intraday shifts are not captured.
get_competitive_pricingHybridGet competitive price points for ASINs. Defaults to live SP-API data, or provide a date window to return stored pricing history from daily snapshots.
When to use
Get a complete live pricing view for your ASINs, or inspect how Buy Box and lowest non-featured prices moved over time.
Parameters
| Name | Type | Description |
|---|---|---|
asins* | array | ASINs to check competitive pricing for (1-20, string array). |
start_date | string | Start date (YYYY-MM-DD). When provided, switches to pricing-history mode. |
end_date | string | End date (YYYY-MM-DD). Defaults to today when using history mode. |
limit | number (100) | Max historical rows to return (1-1000). |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
* required
Tips
- Compare landed prices (listing price + shipping) for a true cost comparison.
- Check if your price is the Buy Box price (price type "Buy Box") vs lowest non-featured.
- Use alongside get_buybox_status for a comprehensive competitive pricing view.
- Provide start_date/end_date to get daily pricing snapshots for trend analysis and price-change review.
Watch out
- Without a date window this is a live API call. With a date window it returns the stored daily pricing snapshots, not every intraday change.
get_offer_listingsLive APISee who is selling a product right now. Returns current Amazon offer listings for an ASIN, including seller IDs, prices, fulfillment method, seller feedback, and Buy Box status.
When to use
Investigate the competitive landscape for a specific ASIN by seeing active offers, seller identifiers, prices, and seller reputation.
Parameters
| Name | Type | Description |
|---|---|---|
asin* | string | ASIN to check offers for. |
item_condition | enum (New) | Item condition to filter offers by: New, Used, Collectible, Refurbished, or Club. |
customer_type | enum (Consumer) | Whether to return Consumer or Business offers. |
* required
Tips
- Check seller feedback ratings to understand the quality of your competition.
- Compare FBA vs merchant-fulfilled offer prices to gauge fulfillment advantage.
- Use customer_type=Business when you need Amazon Business offer visibility instead of the consumer view.
- Low total offer count suggests less competitive pressure.
get_restock_recommendationsHybridGet Subscribe and Save replenishment offer status from Amazon's Replenishment API. Defaults to live data, or provide a date window to return stored daily offer history.
When to use
Inspect Amazon Subscribe and Save replenishment offer health, inventory risk, projected delivery volume, and how those signals changed across daily snapshots.
Parameters
| Name | Type | Description |
|---|---|---|
asins | array | Filter by specific ASINs (1-20). Omit to return matching offers. |
start_date | string | Start date (YYYY-MM-DD). When provided, switches to replenishment-history mode. |
end_date | string | End date (YYYY-MM-DD). Defaults to today when using history mode. |
limit | number (20) | Max live offers or historical rows to return. Live mode is capped at 100 by Amazon. |
include_raw_rows | boolean (false) | Set true to include full raw result rows in structuredContent. Defaults to false; text content still includes a small row preview. |
Tips
- Use this to spot offers with low inventory risk, paused deliveries, or projected subscription demand spikes.
- Delivery conditions help distinguish pricing issues from low-inventory issues.
- Provide start_date/end_date to compare inventory, subscription count, and forecast delivery changes over time.
- Use alongside get_days_of_cover and get_seasonality_index for broader replenishment planning outside Subscribe and Save.
Watch out
- Amazon's Replenishment API currently covers Subscribe and Save offers, not generic FBA restock recommendations.
get_fba_eligibilityLive APICheck if an ASIN is eligible for FBA (Fulfillment by Amazon). Returns eligibility status and any Amazon ineligibility reason codes.
When to use
Verify FBA eligibility before sending inventory to Amazon, especially for new products or products in restricted categories.
Parameters
| Name | Type | Description |
|---|---|---|
asin* | string | ASIN to check FBA eligibility for. |
program | enum (INBOUND) | FBA program to check: INBOUND or COMMINGLING. |
* required
Tips
- Check eligibility before creating inbound shipments to avoid rejected inventory.
- COMMINGLING eligibility means your units can be commingled with other sellers identical products.
- Amazon returns ineligibility reason codes rather than full remediation guidance, so pair this with get_listing_restrictions when a product is blocked.
get_listing_restrictionsLive APICheck listing restrictions for an ASIN. Returns any restrictions on selling the product in a specific condition, including approval requirements and reasons.
When to use
Before listing a product, check if there are any category restrictions, approval requirements, or selling limitations.
Parameters
| Name | Type | Description |
|---|---|---|
asin* | string | ASIN to check restrictions for. |
condition_type | enum (new_new) | Product condition to check. Options: new_new, new_open_box, new_oem, refurbished_refurbished, used_like_new, used_very_good, used_good, used_acceptable, collectible_like_new, collectible_very_good, collectible_good, collectible_acceptable, club_club. |
reason_locale | string | Optional locale for localized reason text, for example en_US. |
* required
Tips
- No restrictions returned means you are clear to list in that condition.
- Restriction responses may include approval links that you can follow to apply for category approval.
- Check multiple condition types if you plan to sell in both new and used conditions.
Related tools