Metadata Changes (Timeline)

GET 10 Credits / Request / 30 days /ios/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 App Store.

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.

device: string iphone

The device you want to fetch the application for.

iphone or ipad

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 /ios/applications/{APPLICATION_ID}/metadata/changes.json

Request example
GET /ios/applications/1229021451/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/ios/applications/1229021451/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, subtitle, promotionalText, description, version, slug, price, devices, icon, genres, features 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": "iphone",
    "start_date": "2019-02-12",
    "end_date": "2019-04-11",
    "changes": [
      {
        "metadata": "icon",
        "new_value": {
          "id": "e6a90007-aad2-3b93-a30c-578ce04bec71",
          "url": "https://is5-ssl.mzstatic.com/image/thumb/Purple124/v4/e6/a9/00/e6a90007-aad2-3b93-a30c-578ce04bec71/IconNormal-0-1x_U007emarketing-0-0-GLES2_U002c0-512MB-sRGB-0-0-0-85-220-0-0-0-7.png/180x180bb.png"
        },
        "old_value": {
          "id": "e8cea5be-5ad1-c8d9-a561-9319a8f40fc1",
          "url": "https://is5-ssl.mzstatic.com/image/thumb/Purple114/v4/e8/ce/a5/e8cea5be-5ad1-c8d9-a561-9319a8f40fc1/IconNormal-0-1x_U007emarketing-0-0-GLES2_U002c0-512MB-sRGB-0-0-0-85-220-0-0-0-7.png/360x216bb.png"
        },
        "change_date": "2019-02-27",
        "version": "1.5"
      },
      {
        "metadata": "icon",
        "new_value": {
          "id": "d05a3223-9278-2a91-efc0-ee413e6e65b9",
          "url": "https://is1-ssl.mzstatic.com/image/thumb/Purple123/v4/d0/5a/32/d05a3223-9278-2a91-efc0-ee413e6e65b9/IconNormal-0-1x_U007emarketing-0-0-GLES2_U002c0-512MB-sRGB-0-0-0-85-220-0-0-0-7.png/1024x1024bb.jpg"
        },
        "old_value": {
          "id": "c54b3aba-9c98-c34c-991d-c5a6998b8153",
          "url": "https://is2-ssl.mzstatic.com/image/thumb/Purple114/v4/c5/4b/3a/c54b3aba-9c98-c34c-991d-c5a6998b8153/IconNormal-0-1x_U007emarketing-0-0-GLES2_U002c0-512MB-sRGB-0-0-0-85-220-0-0-0-7.png/180x180bb.png"
        },
        "change_date": "2019-03-26",
        "version": "1.6.1"
      },
      {
        "metadata": "icon",
        "new_value": {
          "id": "719d60f6-b178-f108-f972-f9964169f771",
          "url": "https://is2-ssl.mzstatic.com/image/thumb/Purple113/v4/71/9d/60/719d60f6-b178-f108-f972-f9964169f771/IconNormal-0-1x_U007emarketing-0-0-GLES2_U002c0-512MB-sRGB-0-0-0-85-220-0-0-0-7.png/1024x1024bb.jpg"
        },
        "old_value": {
          "id": "d05a3223-9278-2a91-efc0-ee413e6e65b9",
          "url": "https://is1-ssl.mzstatic.com/image/thumb/Purple123/v4/d0/5a/32/d05a3223-9278-2a91-efc0-ee413e6e65b9/IconNormal-0-1x_U007emarketing-0-0-GLES2_U002c0-512MB-sRGB-0-0-0-85-220-0-0-0-7.png/1024x1024bb.jpg"
        },
        "change_date": "2019-04-11",
        "version": "1.7"
      },
      {
        "metadata": "size",
        "new_value": 42986496,
        "old_value": 36158464,
        "change_date": "2019-02-27",
        "version": "1.5"
      },
      {
        "metadata": "version",
        "new_value": "1.5",
        "old_value": "1.4.1",
        "change_date": "2019-02-27",
        "version": "1.5"
      },
      {
        "metadata": "version",
        "new_value": "1.5.1",
        "old_value": "1.5",
        "change_date": "2019-03-01",
        "version": "1.5.1"
      },
      {
        "metadata": "version",
        "new_value": "1.6",
        "old_value": "1.5.1",
        "change_date": "2019-03-25",
        "version": "1.6"
      },
      {
        "metadata": "version",
        "new_value": "1.6.1",
        "old_value": "1.6",
        "change_date": "2019-03-26",
        "version": "1.6.1"
      },
      {
        "metadata": "version",
        "new_value": "1.7",
        "old_value": "1.6.1",
        "change_date": "2019-04-11",
        "version": "1.7"
      }
    ]
  },
  "metadata": {
    "request": {
      "path": "/applications/1229021451/metadata/changes.json",
      "store": "ios",
      "params": {
        "country": "us",
        "language": "us",
        "start_date": "2019-02-12T00:00:00+00:00",
        "end_date": "2019-04-11T00:00:00+00:00",
        "device": "iphone",
        "id": "1229021451",
        "format": "json"
      },
      "performed_at": "2019-07-12 09:57:43 UTC"
    },
    "content": {
    }
  }
}