Product Advertising API
Developer Guide (API Version 2013-08-01)

Troubleshooting Applications

Troubleshoot and resolve problems with your Product Advertising API–enabled websites or applications.

  • Register for Amazon Associates before registering for the Product Advertising API.

    After you have your Associate ID (tag), use the primary or secondary email address in your Associates account to register for the Product Advertising API. All requests must include a valid Associate ID.

  • Troubleshoot your requests with the Product Advertising API Scratchpad.

    Use the Scratchpad to compare your requests and responses and generate sample code.

  • Verify that Product Advertising API is running correctly.

    Open a browser window and submit a REST request. This will confirm that the service is available and responding to requests. Normally, Product Advertising API is available 24 hours a day, 7 days a week.

  • Check that you are specifying inclusive response groups.

    You may not receive the expected information in your Product Advertising API response if you have specified a response group(s) that does not return the data you want.

  • Check the structure of your request.

    Each Product Advertising API operation has a reference page. Verify that your request uses the parameters correctly. If SOAP is not working, try your request with REST through your browser. That will help you determine if the problem lies with your code, your SOAP client, or the Product Advertising API.

  • Try your request with multiple ASINs or keyword/title search strings.

    The Amazon catalog is large and sometimes individual products have irregular data results.

  • Check how quickly your application is submitting requests.

    If your application is submitting requests faster than once per second per IP address, you may receive error messages from the Product Advertising API until you decrease the rate of your requests.

Efficiency Guidelines

Effective 23-Jan-2019, the request limit for each account is calculated based on revenue performance attributed to calls to the Product Advertising API (PA API) during the last 30 days.

Each account used for Product Advertising API is allowed an initial usage limit of 8640 requests per day (TPD) subject to a maximum of 1 request per second (TPS). Your account will receive an additional 1 TPD for every 5 cents or 1 TPS (up to a maximum of 10) for every $4320 of shipped item revenue generated via the use of Product Advertising API for shipments in the last 30 days.

Note that your account will lose access to Product Advertising API if it has not generated referring sales using PA API in the last 30 days.

You can verify that your sales are being attributed to your calls to PA API by checking for the following:

  • You are using the links provided by Product Advertising API when linking back to Amazon.

  • Your Associate account and Product Advertising API account were created using the same Amazon account (i.e. email address).

  • You are using your primary account to make requests to Product Advertising API.

  • You are passing your Associate tag in all your requests to Product Advertising API.

You can check to see sales that have been attributed to Product Advertising API through generating a Link Type Performance report through the Associates Central reports tool.

If you are trying to submit requests that exceed the maximum request for your account (TPD limit), or if your access has been revoked you will receive a 503 error message from Product Advertising API.

If you lose access to Product Advertising API, please see our other product linking tools, such as Site Stripe. You will regain access to Product Advertising API once your account again begins to drive referring sales.

On this page: