App Store iOS App Changelog History API

---

App Store iOS App Changelog History API. Retrieve comprehensive historical app changelog insights for any iOS app available on Apple App Store.

Definition

Endpoint:

GET https://data.42matters.com/api/v3.0/ios/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 .
id	optional	The app ID on the Apple App Store - (e.g for Facebook the ID is 284882215).	Existing App ID on Apple App Store. 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. Returns results that have any of them.	version - Version primaryGenreId - Genre trackCensoredName - Title artistName - Developer minimumOsVersion - Min OS Version price - Price contentAdvisoryRating - Content Rating releaseNotes - Release Notes sdks - SDK market_source - Market Source permissions - Permissions artworkUrl60 - Icon 60px artworkUrl100 - Icon 100px hasInAppPurchases - Has In-App Purchases subtitle - Subtitle isPreorder - Is Pre-order privacyPolicyUrl - Privacy Policy
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 trackId String Numeric unique identifier for the app assigned by Apple. Only present when id 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, primaryGenreId, trackCensoredName, artistName, minimumOsVersion, price, contentAdvisoryRating, releaseNotes, sdks, new_app, discovered, market_source, permissions, artworkUrl60, artworkUrl100, hasInAppPurchases, subtitle, isPreorder, privacyPolicyUrl changelog Array of Objects Sorted list of changelog objects in the response. Each changelog object contains: trackId, date, value, old_value, event_type, event_field
404	The trackId 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 App Store:

https://data.42matters.com/api/v3.0/ios/apps/changelog.json?id=835599320&start_date=2023-01-07&end_date=2023-02-06&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