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
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 |
Last Modified: 12 May 2022