PA API 5 Migration customer FAQ
PA API 5.0 (PA API 5) is the latest version of the Product Advertising API. It has been upgraded from prior legacy version which we will refer to as PA API 4, to give access to the latest retail product information. PA API 5 is available in United States (US), Canada (CA), Mexico (MX), Brazil (BR), United Kingdom (UK), Germany (DE), Spain (ES), France (FR), India (IN), Italy (IT), United Arab Emirates (AE), Turkey (TR), Japan (JP), Singapore (SG) and Australia (AU) marketplaces. All new marketplaces will only be supported in PA API 5. See Locale Reference for more details.
PA API 5 gives you access to the latest features that can give you not only the most important features available in PA API 4 but also new features that are added to Amazon’s products. These new capabilities will help you deliver improved shopping experiences to your customers. PA API 5 has new support for developers to easily integrate with the API and reduce time to develop your applications and sites. All future product enhancements will made available only through PA API 5. For detailed list of new features, please see the questions below and documentation. PA API 4 is built on technology that is being deprecated. We will be shutting down PA API 4 on March 9, 2020. All your applications and sites using PA API 4 will not work as expected after that. Hence, it is important to upgrade to latest version of PA API.
PA API 5 is an API to help you as an Associate to advertise products and earn commission as a result. It gives you the following benefits:
Increase your ability to monetize your site and social media posts by selling products available on Amazon through your site, using global scale Amazon Product Advertising API (PA API 5) and web service.
Yes, if you are already using PA API 4, you will have to update your site or application using PA API 5 to replace all PA API 4 API calls with equivalent PA API 5 APIs. For your benefit, we have provided a simple table mapping the PA API 4 API calls to PA API 5 API calls in the migration guide.
The effort and time required to upgrade to PA API 5 will depend on the complexity of your site or application. We cannot accurately provide this information. We have found that it takes 3 or 4 weeks to make changes to a typical application to upgrade from PA API 4 to PA API 5. The time for testing and deployment depends on your individual installations. During the upgrade period from now until March 9, 2020 you can access both PA API 4 and PA API 5. To make it easier, we have provided documentation with troubleshooting. You can also contact us on the email provided in the FAQ.
If you have generated credentials after September 30th 2017, there is no action required from you. If you have generated credentials before September 29th 2017, please visit Associates Central’s PA API page and click the “migrate now” button which will refresh your credentials with ones that are compatible with PA API 5. Make sure you login with your primary owner account. See Migrating your account for more information. Please ensure you update all your existing credential stores and configuration files immediately, to continue successfully using PA API.
The easiest way to test PA API is to use look at the PA API page on the Associates Central. Make sure you login with your primary owner account.
Please use PA API 5 Scratchpad to check if your credentials are compatible with PA API 5. Use “Start Tour” option to get tour of the Scratchpad, if you have any questions refer Scratchpad usage guide section.
If you are getting “AccessDeniedException” with “AccessDeniedAwsUsers” code, please visit PA API tab on Associates Central website and migrate your credential.
If you are not getting above exception play around with the Scratchpad to see functionality provided in PA API 5.
During your application development if you ever want to debug your application, you can use Scratchpad to confirm API’s responses. More details in the question relating to ‘additional help’.
Yes, you can use the new credentials to access PA API 4. You may do so until PA API 4 access is shutdown on March 11, 2020. You can also continue to use the old credentials with PA API 4 until it is available. But rather than managing two sets of credentials – old and new, you can use the new credentials with all PA API versions.
Once you have upgraded to PA API 5, you can continue to use both PA API 5 and PA API 4. This will allow you to use both systems in parallel for testing while you are upgrading preventing any downtime. On March 9, 2020, we will be shutting down PA API 4 after which you will not be able to use it. You can continue to use PA API 5 with the latest credentials.
Yes, once you have upgraded to PA API 5, the same Efficiency guidelines and limits apply.
If you signed up to be part of Amazon Associate program and your account is approved, you will can request for access to PA API. Once you get the credentials from Associates Central you can use it to call PA API 5. For more information see Register for PA API.
Your old credentials will work with PA API 4 till it is shutdown.
You can use new credentials to access PA API 4, till it is shutdown.
You will continue to use existing AWS signature V2 mechanism while signing request for PA API 4, even with old or new credentials. While signing request for PA API 5 you will need to sign using AWS Signature V4 mechanism. You can use PA API 5 SDK to make requests to PA API 5 which takes care of signing request on your behalf.
With PA API 5 you can access all the marketplace except JP using the same set of credentials, if you have the approved stores in the marketplace with same primary owner (email id). For JP you need a separate set of credentials which you can generate on the JP Associates Central page, which you can use only in JP marketplace. If you have registered as Associate in multiple marketplaces but with different email id, then you need generate credential for each of the email ids.
If you are using ItemLookup, ItemSearch, SimilarityLookup, CartCreate, CartAdd, CartGet, CartModify, CartClear then you are using PA API 4, else PA API 5. If you are getting response in XML then you are using PA API 4, if JSON then PA API 5. If you are using any of software/plug-in by external/third-party provider, please check with them for the details.
We are working on this and will upload them soon.
Power Search is deprecated, it'll not be supported in PA API 5.
With PA API 5 you can specify multiple item ids (upto 10) for GetItems API and multiple BrowseNode Ids (upto 10) for GetBrowseNodes API.
Visit Associate Central website. Login with email id of primary owner of the store. From navigation bar select 'Tools > Product Advertising API'. In 'Manage your credential' section choose to migrate your credentials. Once credentials are generated, start using them with Amazon Product Advertising API 5.0 Scratchpad.
PA API 5 is only accessible by the primary owner of the store which is approved. If you are seeing disabled Join/Migrate button or disabled create or add credentials button, make sure your store is in approved status and you are logging into Associates Central with the primary owner of the store.
Yes, you have to migrate on Associate Central.
Sign into Associate Central website, if you can access payment method update and tax interview pages for selected store then you are primary owner of the store.
You can contact Customer Support using Associate Central website.
Yes attribution works with both of them. Currently Link Type Report doesn't show PA API 5 data, we will add them soon.
Cart API support is removed with PA API 5. You can use Add to Cart form.
Please refer Search with external identifiers (UPC/EAN/ISBN) section for more details.
If you have any questions/feedback, you can get help in any of the following ways:
The documentation has many examples of using PA API 5.
For error codes and messages, see Error Handling.
To create example requests and code samples, see Using the Amazon Product Advertising API 5.0 Scratchpad.
If this does not answer your question, you can contact support using any of the means listed on the Associate central main page - https://affiliate-program.amazon.co.uk/