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 usage limit for each account is calculated based on revenue performance attributed to calls (also called requests) to the Product Advertising API (PA API) during your account’s latest 30-day trailing period.

Each account used for Product Advertising API is allowed an initial usage limit up to a maximum of 1 request per second and a cumulative daily maximum of 8640 requests per day (TPD) for the first 30-day period after your account has been approved. Following that period, your PA API usage limit will solely be based on your shipped item revenue. Your account will earn a usage limit of 1 TPD for every 5 cents or 1 TPS (up to a maximum of 10 TPS) for every $4320 of shipped item revenue generated via the use of Product Advertising API for shipments in the previous 30-day period.

Note that your account will lose access to Product Advertising API if it has not generated referring sales for a consecutive 30-day period.

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 your account’s usage 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, you can continue to use other product linking tools, such as Site Stripe and generate revenue. You will regain access to Product Advertising API within 2 days after your referred sales are shipped.

On this page: