peddler

Peddler

Peddler is a Ruby interface to the Amazon Selling Partner API (SP-API). The SP-API enables Amazon sellers and vendors to programmatically access their data on orders, shipments, payments, and more.

Peddler is automatically generated from the latest Open API models provided by Amazon. A nightly job tracks Amazon's spec changes, so new endpoints and fields land shortly after Amazon publishes them. Model changes are not considered breaking and don't trigger a major version bump.

Peddler covers all SP-API endpoints, reports, notifications, and feeds. It's also lightweight: thanks to Zeitwerk, only the code you use gets loaded.

Installation

Add to your Gemfile.

Agent skill

If you use an agent, install the SP-API skill:

npx skills add lineofflight/peddler

Usage

Authorization

Before using Peddler, you must register as a developer, register your application, and obtain your Login with Amazon (LWA) credentials; Amazon's official SP-API code samples can help you get started.

Set your LWA credentials in your environment.