1. Home
  2. Knowledge Base
  3. Documentations
  4. Plugins
  5. Amazon Bestseller for WordPress – Documentation

Amazon Bestseller for WordPress uses the Amazon Product API and displays a bestseller list on your WordPress posts and pages. You can easily use the plugin on several pages including different categories and lengths.

Plugin requirements

Before installing the plugin, please check that the following conditions are met on your server.

  • PHP 5.3 or greater
  • MySQL 5.0.3 or greater
  • WordPress 3.4 or greater (tested up to 4.1.1)
  • PHP curl, SOAP and REST enabled

In general the above-mentioned requirements are easily met by all web hosting providers. For a fast Wordpress WebHosting we recommend Bluehost.

If you are already running a working WordPress installation you can easily install the plugin (as described in the next chapter). Normally the plugin will work as expected.


Install via uploader

  • Login to your website and go to the admin dashboard.
  • Select Plugins -> Add New from the side menu.
  • Click the Upload link.
  • Upload the amazon-bestseller-for-wordpress.zip file included in the downloaded package.
  • Click the Activate Plugin link.

Install via FTP

  • Extract the amazon-bestseller-for-wordpress.zip file locally
  • Connect to your server and upload the folder into your /wp-content/plugins/ directory.
  • Login to your website and go to the admin dashboard.
  • Select Plugins from the side menu.
  • Click the Activate Plugin link.

You have now successfully installed the plugin.

Within the next chapter you get prepared in order to use it in a productive environment.

Setting up the plugin

Due to the fact that this plugin uses the Amazon Product API you need an Amazon account to use this plugin.

Step 1 – Amazon API User Credentials

Sign up for Amazon Product API

If you don’t have signed up for the Amazon Product API until now, let’s do it together.

Locale Product Advertising API URL
Brazil http://associados.amazon.com.br/gp/associates/apply/main.html
Canada https://associates.amazon.ca/gp/flex/advertising/api/sign-in.html
China https://associates.amazon.cn/gp/advertising/api/detail/main.html
France https://partenaires.amazon.fr/gp/flex/advertising/api/sign-in.html
Germany https://partnernet.amazon.de/gp/flex/advertising/api/sign-in.html
India http://affiliate-program.amazon.in/gp/associates/apply/main.html
Italy https://programma-affiliazione.amazon.it/gp/advertising/api/detail/main.html
Japan https://affiliate-program.amazon.com/gp/flex/advertising/api/sign-in-jp.html
Mexico https://afiliados.amazon.com.mx/gp/advertising/api/detail/main.html
Spain https://afiliados.amazon.es/gp/flex/advertising/api/sign-in.html
United Kingdom https://affiliate-program.amazon.co.uk/gp/flex/advertising/api/sign-in.html
United States https://affiliate-program.amazon.com/gp/flex/advertising/api/sign-in.html

On this page click on “Sign up” on the right and fill in registration. It’s possible to use your existing Amazon account if you don’t mind.

Create your Access Key

After you successfully signed up respectively logged you the Amazon Product API you need to get your API keys.

Therefore go to the Amazon Web Services page: https://console.aws.amazon.com/iam/home?#security_credential (same for all countries)

Amazon Web Services API Access Key Creation 1

Click on Create New Access Key (2) and generate a new key pair.

Developer information: Until now it’s not possible to use the AWS Users functionality to communicate with the Amazon Product API.

Amazon Web Services API Access Key Creation 2

After creating your access key please download the key file in order to use it later again.

It’s not possible to view the keys again. Instead you might create a new pair of you lose your old keys.

That’s all we needed in order to use the Amazon Product API. Let’s go back to your WordPress dashboard and setup this amazing plugin.

Step 2 – Plugin configuration page

After you received your Amazon API user credentials we are able to finish the plugin configuration.

Visit the configuration page and fill our the required fields.

Amazon Bestseller WordPress Plugin - Settings

Amazon API Key

The “Access Key ID” you created in step 1.

Amazon API Secret

The “Secret Access Key” you created in step 1.

Amazon Website

Please choose the country you want to use for your API requests. According to your selection the api returns the translated titles, descriptions, prices etc.

Tracking ID

Please enter the tracking id you want to use for your affiliate links. The links on the frontend will be printed out including your tracking id in order to receive commissions for sales.

Disclaimer / Amazon Terms of Service (TOS)

Amazon advised to include a disclaimer adjacent to the pricing or availability information. Sources: German / English

Therefore you can use the disclaimer textfield on your settings page for example by posting a general note and specifying the time interval of fetching the Amazon API data. If you don’t want to show this notification on every page Amazon suggests to place a short note and link to a separat page containing additional / detailed information about the actuality and availability of product and pricing data.

This plugin supports the compliance with regulations and places the content of the disclaimer textbox under every single product box or bestseller list.

At the end you are responsible for complying with regulations relating to Amazon Terms of Service, not the plugin author.

Cache duration

Due to the fact that api requests take some time there’s a built-in caching functionality. In fact you are able to enter the time which will be used to prevent the plugin from requesting the product informations (titles, descriptions, price etc.).

We suggest using a caching time of at least 12 hours. At the end of this period of time the plugin will fetch fresh informations from the Amazon API.

Anyway this options increased your page speed due to the fact that the results will be saved temporarily and not be fetched so often.

Clear Cache

If you need to clear the cache manually in order to get the current product data simply hit the button.

Save changes and verify your connection

After hitting the “Save Changes” button the plugin will test your entered user credentials:

  • Connected: Everything works perfectly and you can go on with the next section
  • Not connected: Please check your user credentials

How-To & Shortcodes

After you configured the plugin and you are connected to the api you will be able to use the following shortcodes:

Using keywords

[amazon bestseller="mainboard"]

Using Browse Nodes (How-To find)

[amazon bestseller="2077179031"]

Updating the amount of products

[amazon bestseller="2077179031" items="3"]

Note: By the default 10 products will be displayed.

If you want to see the plugin and consequently the shortcodes in action feel free to visit the demo page.

Was this article helpful?

Related Articles