Developer Console

Link to Amazon from within Your App

One way that you can promote your apps is to provide a link directly to the Amazon Appstore or Amazon retail website from within your app. This type of link is called a "deep link" and can be used for several purposes:

  • Linking to the paid version of your app in the Amazon Appstore.
  • Linking to another one of your apps in the Amazon Appstore.
  • Linking customers to the Amazon Appstore or retail website to write a review.

You have two options for providing a deep link to an Amazon client within your app. Each of these options requires a slightly different format for the link's base URL.

The following table describes the two link options and gives the base URL for each for the US-based Amazon website:

Option Description Base URL
Link to the Amazon Retail Website This type of link uses standard URL format. You can test this type of link from any browser. http://www.amazon.com/gp
/mas/dl/android?
Link directly to an Amazon Appstore app This type of link is the preferred method and will directly open the Amazon Appstore app. Direct links use a special format which a regular browser does not recognize. amzn://apps/android?

Both link formats accept parameters to customize the final URL. The following table lists and describes the available parameters for linking to Amazon.

Parameter Description
asin= All apps in the catalog have a unique identifier known as an ASIN. Use this identifier to link directly to an app by its ASIN. The ASIN for an app can be found on its detail page. You can use this parameter by itself.
p= Link to the detail page for a specific application ID. For more information, see Set the application ID in the Android developer documentation. You can use this parameter by itself.
s= Add a search term. Use URL Encoding for special characters, such as spaces. You can use this parameter by itself.
initiatePurchaseFlow=true Open the purchase dialog of another app (without opening the app's detail page). An advantage of this method is that the user stays within the current app. To use this parameter, you must include the asin or p parameter.
intent=app_update Show the latest information for an app on the app detail page, including any pending app update. Can be used to support force updates. To use this parameter, you must include the asin or p parameter. Use this parameter for Fire TV or non-Amazon Android devices; it's not required for Fire tablets.
showAll=1 Show all apps by the developer associated with the specified application ID or ASIN. To use this parameter, you must include the asin or p parameter.

The following table shows examples for each of the parameters.

asin=
Amazon Appstore amzn://apps/android?asin=B004FRX0MY
Amazon Retail Web http://www.amazon.com/gp/mas/dl/android?asin=B004FRX0MY
p=
Amazon Appstore amzn://apps/android?p=com.amazon.mp3
Amazon Retail Web http://www.amazon.com/gp/mas/dl/android?p=com.amazon.mp3
s=
Amazon Appstore amzn://apps/android?s=amazon%20mp3
Amazon Retail Web http://www.amazon.com/gp/mas/dl/android?s=amazon%20mp3
initiatePurchaseFlow=true
Amazon Appstore amzn://apps/android?initiatePurchaseFlow=true&asin=B004FRX0MY
Amazon Retail Web http://www.amazon.com/gp/mas/dl/android?initiatePurchaseFlow=true&asin=B004FRX0MY
intent=app_update
Amazon Appstore amzn://apps/android?asin=B004FRX0MY&intent=app_update
Amazon Retail Web Not an applicable use case. The parameter is meant to redirect a user from within an app to the Amazon Appstore installed on the device.
showAll=1
Amazon Appstore amzn://apps/android?p=com.amazon.mp3
&showAll=1
Amazon Retail Web http://www.amazon.com/gp/mas/dl/android?p=com.amazon.mp3&showAll=1

International considerations

If you are using a URL for linking, you might need to implement some logic to handle different sites, such as international sites, to reference the proper Amazon domain. For example, for the US, a link such as: http://www.amazon.com/gp/mas/dl/android?p=com.example.myapp.apk will work in the US, but not in France.

In France, the equivalent link might be: http://www.amazon.fr/gp/mas/dl/android?p=com.example.myapp.apk.

To view the full list of countries/regions with their own Appstores, their domains, and where else residents of these countries/regions may shop for apps, see Countries and Territories Eligible to Shop for Apps.


Last updated: Feb 17, 2023