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


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

Example Response


Last Modified: 12 May 2022


Automate Your Workflow With 42matters’ APIs


Integrate app data and intelligence into your existing workflows, dashboards, CRM platforms, messaging platforms, and more! Below is a selection of the third-party services that are compatible with 42matters’ APIs:



Salesforce

Salesforce

HubSpot

HubSpot

Slack

Slack

Intercom

Intercom

Pipedrive

Pipedrive

Zendesk

Zendesk

Gekoboard

Gekoboard

Klipfolio

Klipfolio

Dynamics

Dynamics


And many more!