Amazon Selling Partner API

Managing Amazon Merchant Operations

Introduction

The Amazon Selling Partner API (SP-API) is the next generation suite of API-based automation functionality for Amazon's Selling Partners and is an evolution of Amazon Marketplace Web Service (Amazon MWS) APIs, which have been offering sellers programmatic access to critical Amazon features for more than 10 years.

Learn More: https://developer.amazonservices.com/

Available Actions

More than 120 actions are available across various API endpoints that are clustered by the following topics:

  • Aplus

  • Product Catalog

  • FBA (Fulfilled by Amazon): Inbound, Inventory, Outbound, Small and Light

  • Feeds

  • Finances

  • Messaging

  • MFN Shipment

  • Notifications

  • Orders

  • Product Fees

  • Product Pricing

  • Reports

  • Sales

  • Sellers

  • Service Jobs

  • Shipping

Prerequisites

An Amazon Seller Central account is required, along with the relevant credentials found within (e.g. merchant token, application ID).

Unique Technical Challenges the Service Addresses

API Quota Management: the Token Bucket Algorithm

Amazon, Shopify and other merchant API providers use the “token bucket”-algorithm to protect their web services from being overwhelmed. Exceeding the quota defined for each API leads to requests being throttled, increasing costs and putting operations at risk. Managing these dynamically changing quotas across 1000s of merchant accounts requires sophisticated orchestration.

The Xapix Token Bucket Management Unit maintains a constantly updated state of available tokens across APIs within a pipeline, ensuring requests that would be wasted due to throttling are either blocked or queued for later, when quota becomes available again.

Why is this a crucial challenge to overcome? Reduced throttling leads to fewer access blocks for requests and hence more reliable analytics and API transactions, with costs saved by reducing the number of wasted requests. Repeated throttling can also lead to longer-term issues with your Amazon Seller Account.

Authentication: oAuth2, AWS v4 Signatures, Parameterization

Every API request has to be parameterized with a set of API Credentials specific to the given store and certain identifiers to target the appropriate marketplace instance (e.g. developer ID, seller ID). This needs to be setup, monitored, and dynamically managed across potentially 1000s of stores at scale.

Xapix manages the complex oauth2 and AWS v4 Signature authentication processes for you, can provide custom API endpoints for retrieving, resetting, adjusting of parameters and can connect to preferred databases for credential storage (or credential management tools).

This low-touch management of individual stores is a basis for further automation and optimization.