A

Amazon SP-API

by Amazon

The Amazon Selling Partner API (SP-API) is the successor to MWS and provides REST-based access to Amazon marketplace data. Manage product listings and inventory, process and ship orders, retrieve financial reports and settlements, automate pricing, access advertising campaign data, and integrate with Fulfillment by Amazon (FBA). Used by large-scale sellers, third-party sellers, repricing tools, and ERP integrations. Requires Amazon seller account and approved SP-API application.

amazonmarketplacelistingsfbaordersadvertisingrepricingseller

Quick Reference

Base URL https://sellingpartnerapi-na.amazon.com Auth type OAuth 2.0 Auth header Authorization: Bearer ACCESS_TOKEN x-amz-access-token: ACCESS_TOKEN Rate limit Varies by endpoint (e.g., Orders: 0.0167 req/sec, Listings: 5 req/sec) Pricing Free tier available Free quota Sandbox environment is free for development Documentation https://developer-docs.amazon.com/sp-api Endpoint status Server online — HTTP 500 — server is online but path returned an error (may require auth)1.02s (checked Mar 29, 2026) Builder score C 61% builder-friendly
Pricing
60
Latency
30
Depth
86

Authentication

SP-API uses LWA (Login with Amazon) OAuth 2.0. Exchange your client credentials for an access token, then sign each request with AWS SigV4 using your IAM role credentials.

Authorization: Bearer ACCESS_TOKEN
x-amz-access-token: ACCESS_TOKEN

Pricing

Model subscription Starting price Free tier available Free quota Sandbox environment is free for development

Most SP-API endpoints are free for approved sellers. Some advanced analytics APIs have usage-based fees. Amazon charges sellers separately for marketplace fees (referral fees, FBA fees, etc.).

Key Endpoints

MethodPathDescription
GET /orders/v0/orders List orders filtered by status, date, and marketplace
GET /listings/2021-08-01/items/{sellerId}/{sku} Get a listing by seller SKU
GET /fba/inventory/v1/summaries Get FBA inventory levels and conditions
GET /finances/v0/financialEvents List financial events (settlements, charges)
GET /catalog/2022-04-01/items/{asin} Get product details and search keywords for an ASIN
PUT /pricing/v0/price Update listing prices for competitive repricing

Sample Request

# SP-API requires AWS SigV4 signing — shown with simplified headers
curl "https://sellingpartnerapi-na.amazon.com/orders/v0/orders?MarketplaceIds=ATVPDKIKX0DER&OrderStatuses=Unshipped" \
  -H "x-amz-access-token: $SP_API_ACCESS_TOKEN" \
  -H "x-amz-date: 20240315T100000Z"

Sample Response

{
  "payload": {
    "Orders": [{
      "AmazonOrderId": "114-1234567-1234567",
      "OrderStatus": "Unshipped",
      "PurchaseDate": "2024-03-15T08:00:00Z",
      "OrderTotal": { "Amount": "49.99", "CurrencyCode": "USD" },
      "NumberOfItemsShipped": 0,
      "NumberOfItemsUnshipped": 2
    }]
  }
}

Data sourced from API Map. Always verify pricing and rate limits against the official Amazon documentation.