# Amazon SP-API

**Provider:** Amazon
**Category:** ecommerce
**Base URL:** `https://sellingpartnerapi-na.amazon.com`
**Auth:** oauth2 — `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)
**Free Tier:** No
**Pricing:** Free tier available (subscription)
**Docs:** https://developer-docs.amazon.com/sp-api

## Description

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.

## Endpoints

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

## 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
```

## Sample Request

```bash
# 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

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

## Pricing Details

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.).

---

*Source: [API Map](https://apimap.dev/apis/amazon-sp-api/) — CC BY 4.0*