Google Play App Changelog History API

---

Google Play App Changelog History API. Retrieve comprehensive historical app changelog insights for any Android app available on Google Play.

Definition

Endpoint:

GET https://data.42matters.com/api/v3.0/android/apps/changelog.json

Hits per request:

20

Rate limit:

3 QPS

Required plan:

Large or above.

Historical data:

default 30 days (up to 5 years with 'Historical Package')

Parameters

Name	Required	Description	Available Values	Default
access_token	required	Your access token for using this API. You can get it for FREE by signing up .
p	optional	The package name identifying an Android application.	Any publicly available Android app package name. If undefined, events for all apps are returned.
start_date	optional	The start date of the report	A valid date in the format yyyy-MM-dd, for example: 2020-05-24
end_date	optional	The end date of the report.	A valid date in the format yyyy-MM-dd, for example: 2020-05-30
days	optional	Set the date range from yesterday to the specified number of days in the past.	Without Historical Package: Last 30 days. With Historical Package: up to 5 years	30
event_type	optional	Comma-separated list of event types. Returns results that have any of them.	added, removed, changed
event_field	optional	Comma-separated list of event fields. Return results that have any of them.	version - Version what_is_new - Release Notes downloads_min - Downloads title - Title short_desc - Tagline cat_key - Category content_rating - Content Rating creator - Developer permissions - Permission price_numeric - Price sdks - SDK market_source - Market Source icon - Icon testing - Testing iap - In-app Purchases privacy_policy - Privacy Policy contains_ads - Contains Ads
value	optional	Searches exact match from the current value. Matches value in the response.	string
old_value	optional	Searches exact match from the previous value. Matches old_value in the response.	string
sort_order	optional	Ordering by date	desc or asc	asc
limit	optional	Number of results to return.	1-100. Free trial results limited to 5.	100
page	optional	Page based on the limit parameter, used for pagination.	1 - max_pages. There is a limit of 10000 results that can be iterated.
callback	optional	If supplied, the response will use the JSONP format with a callback of the given name.

Responses

Status Code	Indication	Content-Type	Body
200	Everything is OK	application/json	Attribute Type Description number_results Integer Total number of results for this query num_pages Integer Maximum number of pages it's possible to iterate has_next Boolean Flag indicating if there is a next page available limit Integer Number of results per request page Integer Current page number package_name String The app package name (unique identifier). Only present when package_name is passed. start_date Date A date in the format: yyyy-MM-dd end_date Date A date in the format: yyyy-MM-dd dates Array of dates Sorted list of dates in the response mappings Array of mappings List of changelog value keys: version, what_is_new, downloads_min, title, short_desc, cat_key, content_rating, creator, permissions, price_numeric, sdks, new_app, discovered, market_source, icon, testing, iap, privacy_policy, contains_ads changelog Array of Objects Sorted list of changelog objects in the response. Each changelog object contains: package_name, date, value, old_value, event_type, event_field
404	The package name is not found	application/json	Error object
402	Your request exceeds what's allowed by your current subscription plan	application/json	Error object
403	Your access token is not valid	application/json	Error object
429	Your request rate is over the limit	application/json	Error object

Example Request

Changelog for the TikTok app on Google Play:

https://data.42matters.com/api/v3.0/android/apps/changelog.json?p=com.zhiliaoapp.musically&start_date=2023-05-11&end_date=2023-06-10&access_token=YOUR_ACCESS_TOKEN

---

This request can also be imported into Postman. Check out our Postman integration guide.

Example Response

Last Modified: 12 May 2022