The applications' metadata are all the elements (title, subtitle, screenshots, etc.) that you can find on an app store page of an application. Each store displays different types of metadata. The metadata are store-specific (iOS vs Google Play) but they can also be device, country, and/or language specific. Make sure to specify the correct ones in the query parameters.
App Metadata are available through two endpoints:
- App Metadata - Current which returns the lates - most recent - metadata available
- App Metadata - History which returns the historical metadata changes
Make sure to have entered the correct app ID. You can refer to our country codes to see the regions that AppTweak is currently covering.
In the table below, you'll find the name of the metadata elements and a short explanation of each, sorted by device. The last column indicates whether those historical data is available.
|Attributes||iPhone/iPad||Android||Description||Historical Metadata available?|
|title||✅||✅||The App name as it appears on the App Store, in the chosen language||✅|
|subtitle||✅||❌||The subtitle explaining the purpose of the app (introduced in iOS 11)||✅|
|promotional_text||✅||❌||The promotional text should reflect the app’s new features, promotions, or highlighted content||✅|
|description||✅||❌||The app description as it appears on the App Store, in the chosen language||✅|
|short_description||❌||✅||The short description explaining the purpose of the app||✅|
|long_description||❌||✅||The app description as it appears on the Google Play Store, in the chosen language||✅|
|id||✅||✅||Store ID of the app|
|genres||✅||✅||Category IDs as defined for Apple or Google Play||✅|
|icon||✅||✅||URL of the icon||✅|
|screenshots||✅||✅||App Store: Key/value pair of the device and the screenshots URLs.|
Google Play: list of screenshot URLs
|videos||✅||✅||App Store: Key/value pair of the device and the video URLs.|
Google Play: list of video URLs
|feature_graphic||❌||✅||The graphic that appears before launching a video||✅|
|size||✅||✅||Size of the app in bytes||✅|
|rating||✅||✅||Average rating for an app||➖|
|developer||✅||✅||Key/value pairs describing the developer||➖|
|price||✅||✅||Price of the application as displayed in the target country||✅|
|versions||✅||✅||A list of version hash. Each version hash specifies the version number, the date on which it was released, and the release notes in the chosen language.||✅|
|release_date||✅||✅||Release date of the first version of the app||➖|
|slug||✅||✅||URL friendly version of the app name||✅|
|similar_apps||❌||✅||A list of app IDs advertised as alternatives for this app in the section on the application page view||➖|
|customers_also_bought||✅||❌||A list of app IDs that Apple advertises as alternatives for this app in the You May Also Like section on the application page view on the App Store||➖|
A/B tests are available for Android apps in the App Metadata - History endpoints. For every change that is observed, it is indicated whether the change is related to an A/B test (True) or not (False).