Metadata Changes (Timeline)

GET 10 Credits / Request / 30 days /android/applications/{APPLICATION_ID}/metadata/changes.json

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.

Metadata Changes Request

This method return a list of changes, containing the fields, date of the change and values.

Header parameters
X-AppTweak-Key:
Your AppTweak API Key.
Path parameters
APPLICATION_ID:
Application ID for which you want to get the metadata.
Query parameters
country: string us

The two letter country code (ISO Alpha-2) you want to fetch the app in.

Get the list of our country codes, here.

language: string en

The two letter language (ISO Alpha-2) you want to fetch the application in.

Get the list of our language codes, here.

start_date: string

The first date for which to get data in YYYY-MM-DD format

end_date: string

The last date for which to get data in YYYY-MM-DD format

GET /android/applications/{APPLICATION_ID}/metadata/changes.json

Request example
GET /android/applications/com.keylesspalace.tusky/metadata/changes.json?country=us&language=us&start_date=2019-02-12&end_date=2019-04-11
cURL example
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" https://api.apptweak.com/android/applications/com.keylesspalace.tusky/metadata/changes.json?country=us&language=us&start_date=2019-02-12&end_date=2019-04-11

Metadata Changes Response

The response to the metadata changes request is a JSON hash containing all changes detected by AppTweak during the interval requested.

Object properties
changes: array

An array containing all hashes with changes detected for the time period.

CHILD PROPERTIES

metadata: string

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, price, icon, genres and size.

old_value: Varying

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.

new_value: Varying

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.

change_date: String

The date this change was detected, in YYYY-MM-DD format

version: string

The version of the app when this change was detected, if available.

Response Example

