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

Hits per request:

20

Rate limit:

3 QPS

Required plan:

Large or above.

Historical data:

default 30 days (365 with 'Historical Plan')

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 required The app ID on the iTunes store - (e.g for Facebook the ID is 284882215). Existing App ID on iTunes Store
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: Last 365 days 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
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
changelog Array of Objects Sorted list of changelog objects in the response. Each changelog object contains: 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

Example Response


Last Modified: 26 Jan 2021


Automate your workflow


Bring app data into your existing workflow, dashboards, CRM, messaging platforms and many more services! Here a selection of third-party services we support:



Email

Email

Salesforce

Salesforce

HubSpot

HubSpot

Slack

Slack

Intercom

Intercom

Pipedrive

Pipedrive

Zendesk

Zendesk

Gekoboard

Gekoboard

Klipfolio

Klipfolio

Dynamics

Dynamics


And many more!


GET FREE INTEGRATIONS via Zapier!