Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases
Devices
Build
Test
Publish
Connect
Documentation
Skip to main content
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: Both link formats accept parameters to customize the final URL. The following table lists and describes the available parameters for linking to Amazon.
ParameterDescription
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=trueOpen 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_updateShow 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; it’s not required for Fire tablets.
showAll=1Show 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 Appstoreamzn://apps/android?asin=B004FRX0MY
Amazon Retail Webhttp://www.amazon.com/gp/mas/dl/android?asin=B004FRX0MY
p=
Amazon Appstoreamzn://apps/android?p=com.amazon.mp3
Amazon Retail Webhttp://www.amazon.com/gp/mas/dl/android?p=com.amazon.mp3
s=
Amazon Appstoreamzn://apps/android?s=amazon%20mp3
Amazon Retail Webhttp://www.amazon.com/gp/mas/dl/android?s=amazon%20mp3
initiatePurchaseFlow=true
Amazon Appstoreamzn://apps/android?initiatePurchaseFlow=true&asin=B004FRX0MY
Amazon Retail Webhttp://www.amazon.com/gp/mas/dl/android?initiatePurchaseFlow=true&asin=B004FRX0MY
intent=app_update
Amazon Appstoreamzn://apps/android?asin=B004FRX0MY&intent=app_update
Amazon Retail WebNot 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 Appstoreamzn://apps/android?p=com.amazon.mp3
&showAll=1
Amazon Retail Webhttp://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 modified on August 20, 2025