Catalog
13 tools for product details, sales ranks, A+ Content, variations, customer feedback, listing quality, cleanup prioritization, listing creation, listing attribute updates, price updates, and inventory quantity updates.
get_product_detailsReadGet product info for a specific ASIN from the catalog. Title, brand, product type, images, dimensions, status, and BSR (Best Sellers Rank).
When to use
Look up detailed product information for a specific ASIN, including title, dimensions, images, and current BSR.
Parameters
| Name | Type | Description |
|---|---|---|
asin* | string | ASIN to look up. |
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
- Check item_status to verify the product is in an active state.
- BSR (sales_rank) gives a relative indicator of sales volume within the category.
- Image URLs and bullet_points are useful for listing audit workflows.
Related tools
get_sales_ranksReadGet Best Sellers Rank (BSR) across your catalog. Returns rank, category, title, and brand for all ASINs with BSR data.
When to use
Monitor BSR across your entire catalog to identify top sellers and products losing rank.
Parameters
| Name | Type | Description |
|---|---|---|
asin | string | Filter by ASIN. |
max_rank | number | Only show ASINs with BSR less than or equal to this value. |
sort_by | enum (sales_rank) | Column to sort by: sales_rank, asin, title. |
sort_order | enum (asc) | Sort direction: asc or desc. Default asc shows best rank first. |
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 max_rank=10000 to focus on products in the top 10,000 of their category.
- Lower BSR means higher sales velocity. Track BSR trends over time by running this daily.
- Compare BSR against actual sales data from get_sales_velocity to validate.
get_aplus_statusReadCheck A+ Content status for your listings. Shows content documents with their approval status, associated ASINs, and last update time. Requires Brand Registry.
When to use
Audit which listings have A+ Content, check approval statuses, and identify products that are missing enhanced content.
Tips
- A+ Content typically improves conversion rates by 3-10%, so identify ASINs without it.
- Check the status field for content that may be pending review or rejected.
- Cross-reference the ASINs list against your active listings to find gaps.
Watch out
- Requires Brand Registry enrollment. Returns empty results if Brand Registry is not active.
get_variationsReadGet parent/child variation relationships for an ASIN. Shows the variation family tree including variation theme (size, color, etc.) and all child ASINs.
When to use
Understand the variation family structure for a product, find all child ASINs under a parent, or determine if an ASIN is a parent or child.
Parameters
| Name | Type | Description |
|---|---|---|
asin* | string | Parent or child ASIN to look up variation relationships for. |
* required
Tips
- Pass either a parent or child ASIN and the tool will show the full family tree.
- The variation theme (size, color, etc.) tells you which attribute differentiates the children.
- Use this to identify all child ASINs when you need to check inventory or pricing across the family.
get_product_reviewsLive APISummarize Amazon Customer Feedback review topics for a child ASIN. Returns top positive and negative topics, mentions, occurrence percentages, star-rating impact, snippets, and subtopics.
When to use
Understand what customers praise or complain about for a product without reading individual reviews manually.
Parameters
| Name | Type | Description |
|---|---|---|
asin* | string | Child ASIN to look up review topics for. |
sort_by | enum (MENTIONS) | Sort topics by MENTIONS or STAR_RATING_IMPACT. |
* required
Tips
- Use negative topics to group complaint themes by mentions, occurrence percentage, and star-rating impact.
- Use STAR_RATING_IMPACT when you care more about rating movement than mention volume.
- Compare child ASIN metrics against parent and browse-node metrics to see whether an issue is product-specific.
Watch out
- Amazon refreshes Customer Feedback data weekly. The API requires enough review volume and expects a child ASIN.
Related tools
get_review_trendsLive APIShow six-month Amazon Customer Feedback review topic trends for a child ASIN. Returns monthly occurrence percentages for top positive and negative review topics.
When to use
Track whether key praise or complaint themes are getting better or worse over the last six months.
Parameters
| Name | Type | Description |
|---|---|---|
asin* | string | Child ASIN to look up review topic trends for. |
* required
Tips
- Use this after get_product_reviews to see whether a complaint is persistent or newly emerging.
- Look for increasing negative-topic occurrence after packaging, supplier, or listing changes.
- Compare parent and browse-node percentages to separate product-specific issues from category-wide patterns.
Watch out
- Amazon refreshes Customer Feedback data weekly. The API requires enough review volume and expects a child ASIN.
get_listing_qualityReadGet listing completeness and issue summary from weekly Listings Items API snapshots. Shows missing content, status, issue counts, and core quality signals by SKU.
When to use
Audit listings for missing title, brand, image, bullet points, description, or Amazon quality warnings before conversion problems show up in sales.
Parameters
| Name | Type | Description |
|---|---|---|
asin | string | Filter by ASIN. |
sku | string | Filter by seller SKU. |
snapshot_date | string | Snapshot date (YYYY-MM-DD). Defaults to latest snapshot. |
quality_status | enum | Filter by healthy, incomplete, warning, error, or not_found. |
has_issues | boolean | When true, only return listings with Amazon issues. When false, only return listings with zero issues. |
sort_by | enum (issue_count) | Column to sort by: issue_count, error_count, warning_count, sku, asin, quality_status, snapshot_date. |
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
- Start with quality_status=error or has_issues=true to find listings Amazon is actively flagging.
- Use missing_content to separate Amazon validation issues from local content gaps.
- Join SKU results back to sales and traffic to identify listings that have both quality gaps and high traffic.
Watch out
- Snapshots refresh weekly. For live listing restrictions by condition, use get_listing_restrictions.
get_listing_issuesReadGet Amazon listing issues from weekly Listings Items API snapshots. Returns affected SKUs, issue codes, affected attributes, severity counts, and raw issue details.
When to use
Diagnose listing quality problems that need Seller Central cleanup, such as missing required attributes, invalid values, or warning-level content issues.
Parameters
| Name | Type | Description |
|---|---|---|
asin | string | Filter by ASIN. |
sku | string | Filter by seller SKU. |
snapshot_date | string | Snapshot date (YYYY-MM-DD). Defaults to latest snapshot. |
severity | enum | Filter by ERROR, WARNING, or INFO. |
issue_code | string | Filter listings containing a specific Amazon issue code. |
attribute_name | string | Filter listings containing an issue for this attribute name. |
sort_by | enum (issue_count) | Column to sort by: error_count, warning_count, issue_count, sku, asin, snapshot_date. |
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
- Filter severity=ERROR first for issues most likely to block discoverability or buyability.
- Use attribute_name to group operational fixes by required field, such as size, color, images, or dimensions.
- Use issue_code to find every SKU affected by the same Amazon validation problem.
Watch out
- issues_json is the raw issue array captured in the weekly snapshot, not a live Seller Central read.
get_catalog_cleanupReadReturn listing quality signals from snapshots: Amazon errors, warnings, missing core content, offer and fulfillment gaps, and thin listing content.
When to use
Inspect listing quality states across Amazon issues, missing content, offer availability, and fulfillment availability.
Parameters
| Name | Type | Description |
|---|---|---|
asin | string | Filter by ASIN. |
sku | string | Filter by seller SKU. |
snapshot_date | string | Snapshot date (YYYY-MM-DD). Defaults to latest listing quality snapshot. |
cleanup_focus | enum (all) | Focus category: all, amazon_error, amazon_warning, missing_core_content, offer_or_fulfillment_gap, or content_depth_gap. |
include_healthy | boolean (false) | Include healthy listings after cleanup items. |
limit | number (20) | Max cleanup rows to return (1-100). |
Tips
- Run with cleanup_focus=amazon_error to return rows with Amazon error-level listing issues.
- Use cleanup_focus=missing_core_content to find listings missing title, brand, or main image.
- Use cleanup_reasons and issue_attribute_names to group rows by captured listing quality signal.
Watch out
- The tool reads weekly listing quality snapshots; it does not perform live Seller Central validation. Use update_listing in preview mode before submitting changes.
create_listingWriteSubmit a new listing request to Amazon using the Listings Items API. Provide a SKU, product type, and listing attributes (title, brand, description, etc.). Returns submission status and any validation issues.
When to use
Submit a new product listing to Amazon, including all required attributes like title, brand, and product identifiers.
Parameters
| Name | Type | Description |
|---|---|---|
sku* | string | Seller SKU for the listing (1-40 characters). |
product_type* | string | Amazon product type (e.g. SHIRT, LUGGAGE, HEALTH_PERSONAL_CARE). |
attributes* | object | Listing attributes object (max 50KB). Common keys: item_name, brand, bullet_point, product_description, externally_assigned_product_identifier (UPC/EAN), list_price, main_product_image_locator.Values follow Amazon attribute format. Check Amazon product type definitions for required attributes. |
* required
Tips
- Use get_listing_restrictions first to verify you are allowed to list in this category.
- Check the response for validation issues, which indicate missing or malformed attributes.
- For variation children, include the parent ASIN in the attributes object.
- The submission may be accepted with status ACCEPTED but still require review before going live.
Watch out
- Requires a Seller ID in the tenant configuration. Returns an error if not connected.
update_listingWriteUpdate Amazon listing attributes by SKU through the Listings Items API. Runs in preview mode by default and requires confirm=true plus an idempotency key to submit.
When to use
Change listing content attributes such as title, bullets, description, keywords, or images after reviewing the current Amazon listing state.
Parameters
| Name | Type | Description |
|---|---|---|
sku* | string | Seller SKU for the listing to update. |
product_type | string | Optional Amazon product type override. Usually read from the current listing. |
patches* | array | Attribute patches to submit. Each item includes attribute, op (add, replace, delete, or merge), and value unless op=delete. Max 20 attributes per call. |
confirm | boolean (false) | Preview by default. Set true to submit the listing patch to Amazon. |
idempotency_key | string | Required when confirm=true. Reusing the same key blocks duplicate listing updates. |
* required
Tips
- Call it once without confirm to review current attribute values and the exact patch set.
- Use Amazon Listings Items API attribute format for values, such as item_name: [{ value: "New title", marketplace_id: "ATVPDKIKX0DER" }].
- Use a stable idempotency_key for the business action, such as listing-SKU-attribute-YYYYMMDD.
- Use update_price and update_inventory_quantity for price and fulfillment availability fields.
Watch out
- Requires Seller Central credentials and a Seller ID. Confirmed submissions are logged to the audit table with pre-submit current values and submitted values.
update_priceWriteSubmit Amazon listing price updates by SKU through the Feeds API. Runs in preview mode by default and requires confirm=true plus an idempotency key to submit.
When to use
Change one or more listing prices after reviewing the current listing state and confirming the exact feed submission.
Parameters
| Name | Type | Description |
|---|---|---|
updates* | array | Price updates to submit. Each item includes sku and price, with optional minimum_seller_allowed_price and maximum_seller_allowed_price guardrails. Max 100 SKUs per call. |
confirm | boolean (false) | Preview by default. Set true to submit the feed to Amazon. |
idempotency_key | string | Required when confirm=true. Reusing the same key blocks duplicate feed submissions. |
* required
Tips
- Call it once without confirm to preview the exact SKUs and target prices.
- Use a stable idempotency_key for the business action, such as price-SKU-YYYYMMDD.
- Set minimum and maximum seller allowed prices when you want Amazon-side bounds around the new price.
- The tool submits a feed; Amazon processes item-level results asynchronously.
Watch out
- Requires Seller Central credentials and a Seller ID. Confirmed feed submissions are capped at $10,000 per item price and are logged to the audit table as submitted values.
update_inventory_quantityWriteUpdate seller-fulfilled listing inventory quantities by SKU through the Listings Items API. Runs in preview mode by default and requires confirm=true plus an idempotency key to submit.
When to use
Change available listing quantities after reviewing current fulfillment availability, especially to mark seller-fulfilled SKUs in stock or out of stock.
Parameters
| Name | Type | Description |
|---|---|---|
updates* | array | Quantity updates to submit. Each item includes sku and quantity, plus optional fulfillment_channel_code, lead_time_to_ship_max_days, and product_type. Max 25 SKUs per call. |
confirm | boolean (false) | Preview by default. Set true to submit listing patches to Amazon. |
idempotency_key | string | Required when confirm=true. Reusing the same key blocks duplicate quantity updates. |
* required
Tips
- Call it once without confirm to preview current quantity, ASIN, product type, and the target quantity.
- Use quantity=0 to mark a seller-fulfilled SKU out of stock.
- Use a stable idempotency_key for the business action, such as inv-SKU-YYYYMMDD.
- The default fulfillment_channel_code is DEFAULT, the seller-fulfilled offer channel.
Watch out
- Requires Seller Central credentials and a Seller ID. FBA stock is controlled by Amazon inventory and inbound workflows; use this for listing fulfillment availability, not to directly mutate FBA warehouse stock.