You can use the Google Play Store's Install Referrer API to securely retrieve referral content from Google Play, such as:

- The referrer URL of the installed package.
- The timestamp, in seconds, of when a referrer click happened (both client- and server-side).
- The timestamp, in seconds, of when an installation began (both client- and server-side).
- The app's version at the time when the app was first installed.
- Whether the user has interacted with your app's[instant experience](https://developer.android.com/topic/google-play-instant/overview)in the past 7 days.

## Requirements

The Install Referrer API is exposed by the Google Play Store app on a device. Devices with a Google Play app version of 8.3.73 or later automatically have access to the API.

You must also have a Google Play Console account to use the Install Referrer API.

## Using the API

The Install Referrer API is implemented as an[Android Interface Definition Language (AIDL)](https://developer.android.com/guide/components/aidl)interface.

- If you are using the Kotlin programming language or the Java programming language, use the[Play Install Referrer Client Library](https://developer.android.com/google/play/installreferrer/library)to simplify your coding.
- If you are using another programming language, use the[Play Install Referrer API](https://developer.android.com/google/play/installreferrer/igetinstallreferrerservice).