{
  "content": {
    "country": "us",
    "language": "us",
    "device": null,
    "start_date": "2019-02-12",
    "end_date": "2019-04-11",
    "changes": [
      {
        "metadata": "version",
        "new_value": "5.1",
        "old_value": "5.0",
        "change_date": "2019-02-22",
        "version": "5.1"
      },
      {
        "metadata": "version",
        "new_value": "5.2",
        "old_value": "5.1",
        "change_date": "2019-03-04",
        "version": "5.2"
      },
      {
        "metadata": "version",
        "new_value": "6.0",
        "old_value": "5.2",
        "change_date": "2019-03-30",
        "version": "6.0"
      },
      {
        "metadata": "version",
        "new_value": "6.1",
        "old_value": "6.0",
        "change_date": "2019-04-08",
        "version": "6.1"
      },
      {
        "metadata": "screenshots",
        "new_value": [
          {
            "id": "oGEyCHxFrcQ7PPoDQkRjBJ2hQfHbvYf1dOh1Y0Scr2jz-wwB6Ht2Sl_-to0pw4jVUxY",
            "path_component": "lh3.googleusercontent.com",
            "url": "https://lh3.googleusercontent.com/oGEyCHxFrcQ7PPoDQkRjBJ2hQfHbvYf1dOh1Y0Scr2jz-wwB6Ht2Sl_-to0pw4jVUxY"
          },
          {
            "id": "rwAECaVTx-P61e7eql8YyV-YrttGn9Of1LvvElNOXaz9T2Bmo14EQpSrG5EKD0It51k",
            "path_component": "lh3.googleusercontent.com",
            "url": "https://lh3.googleusercontent.com/rwAECaVTx-P61e7eql8YyV-YrttGn9Of1LvvElNOXaz9T2Bmo14EQpSrG5EKD0It51k"
          }
        ],
        "old_value": [
          {
            "id": "15cbU9GT2VuxCuSk4Y1U8Vx3mVy_JHXRZZVqEp2MLdbBpj4sjqT0IYetibKUd9NvApw",
            "path_component": "lh3.googleusercontent.com",
            "url": "https://lh3.googleusercontent.com/15cbU9GT2VuxCuSk4Y1U8Vx3mVy_JHXRZZVqEp2MLdbBpj4sjqT0IYetibKUd9NvApw"
          },
          {
            "id": "6SIesBJRKemJaUb7NCXpp_dB46cuiJAnZWw3zrYbAKNHEHdgzpPU4zwmGnRvtR4bgnY",
            "path_component": "lh3.googleusercontent.com",
            "url": "https://lh3.googleusercontent.com/6SIesBJRKemJaUb7NCXpp_dB46cuiJAnZWw3zrYbAKNHEHdgzpPU4zwmGnRvtR4bgnY"
          }
        ],
        "change_date": "2019-02-12",
        "version": ""
      },
      {
        "metadata": "screenshots",
        "new_value": [
          {
            "id": "oGEyCHxFrcQ7PPoDQkRjBJ2hQfHbvYf1dOh1Y0Scr2jz-wwB6Ht2Sl_-to0pw4jVUxY",
            "path_component": "lh3.googleusercontent.com",
            "url": "https://lh3.googleusercontent.com/oGEyCHxFrcQ7PPoDQkRjBJ2hQfHbvYf1dOh1Y0Scr2jz-wwB6Ht2Sl_-to0pw4jVUxY"
          },
          {
            "id": "jdCtgS_Em5Pnr7iRcG0I8Eq6TTx76QEuRdSBni82Bg9EXJD61xNcLSPudcuzY5RX_dcK",
            "path_component": "lh3.googleusercontent.com",
            "url": "https://lh3.googleusercontent.com/jdCtgS_Em5Pnr7iRcG0I8Eq6TTx76QEuRdSBni82Bg9EXJD61xNcLSPudcuzY5RX_dcK"
          }
        ],
        "old_value": [
          {
            "id": "oGEyCHxFrcQ7PPoDQkRjBJ2hQfHbvYf1dOh1Y0Scr2jz-wwB6Ht2Sl_-to0pw4jVUxY",
            "path_component": "lh3.googleusercontent.com",
            "url": "https://lh3.googleusercontent.com/oGEyCHxFrcQ7PPoDQkRjBJ2hQfHbvYf1dOh1Y0Scr2jz-wwB6Ht2Sl_-to0pw4jVUxY"
          },
          {
            "id": "rwAECaVTx-P61e7eql8YyV-YrttGn9Of1LvvElNOXaz9T2Bmo14EQpSrG5EKD0It51k",
            "path_component": "lh3.googleusercontent.com",
            "url": "https://lh3.googleusercontent.com/rwAECaVTx-P61e7eql8YyV-YrttGn9Of1LvvElNOXaz9T2Bmo14EQpSrG5EKD0It51k"
          }
        ],
        "change_date": "2019-02-22",
        "version": ""
      },
      {
        "metadata": "short_description",
        "new_value": "A client for the social network server Mastodon",
        "old_value": "a client for the social network server Mastodon",
        "change_date": "2019-02-12",
        "version": ""
      },
      {
        "metadata": "description",
        "new_value": "Tusky is a lightweight client for Mastodon (https://joinmastodon.org/), a free and open-source social network server. It supports all Mastodon features, like photos, videos, lists, custom emojis and is designed according to material guidelines.<br>You can choose between a dark and a light theme in Tusky. It has notifications and a drafts feature.<br>Tusky is free and open source software licensed under the GPL-3.0. The source code is available at https://github.com/tuskyapp/Tusky",
        "old_value": "Tusky is a client for Mastodon, a free and open-source social network server. Share words, photos, and videos with folks!<br><br>Mastodon is decentralized, meaning anyone can run Mastodon and participate in the social network seamlessly.<br><br>To learn more about Mastodon, visit https://joinmastodon.org/<br><br>Tusky is also itself open-source, it&#39;s source code is available at https://github.com/Vavassor/Tusky .",
        "change_date": "2019-02-12",
        "version": ""
      },
      {
        "metadata": "icon",
        "new_value": {
          "id": "__Y8MfPQkEV1ZqieV1WBhHCXIqjOisHH1pqrExXXRuqY5XvLwEpW7qBYOAKCob8mn6t6",
          "url": "https://lh3.googleusercontent.com/__Y8MfPQkEV1ZqieV1WBhHCXIqjOisHH1pqrExXXRuqY5XvLwEpW7qBYOAKCob8mn6t6"
        },
        "old_value": null,
        "change_date": "2019-03-08",
        "version": ""
      }
    ]
  },
  "metadata": {
    "request": {
      "path": "/applications/com.keylesspalace.tusky/metadata/changes.json",
      "store": "android",
      "params": {
        "country": "us",
        "language": "us",
        "start_date": "2019-02-12T00:00:00+00:00",
        "end_date": "2019-04-11T00:00:00+00:00",
        "id": "com.keylesspalace.tusky",
        "format": "json"
      },
      "performed_at": "2019-07-12 09:24:22 UTC"
    },
    "content": {
    }
  }
}