---
updatedAt: 2026-10-05T13:48:33.000Z
agentTools:
  projectIndex: https://developers.apptweak.com/llms.txt
---

# App Metadata - History

Returns metadata changes from an app that AppTweak has been able to gather from the App Store or the Google Play Store. The data is fetched daily. <br/><br/> <b>Price</b><table><thead><tr><th>Data</th><th>Credits</th><th>Per</th></tr></thead><tbody><tr><td>Metadata changes</td><td>5</td><td>app</td></tr></tbody></table> <br/><br/> Any date range up to 1 year costs the same.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "1",
    "title": "App Store API",
    "contact": {
      "name": "AppTweak",
      "email": "support@apptweak.com"
    }
  },
  "servers": [
    {
      "url": "https://public-api.apptweak.com/api/public/store"
    }
  ],
  "security": [
    {
      "api_key": []
    }
  ],
  "tags": [
    {
      "name": "App Metadata",
      "description": "Returns metadata from an app that AppTweak has been able to gather from the App Store or the Google Play Store."
    }
  ],
  "paths": {
    "/apps/metadata/changes.json": {
      "get": {
        "summary": "App Metadata - History",
        "description": "Returns metadata changes from an app that AppTweak has been able to gather from the App Store or the Google Play Store. The data is fetched daily. <br/><br/> <b>Price</b><table><thead><tr><th>Data</th><th>Credits</th><th>Per</th></tr></thead><tbody><tr><td>Metadata changes</td><td>5</td><td>app</td></tr></tbody></table> <br/><br/> Any date range up to 1 year costs the same.",
        "operationId": "app-metadata-history",
        "tags": [
          "App Metadata"
        ],
        "parameters": [
          {
            "name": "apps",
            "in": "query",
            "description": "Comma-separated list of app IDs (max 5). <a href=\"https://developers.apptweak.com/reference/how-to-find-app-ids\" target=\"_blank\"><b>How to find App IDs?</b></a>",
            "required": true,
            "example": "1446075923",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "Two-letter country code (`us`, `gb`, `fr`). Accepted values: <a href=\"https://developers.apptweak.com/reference/countries-1\" target=\"_blank\"><code>GET /api/public/apptweak/countries</code></a> with `store=ios` or `store=android`. Defaults to us.",
            "required": false,
            "schema": {
              "default": "us",
              "type": "string"
            }
          },
          {
            "name": "language",
            "in": "query",
            "description": "AppTweak language code, not always ISO: US English is `us`, US Spanish `sp`. Accepted pairs: <a href=\"https://developers.apptweak.com/reference/languages-1\" target=\"_blank\"><code>GET /api/public/apptweak/languages</code></a> with `store=ios` or `store=android`. Defaults to the country's <a href=\"https://developers.apptweak.com/reference/languages-overview#default-language\" target=\"_blank\"><b>default language</b></a>.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "device",
            "in": "query",
            "description": "Choose a device from iphone, ipad or android. Defaults to iphone.",
            "required": false,
            "schema": {
              "default": "iphone",
              "type": "string",
              "enum": [
                "iphone",
                "ipad",
                "android"
              ]
            }
          },
          {
            "name": "start_date",
            "in": "query",
            "description": "Start date (YYYY-MM-DD). Send both dates or omit both. Maximum range: one full calendar year. Defaults to 30 days ago.",
            "required": false,
            "example": "2026-06-01",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "end_date",
            "in": "query",
            "description": "End date (YYYY-MM-DD). Defaults to yesterday.",
            "required": false,
            "example": "2026-07-01",
            "schema": {
              "type": "string",
              "format": "date"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "object",
                        "title": "App ID",
                        "description": "Keyed by app ID (numeric App Store ID on iOS, package name on Google Play).",
                        "properties": {
                          "changes": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "target": {
                                  "type": "string",
                                  "description": "Metadata element that changed (e.g. title, version, screenshots, description)."
                                },
                                "old_value": {
                                  "description": "Value of the target before the change. Type depends on `target`: string, number, array of objects or object."
                                },
                                "new_value": {
                                  "description": "Value of the target after the change. Same polymorphic typing as `old_value`."
                                },
                                "old_release_notes": {
                                  "type": "string",
                                  "description": "Release notes before the change. Only present when `target` is a version change."
                                },
                                "new_release_notes": {
                                  "type": "string",
                                  "description": "Release notes after the change. Only present when `target` is a version change."
                                },
                                "version": {
                                  "type": "string"
                                },
                                "is_ab_test": {
                                  "type": "boolean",
                                  "nullable": true,
                                  "description": "Whether the change was detected as an A/B test. Null when undetermined."
                                },
                                "date": {
                                  "type": "string"
                                }
                              }
                            }
                          }
                        }
                      }
                    },
                    "metadata": {
                      "$ref": "#/components/schemas/ResponseMetadata"
                    }
                  }
                },
                "examples": {
                  "iOS": {
                    "value": {
                      "result": {
                        "1446075923": {
                          "changes": [
                            {
                              "target": "version",
                              "old_value": "3.0.1",
                              "new_value": "3.0.2",
                              "old_release_notes": "Disney+ now has even more content on our never-ending quest to create and share the best stories from Disney, Pixar, Marvel, Star Wars and National Geographic.",
                              "new_release_notes": "Disney+ now has even more content on our never-ending quest to create and share the best stories from Disney, Pixar, Marvel, Star Wars and National Geographic.",
                              "version": "3.0.2",
                              "is_ab_test": false,
                              "date": "2024-03-06"
                            },
                            {
                              "target": "version",
                              "old_value": "3.0.2",
                              "new_value": "3.1.0",
                              "old_release_notes": "Disney+ now has even more content on our never-ending quest to create and share the best stories from Disney, Pixar, Marvel, Star Wars and National Geographic.",
                              "new_release_notes": "Disney+ now has even more content on our never-ending quest to create and share the best stories from Disney, Pixar, Marvel, Star Wars and National Geographic.",
                              "version": "3.1.0",
                              "is_ab_test": false,
                              "date": "2024-03-21"
                            },
                            {
                              "target": "privacy_info",
                              "old_value": {
                                "DATA_LINKED_TO_YOU": [
                                  "PURCHASES",
                                  "LOCATION",
                                  "CONTACT_INFO",
                                  "SEARCH_HISTORY",
                                  "IDENTIFIERS",
                                  "USAGE_DATA"
                                ],
                                "DATA_NOT_LINKED_TO_YOU": [
                                  "DIAGNOSTICS"
                                ],
                                "DATA_USED_TO_TRACK_YOU": [
                                  "USAGE_DATA"
                                ]
                              },
                              "new_value": {
                                "DATA_LINKED_TO_YOU": [
                                  "PURCHASES",
                                  "LOCATION",
                                  "CONTACT_INFO",
                                  "SEARCH_HISTORY",
                                  "IDENTIFIERS",
                                  "USAGE_DATA"
                                ],
                                "DATA_NOT_LINKED_TO_YOU": [
                                  "USAGE_DATA",
                                  "DIAGNOSTICS"
                                ],
                                "DATA_USED_TO_TRACK_YOU": [
                                  "USAGE_DATA"
                                ]
                              },
                              "version": "No related version",
                              "is_ab_test": false,
                              "date": "2024-03-04"
                            },
                            {
                              "target": "long_description",
                              "old_value": "Disney+ is the streaming home of your favorite stories. With thousands of hours of entertainment from Disney, Pixar, Marvel, Star Wars, and National Geographic, there's always something to explore. Stream the latest movie releases, exclusive Original series, and a catalog of classics with more stories added every week. Stream Originals like Star Wars: Andor and fan favorites like Encanto and The Simpsons.",
                              "new_value": "Disney+ is the streaming home of your favorite stories. With thousands of hours of entertainment from Disney, Pixar, Marvel, Star Wars, and National Geographic, there's always something to explore. Stream the latest movie releases, exclusive Original series, and a catalog of classics with more stories added every week. And, stream the hottest shows, movies and originals from Hulu, now available on Disney+ for Disney Bundle subscribers.*  Stream Originals like Marvel Studios' Loki and fan favorites like Encanto and The Simpsons.",
                              "version": "3.1.0",
                              "is_ab_test": false,
                              "date": "2024-03-21"
                            },
                            {
                              "target": "icon",
                              "old_value": {
                                "id": "1f7f69b5-d5e3-90e5-5ffe-5901831656a3",
                                "url": "https://is1-ssl.mzstatic.com/image/thumb/Purple116/v4/1f/7f/69/1f7f69b5-d5e3-90e5-5ffe-5901831656a3/AppIcon-0-1x_U007emarketing-0-7-0-0-85-220.png/1024x1024bb.jpg"
                              },
                              "new_value": {
                                "id": "eb3b89ae-6834-a5f6-13d9-7f0b0330e3a9",
                                "url": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/eb/3b/89/eb3b89ae-6834-a5f6-13d9-7f0b0330e3a9/AppIcon-0-0-1x_U007emarketing-0-7-0-0-85-220.png/1024x1024bb.jpg"
                              },
                              "version": "3.1.0",
                              "is_ab_test": false,
                              "date": "2024-03-21"
                            },
                            {
                              "target": "screenshots",
                              "old_value": [
                                {
                                  "id": "192bb9ab-4f6e-f022-1705-f34b4e3c20c5",
                                  "filename": "f800090a-9ec1-4573-8d58-cf48f322508f_1-Mobile-Apple-Home-1242x2688-EN-US.png/1242x2688bb.jpg",
                                  "path_component": "image/thumb/Purple126/v4",
                                  "url": "https://is1-ssl.mzstatic.com/image/thumb/Purple126/v4/19/2b/b9/192bb9ab-4f6e-f022-1705-f34b4e3c20c5/f800090a-9ec1-4573-8d58-cf48f322508f_1-Mobile-Apple-Home-1242x2688-EN-US.png/1242x2688bb.jpg"
                                }
                              ],
                              "new_value": [
                                {
                                  "id": "6ff771ad-e6a6-06ff-6a09-465e6e52c7c7",
                                  "filename": "aaef47f1-acde-40b8-a243-4401058cfb51_EN-US_Mobile_-_iOS_-_6.5_-_Home_-_1.jpg/1242x2688bb.jpg",
                                  "path_component": "image/thumb/PurpleSource221/v4",
                                  "url": "https://is3-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/6f/f7/71/6ff771ad-e6a6-06ff-6a09-465e6e52c7c7/aaef47f1-acde-40b8-a243-4401058cfb51_EN-US_Mobile_-_iOS_-_6.5_-_Home_-_1.jpg/1242x2688bb.jpg"
                                }
                              ],
                              "version": "3.1.0",
                              "is_ab_test": false,
                              "date": "2024-03-21"
                            }
                          ]
                        }
                      },
                      "metadata": {
                        "request": {
                          "path": "/api/public/store/apps/metadata/changes.json",
                          "params": {
                            "device": "iphone",
                            "country": "us",
                            "language": "us",
                            "start_date": "2024-02-28",
                            "end_date": "2024-03-28",
                            "apps": [
                              "1446075923"
                            ]
                          },
                          "cost": 5,
                          "status": 200,
                          "charge_type": "credits"
                        },
                        "response": null
                      }
                    }
                  },
                  "Android": {
                    "value": {
                      "result": {
                        "com.ubercab": {
                          "changes": [
                            {
                              "target": "version",
                              "old_value": "4.504.10002",
                              "new_value": "4.504.10003",
                              "old_release_notes": "We update the Uber app as often as possible to help make it faster and more reliable for you.",
                              "new_release_notes": "We update the Uber app as often as possible to help make it faster and more reliable for you.",
                              "version": "4.504.10003",
                              "is_ab_test": null,
                              "date": "2024-01-04"
                            },
                            {
                              "target": "screenshots",
                              "old_value": [
                                {
                                  "id": "Du0m1FkazoVXD5WYl_4uGtNZamXvig_XhlPNRMQzp8MD6ul-l_liqpBgzXhsN6908g",
                                  "path_component": "play-lh.googleusercontent.com",
                                  "url": "https://play-lh.googleusercontent.com/Du0m1FkazoVXD5WYl_4uGtNZamXvig_XhlPNRMQzp8MD6ul-l_liqpBgzXhsN6908g"
                                }
                              ],
                              "new_value": [
                                {
                                  "id": "8MnUqkrD596UZB9rR5U75m9SnXoOWocuOHztBuqcJ0Ms5rNu-0lm4Ub3gnHCHmEvDD8",
                                  "path_component": "play-lh.googleusercontent.com",
                                  "url": "https://play-lh.googleusercontent.com/8MnUqkrD596UZB9rR5U75m9SnXoOWocuOHztBuqcJ0Ms5rNu-0lm4Ub3gnHCHmEvDD8"
                                }
                              ],
                              "version": "",
                              "is_ab_test": false,
                              "date": "2024-01-05"
                            },
                            {
                              "target": "size",
                              "old_value": 86449474,
                              "new_value": 86449727,
                              "version": "4.504.10003",
                              "is_ab_test": null,
                              "date": "2024-01-04"
                            }
                          ]
                        }
                      },
                      "metadata": {
                        "request": {
                          "path": "/api/public/store/apps/metadata/changes.json",
                          "params": {
                            "device": "android",
                            "country": "us",
                            "language": "us",
                            "start_date": "2024-01-01",
                            "end_date": "2024-01-07",
                            "apps": [
                              "com.ubercab"
                            ]
                          },
                          "cost": 5,
                          "status": 200,
                          "charge_type": "credits"
                        },
                        "response": null
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized. Unknown or missing API token."
          },
          "403": {
            "description": "Forbidden. Not enough credits to perform the request."
          },
          "422": {
            "description": "Validation error. Returned when a parameter is invalid (free), or with the code `AppNotAvailableError` when a requested app is not available in the country, language and device (costs 1 credit)."
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "api_key": {
        "type": "apiKey",
        "name": "x-apptweak-key",
        "in": "header"
      }
    },
    "schemas": {
      "ResponseMetadata": {
        "type": "object",
        "description": "Standard response envelope, identical on every endpoint.",
        "properties": {
          "request": {
            "type": "object",
            "properties": {
              "path": {
                "type": "string",
                "description": "The path that was called."
              },
              "params": {
                "type": "object",
                "nullable": true,
                "description": "The query as the API parsed it, with defaults applied."
              },
              "cost": {
                "type": "integer",
                "description": "Credit cost of the request. Thread tokens do not debit credits."
              },
              "charge_type": {
                "type": "string",
                "enum": [
                  "credits",
                  "thread"
                ],
                "description": "How the request is paid. `credits`: debited from the company's balance. `thread`: an unlimited token, not debited; `cost` shows what the request is worth."
              },
              "status": {
                "type": "integer",
                "description": "HTTP status of the response."
              }
            }
          },
          "response": {
            "type": "object",
            "nullable": true,
            "description": "Endpoint-specific notes; null when there are none."
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```