Skip to content

v2.0.0 — Migrate to Amazon Creators API

Choose a tag to compare

@numanrki numanrki released this 11 Mar 14:04
· 19 commits to master since this release

What's New in v2.0.0

Breaking Changes

  • Amazon Creators API replaces PA-API 5.0 — entire authentication and request layer rewritten from AWS Signature v4 to OAuth 2.0 (Bearer tokens)
  • All API request/response keys migrated from PascalCase to lowerCamelCase
  • Settings fields renamed: Access Key → Credential ID, Secret Key → Credential Secret, plus new Version dropdown
  • CustomerReviews resource (star rating, review count) is no longer available
  • DeliveryInfo.IsPrimeEligible (Prime badge) is no longer available

Added

  • OAuth 2.0 token client with automatic Bearer token acquisition and caching (1-hour TTL)
  • Single API host creatorsapi.amazon for all 10 marketplaces — no more per-region endpoint mapping
  • Credential Version selector in Settings (2.1 NA, 2.2 EU, 2.3 FE, 3.1–3.3 LwA variants)
  • x-marketplace header for marketplace routing
  • PA-API deprecation notice in README (April 30, 2026)

Changed

  • Offers.Listings.* resources replaced with offersV2.listings.* — price now nested in price.money.*
  • Product model updated for lowerCamelCase API response paths
  • README changelog now shows only the latest version (full history in CHANGELOG.md)

Upgrade Guide

If upgrading from v1.x: You must generate new Creators API credentials (Credential ID, Credential Secret, and Version) from your Amazon Associates account. Your old PA-API Access Key and Secret Key will no longer work.


15 files changed across API layer, settings, models, shortcodes, and documentation.