---
id: python-amazon-sp-api
version: "2.1.20"
license: MIT
license_treatment: permissive
maintenance: active
---

# python-amazon-sp-api — Python wrapper for the Amazon Selling-Partner API

License: permissive · Maintenance: active · Downloads: 467.7K/mo

## What it is and what it does

python-amazon-sp-api is a wrapper around Amazon's Selling Partner API that abstracts away the complexity of authentication, request signing, and response parsing. It provides both synchronous and asynchronous clients for interacting with Amazon seller services—orders, reports, feeds, and data queries—through a straightforward Python interface.

The library uses httpx for HTTP transport with connection pooling support, cachetools for caching, confuse for configuration management, and typing-extensions for type hints. It is actively maintained and designed to be extensible for new endpoints. The async client under sp_api.asyncio supports non-blocking calls for high-concurrency scenarios.

Use it for:

- Automate order retrieval and processing for sellers managing inventory across Amazon marketplaces
- Generate and download merchant reports on a scheduled basis without manual seller central interaction
- Submit product feeds and bulk updates to Amazon programmatically
- Query sales and traffic analytics through the Data Kiosk API for business intelligence
- Build async-based integrations that handle multiple API calls concurrently without blocking

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python client library for Amazon's Selling Partner API that provides sync and async interfaces to manage orders, reports, feeds, and marketplace operations.

Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and a permissive MIT license. It is well-suited for any Python project that needs to integrate with Amazon's Selling Partner API. The dual sync/async support makes it adaptable to both simple scripts and high-concurrency applications.

## Install

pip install python-amazon-sp-api
uv add python-amazon-sp-api
poetry add python-amazon-sp-api

## Installing python-amazon-sp-api

Before you install: Low friction install with four lightweight runtime dependencies. The project is actively maintained with a recent release and 671 GitHub stars, indicating established community use. Requires Python 3.10 or later.

License in practice: MIT license permits commercial and private use with minimal restrictions, making it suitable for business automation and integration projects.

Quickstart:

pip install python-amazon-sp-api

from sp_api.api import Orders
from datetime import datetime, timedelta, timezone

orders_client = Orders()
res = orders_client.get_orders(
    CreatedAfter=(datetime.now(timezone.utc) - timedelta(days=7)).isoformat()
)
print(res.payload)

Requires Python 3.10 or later. Amazon Selling Partner API credentials must be configured before making API calls.

Verify before relying:

- How credentials are configured and whether environment variables, config files, or code-based setup is required
- Rate limiting and throttling behavior when calling Amazon's API endpoints
- Whether async operations support all the same endpoints as sync clients

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 467.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

amazon selling partner api client, amazon sp-api python wrapper, amazon orders reports feeds, amazon seller automation, async amazon marketplace api, amazon seller data integration, sp-api sync async client, amazon-integration, async-support, marketplace-api

[View on SkillFed](https://skillfed.io/packages/python-amazon-sp-api) · [View on PyPI](https://pypi.org/project/python-amazon-sp-api/)