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 Google Play.
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 4 years |
30 |
event_type |
optional |
Comma-separated list of event types. Returns results that have any of them. |
added, removed, changed, released |
|
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 |
|
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 |
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