Skip to Content

Connect Amazon Selling Partner API to Your AI Agent

Compare Amazon catalog items, check proposed listing changes, and review stock across your authorized marketplaces.

9 toolsOAuth

20,000 free app calls every month(paid services billed separately)

Try a Amazon Selling Partner API Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo SkillAmazon Selling Partner API

Compare Catalog Items

Search by keywords or product identifiers and compare attributes, images, and variations in one marketplace.

/oo Amazon Selling Partner API: Search Amazon [marketplace] for [keywords]. Compare the returned products by dimensions, materials, and variations. Keep the ASINs and flag missing product details.

Check a Listing Change Before Saving

Read the current listing and preview a proposed attribute update to identify validation issues.

/oo Amazon Selling Partner API: Read SKU [SKU] in Amazon marketplace [marketplace ID]. Preview these attribute changes using product type [product type] and the supplied values: [changes]. Report validation issues without saving the update.

Review FBA Stock

Inspect available, reserved, and inbound quantities for selected seller SKUs.

/oo Amazon Selling Partner API: Review FBA inventory for SKUs [SKUs] in Amazon marketplace [marketplace ID]. Include detailed quantities, separate available stock from reserved and inbound units, and flag items below [stock threshold].

Start Working with Amazon Selling Partner API

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Amazon Selling Partner API

    Connect your seller account using your own public SP-API application and its Login with Amazon credentials.

    Connect Amazon Selling Partner API→
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →
  • A published or draft public SP-API application and a seller account that can authorize it.
  • The application's SP-API Application ID, LWA Client ID, and LWA Client Secret from https://solutionproviderportal.amazon.com/ .
  • The connector callback URL registered as the application's OAuth Redirect URI, and Amazon app roles approved for the operations you need.
  • Select your Seller Central country; the API region is chosen automatically. Use separate connections for different selling regions.
  • For a draft application, enter beta in Draft application version. Leave it empty for a published application. Private self-authorized applications use a different authorization flow.

Amazon Selling Partner API Tools

Amazon Selling Partner API connects your seller account to catalog, listing, and FBA inventory operations. Ask an assistant to compare products, inspect listing issues, or summarize stock using your marketplace and SKU details.

Find Authorized Marketplaces

List the seller's marketplaces and participation status in the connected region.

Search the Amazon Catalog

Search catalog items and retrieve their requested product datasets.

Review and Maintain Seller Listings

Search listings, inspect issues, preview changes, create or update listings, and delete selected listings.

Inspect FBA Inventory

Read marketplace inventory summaries with SKU, detail, and change-time filters.

9 tools

List Marketplace Participations

List the connected seller's Amazon marketplaces and participation status in the connected region.

amazon_sp_api.list_marketplace_participations

Search Catalog Items

Search the Amazon catalog by product identifiers or keywords. Search pagination exposes at most 1,000 matching ASINs.

amazon_sp_api.search_catalog_items

Get Catalog Item

Retrieve an Amazon catalog item by ASIN with selected datasets for the requested marketplaces.

amazon_sp_api.get_catalog_item

Search Listings Items

Search the seller's listings by identifiers, relationships, dates, status, or issue severity. Pagination exposes at most 1,000 matching SKUs.

amazon_sp_api.search_listings_items

Get Listings Item

Retrieve a seller listing, including selected attributes, offers, live availability, and processing issues.

amazon_sp_api.get_listings_item

Put Listings Item

Create or fully update a seller listing. Omitted existing attributes may be removed; use patch_listings_item for partial edits. VALIDATION_PREVIEW checks the submission without saving it.

amazon_sp_api.put_listings_item

Patch Listings Item

Partially update listing attributes with add, replace, merge, or delete operations. Deleting attribute instances requires selector values. VALIDATION_PREVIEW checks without saving; ACCEPTED submissions may still develop processing issues.

amazon_sp_api.patch_listings_item

Delete Listings Item

Delete the seller's listing for one Amazon marketplace. The returned submission status indicates whether Amazon accepted the deletion for processing.

amazon_sp_api.delete_listings_item

Get Inventory Summaries

Read FBA inventory summaries for one marketplace. For changed inventory, retain startDateTime when paging and reuse nextToken within 30 seconds. Inbound quantity changes are not detected by the incremental filter.

amazon_sp_api.get_inventory_summaries

Frequently Asked Questions

Can I check a listing update without saving it?

Yes. Ask for a validation preview. The create and patch actions support VALIDATION_PREVIEW, which checks the supplied listing data without saving changes.

Does ACCEPTED mean my listing change is live?

ACCEPTED means Amazon accepted the submission for processing. Read the listing's issues and current details afterward to check the outcome. Use a partial update when you want to preserve other attributes; a full update can remove omitted attributes.

Why might an operation be unavailable after connecting?

Access depends on the roles approved for your Amazon application and the seller's marketplace permissions. These app roles are configured with Amazon, rather than selected as OAuth scopes during connection.

Does an incremental inventory query include every stock change?

The change-time filter does not detect changes to inbound working, shipped, or receiving quantities. Query current detailed inventory when those quantities matter.

Can I call other SP-API endpoints?

The generic proxy supports ordinary requests to the connected region's SP-API using the connection's access token. Restricted Data Token exchange, grantless authorization, file transfers, and multi-step jobs need separate handling.