Developer Console

Deep Linking from within Your App

One way that you can promote your app is to provide an external link to content outside of your app. This type of link is called a “deep link.” For example, you may deep link to the Amazon Appstore or Amazon retail website from within your app. Note that you may only link users directly to streaming video content within another app if the two apps are associated with one another.

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: Jul 31, 2024