PYTHON-AMAZON-SP-API

Amazon Selling-Partner API

A wrapper to access Amazon's Selling Partner API with an easy-to-use interface.

Q & A

If you have questions, please ask them in GitHub discussions

or

---

Freelance Work

The library's author is looking for freelance work. Contact

Donate

❤️ Donate

Installation

pip install python-amazon-sp-api

---

Usage

fromsp_api.apiimportOrdersfromsp_api.apiimportReportsfromsp_api.apiimportFeedsfromsp_api.baseimportSellingApiExceptionfromsp_api.base.reportTypesimportReportTypefromdatetimeimportdatetime, timedelta# orders APItry:
res=Orders().get_orders(CreatedAfter=(datetime.utcnow() -timedelta(days=7)).isoformat())
print(res.payload) # json dataexceptSellingApiExceptionasex:
print(ex)
# report request createReportResponse=Reports().create_report(reportType=ReportType.GET_MERCHANT_LISTINGS_ALL_DATA)
# submit feed# feeds can be submitted like explained in Amazon's docs, or simply by calling submit_feedFeeds().submit_feed(self, <feed_type>, <file_or_bytes_io>, content_type='text/tsv', **kwargs)
# PII DataOrders(restricted_data_token='<token>').get_orders(CreatedAfter=(datetime.utcnow() -timedelta(days=7)).isoformat())
# or use the shortcutorders=Orders().get_orders(
RestrictedResources=['buyerInfo', 'shippingAddress'],
LastUpdatedAfter=(datetime.utcnow() -timedelta(days=1)).isoformat()
)

---

Documentation

Documentation is available here

Consultation

Do you need help implementing? I offer consultation for everything SP-API related.

Playground

_{The playground is a work in progress and currently in alpha. Please report bugs in this repository}

New endpoints

You can create a new endpoint file by running make_endpoint <model_json_url>

make_endpoint https://raw.githubusercontent.com/amzn/selling-partner-api-models/main/models/listings-restrictions-api-model/listingsRestrictions_2021-08-01.json

This creates a ready to use client. Please consider creating a pull request with the new code.

ADVERTISING API

You can use nearly the same client for the Amazon Advertising API. @denisneuf has built Python-Amazon-Advertising-API on top of this client. Check it out here

DISCLAIMER

We are not affiliated with Amazon

LICENSE

---

Base Client

The client is pretty extensible and can be used for any other API. Check it out here:

API Client

---

---