rocketkind
E-commerce

Amazon Selling Partner API

Amazon's Selling Partner API (SP-API) is how a seller's own software reads their Amazon business — orders, the catalog, their listings, FBA inventory, competitive pricing, reports and settlement payouts.

Authentication

  • Login with Amazon (self-authorized refresh token)

Actions

Generic API request. Call any Selling Partner API endpoint on this connection, for the case where no shipped action covers it yet. The connection supplies the base URL, the authentication and the egress route, so only the path, query and body are yours to fill.

  • Create reportRequest an Amazon report — orders, inventory, settlement, returns, advertising and many more — for one or more marketplaces and an optional date range.
  • Get catalog itemRead one Amazon catalog item by ASIN in one marketplace — its title, brand, images, identifiers, sales ranks or full attributes, depending on includedData.
  • Get competitive pricingRead Amazon's competitive prices, offer counts and sales ranks for up to 20 items in one marketplace, addressed by ASIN or by the seller's own SKU.
  • Get FBA inventory summariesRead Fulfillment by Amazon (FBA) inventory for one marketplace — fulfillable, inbound, reserved and unfulfillable quantities per SKU.
  • Get item offersRead the lowest-priced offers and Buy Box prices for one ASIN in one marketplace, across every seller — the competitive view a repricing step needs.
  • Get listings itemRead one of the connected seller's listings by SKU — its status, ASIN, offers, fulfillment availability, listing issues or full attributes, depending on includedData.
  • Get marketplace participationsList the Amazon marketplaces this seller sells in, with each marketplace's id, name, country, currency and whether the seller is participating and has suspended listings.
  • Get orderRead one Amazon order by its order id, with its line items embedded under body.order.orderItems — the read step before fulfilling, reconciling or messaging about an order.
  • Get reportRead one report request's status — use it to poll a report started with amazonspapi:createreport until body.processingStatus is DONE, then hand body.reportDocumentId to amazonspapi:getreportdocument.
  • Get report documentGet the download location of a finished report: returns body.url, a presigned URL that expires five minutes after issue, and body.compressionAlgorithm (GZIP when the file is compressed).
  • List financial event groupsList the seller's financial event groups — the settlement periods Amazon groups charges, fees and refunds into, one per disbursement — with each group's processing and fund-transfer status and totals.
  • List reportsList report requests the seller made (or Amazon scheduled) in the last 90 days, filtered by report type, processing status and marketplace — use it to find a finished report, such as the latest settlement report, without having kept its id.
  • Search catalog itemsSearch Amazon's product catalog in one marketplace, either by keywords or by product identifiers (ASIN, EAN, GTIN, ISBN, JAN, MINSAN, UPC) — use it to find the ASIN for a product before pricing or listing it.
  • Search listings itemsSearch the connected seller's own listings (their SKUs) in one marketplace, filtered by identifiers, creation or update time, listing issues or buyable/discoverable status.
  • Search ordersSearch the seller's Amazon orders created or updated in a time window, optionally narrowed by fulfillment status, marketplace and who fulfills them.

Product names, logos and brands are the property of their respective owners and are used here for identification only. Their use does not imply endorsement by, or affiliation with, those owners.