Metadata Changes allows you to fetch all the information that AppTweak has been able to gather about changes that an app had for a date range in the Play Store.
Note that the response example has been stripped of similar information for easier understanding. The API responses might contain more information.
This method return a list of changes, containing the fields, date of the change and values.
The two letter country code (ISO Alpha-2) you want to fetch the app in.
Get the list of our country codes, here.
The two letter language (ISO Alpha-2) you want to fetch the application in.
Get the list of our language codes, here.
The first date for which to get data in YYYY-MM-DD format
The last date for which to get data in YYYY-MM-DD format
GET https://api.apptweak.com/android/applications/com.soundcloud.android/metadata/changes.json?country=us&language=us&start_date=2021-02-12&end_date=2021-03-11
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/android/applications/com.soundcloud.android/metadata/changes.json?country=us&language=us&start_date=2021-02-21&end_date=2021-02-25"The response to the metadata changes request is a JSON hash containing all changes detected by AppTweak during the interval requested.
An array containing all hashes with changes detected for the time period.
The kind of metadata that this changes refer to
This field can have several values, for instance: title, screenshots, videos, short_description, feature_graphic, description, version, price, icon, genres and size.
The value this field had before this change. Can be a string, an integer or an array of hashes, depending on the type of the metadata.
The value this field has after this change. Can be a string, an integer or an array of hashes, depending on the type of the metadata.
The date this change was detected, in YYYY-MM-DD format
The version of the app when this change was detected, if available.
Note: Field not present in permission, size and version changes. The meta object contains a matching_ids object that matches the ids of the screenshots that have been present in both the new and the old values.
Note: Field not present in permission, size and version changes. This field indicates whether an A/B test was running. True if an A/B test was running and false otherwise.
Note: Field not present in permission, size and version changes. This field indicates whether this change was detected as a custom store listing. True if this was detected on a custom store listing and false otherwise.
Note: Field not present in permission, size and version changes. This object contains all the changes that were detected during the A/B test. It contains an object old_value and an object new_value with the corresponding experiment information. The fields in each are: experiment_id (string id of the experiment), experiment_variant_type (a string indicating whether this was the default variant), experiment_variant_number (integer indicating the variant or null if this is the default variant), experiment_attributes (list of strings listing the experiment attributes, i.e. screenshots, etc)
{
"content": {
"country": "us",
"language": "us",
"device": null,
"start_date": "2021-02-21",
"end_date": "2021-02-25",
"changes": [
{
"metadata": "version",
"new_value": "2021.02.19-release",
"old_value": "2021.02.12-release",
"change_date": "2021-02-22",
"version": "2021.02.19-release"
},
{
"metadata": "screenshots",
"new_value": [
{
"id": "qa5_xORtfExluiWmLmYY2_YnlXNGGvVwC_cCNXWUaMTIN-MiaEuusEJLJZ__EHNWgI0",
"path_component": "play-lh.googleusercontent.com",
"url": "https://play-lh.googleusercontent.com/qa5_xORtfExluiWmLmYY2_YnlXNGGvVwC_cCNXWUaMTIN-MiaEuusEJLJZ__EHNWgI0"
},
{
"id": "R6Tz88oQy4PnJuRSC40ATWedtjb8895SXLYylq1qcRd04r5nHucVp9puGmWMmpgo7ok",
"path_component": "play-lh.googleusercontent.com",
"url": "https://play-lh.googleusercontent.com/R6Tz88oQy4PnJuRSC40ATWedtjb8895SXLYylq1qcRd04r5nHucVp9puGmWMmpgo7ok"
},
{
"id": "lBpfmn8EnMS18nZwVVjSLGsblG-hokhh5DMgYrM8Fv55OUOuvZqxi9ypSV8_a_Om7Vo",
"path_component": "play-lh.googleusercontent.com",
"url": "https://play-lh.googleusercontent.com/lBpfmn8EnMS18nZwVVjSLGsblG-hokhh5DMgYrM8Fv55OUOuvZqxi9ypSV8_a_Om7Vo"
},
{
"id": "bctvqoY2Vn2fd26l8rNK8JaAtrsDfpo7DUrrYJruxNdf_slBLXiI09owigM9-cbiUgY",
"path_component": "play-lh.googleusercontent.com",
"url": "https://play-lh.googleusercontent.com/bctvqoY2Vn2fd26l8rNK8JaAtrsDfpo7DUrrYJruxNdf_slBLXiI09owigM9-cbiUgY"
},
{
"id": "ZqHr2KlnqFUH7qs1sC4WrqwJZAMLseELLzO5NKmJH7Ec6d8VD8dtwMBO3xEHPYSvA_c",
"path_component": "play-lh.googleusercontent.com",
"url": "https://play-lh.googleusercontent.com/ZqHr2KlnqFUH7qs1sC4WrqwJZAMLseELLzO5NKmJH7Ec6d8VD8dtwMBO3xEHPYSvA_c"
},
{
"id": "7eXRp1zCZIU7TIhy0E_34vpI72OeCErOVev91Q_k_YpqUUxLKuNrrNYI1Bd4vN-cyN0w",
"path_component": "play-lh.googleusercontent.com",
"url": "https://play-lh.googleusercontent.com/7eXRp1zCZIU7TIhy0E_34vpI72OeCErOVev91Q_k_YpqUUxLKuNrrNYI1Bd4vN-cyN0w"
},
{
"id": "wKne2aOKEV9DbenENLAHH6hKUDnz6JeiW4IsYkdq4UuG-Z_LhTo5MMmQm19X-KOoow",
"path_component": "play-lh.googleusercontent.com",
"url": "https://play-lh.googleusercontent.com/wKne2aOKEV9DbenENLAHH6hKUDnz6JeiW4IsYkdq4UuG-Z_LhTo5MMmQm19X-KOoow"
}
],
"old_value": [
{
"id": "UnkScjSMeT34fhrFqKUTZtEOJ2UNxhvjhRY6Ijc50CPxM7qpo8z0yGSXgjlwq9yF4j0",
"path_component": "play-lh.googleusercontent.com",
"url": "https://play-lh.googleusercontent.com/UnkScjSMeT34fhrFqKUTZtEOJ2UNxhvjhRY6Ijc50CPxM7qpo8z0yGSXgjlwq9yF4j0"
},
{
"id": "dXqxb1UBMgF1Lr2SQZBgESszZ6CiVePBce1ujDDKGZUygjxWC0lDbTe7pHX2Ib-Vu3c",
"path_component": "play-lh.googleusercontent.com",
"url": "https://play-lh.googleusercontent.com/dXqxb1UBMgF1Lr2SQZBgESszZ6CiVePBce1ujDDKGZUygjxWC0lDbTe7pHX2Ib-Vu3c"
},
{
"id": "4E8IF0bR98jD5UIxatSGbV9SMQvxYIbbBNl5MuqTVudXSF7kbfYREa5FEXIafWlPKM4",
"path_component": "play-lh.googleusercontent.com",
"url": "https://play-lh.googleusercontent.com/4E8IF0bR98jD5UIxatSGbV9SMQvxYIbbBNl5MuqTVudXSF7kbfYREa5FEXIafWlPKM4"
},
{
"id": "Vaf7nOTat7ls0fg30XdMdRCriAyGD9RNUDieYb1hHoVlwWnJgvJzCf9ZEn7I9PkseD4",
"path_component": "play-lh.googleusercontent.com",
"url": "https://play-lh.googleusercontent.com/Vaf7nOTat7ls0fg30XdMdRCriAyGD9RNUDieYb1hHoVlwWnJgvJzCf9ZEn7I9PkseD4"
},
{
"id": "A96YWDPdALMLVTSbIskNOkfHRUyKOywumgpH5penulspH_ROtl78ZAIQV8FZSRVkKg",
"path_component": "play-lh.googleusercontent.com",
"url": "https://play-lh.googleusercontent.com/A96YWDPdALMLVTSbIskNOkfHRUyKOywumgpH5penulspH_ROtl78ZAIQV8FZSRVkKg"
},
{
"id": "h43-dKtJPCKWdXmpqKw4qbFf5OaqHsZcvMfOTlldnv9I9kQkX-Wk6hHi8Yl0aoo6sXs",
"path_component": "play-lh.googleusercontent.com",
"url": "https://play-lh.googleusercontent.com/h43-dKtJPCKWdXmpqKw4qbFf5OaqHsZcvMfOTlldnv9I9kQkX-Wk6hHi8Yl0aoo6sXs"
},
{
"id": "gldad6FAJxjUuZAiGdxpCgB3q-EahSMKmlfITKIF80BWcBWMvQ5gnUHuXJrEDAJrjF8",
"path_component": "play-lh.googleusercontent.com",
"url": "https://play-lh.googleusercontent.com/gldad6FAJxjUuZAiGdxpCgB3q-EahSMKmlfITKIF80BWcBWMvQ5gnUHuXJrEDAJrjF8"
}
],
"change_date": "2021-02-22",
"meta": {
"matching_ids": {
}
},
"version": "",
"is_custom_store_listing": false,
"is_ab_test": true,
"ab_test_details": {
"old_value": {
"experiment_id": "5745283685049505565",
"experiment_variant_type": "variant_listing",
"experiment_variant_number": 0,
"experiment_attributes": [
"screenshots"
]
},
"new_value": {
"experiment_id": "5745283685049505565",
"experiment_variant_type": "default_listing",
"experiment_variant_number": null,
"experiment_attributes": [
"screenshots"
]
}
}
},
{
"metadata": "size",
"new_value": 40140732,
"old_value": 40097918,
"change_date": "2021-02-22",
"version": "2021.02.19-release"
}
]
},
"metadata": {
"request": {
"path": "/applications/com.soundcloud.android/metadata/changes.json",
"store": "android",
"params": {
"country": "us",
"language": "us",
"start_date": "2021-02-21T00:00:00+00:00",
"end_date": "2021-02-25T00:00:00+00:00",
"id": "com.soundcloud.android",
"format": "json"
},
"performed_at": "2021-09-01 08:43:10 UTC"
},
"content": {
}
}
}