Featured apps
Try this endpoint · Response attributes
To retrieve apps featured in the “New Games We Love” list on the root page of the iTunes App Store, use the following query:
curl -X "GET" "https://integrations.apptopia.com/api/itunes_connect/featured_lists?date=2016-05-19&category_id=36&country_iso=US&list_name_in_us=New+Games+We+Love" \ -H "Authorization: $APPTOPIA_TOKEN"Example response:
[ { "name": "New Games We Love", "app_ids": [ "1075872386", "1031706898", "1079464948", "1083451870", "974135847", "1108384425", "1071426243", "1044953131", "1057415521", "1096204046", "1022239163", "1084252650", "1071511733", "1084600612", "1084135698", "1087282720" ] }]Data on featured apps is returned in form of id lists, similarly to rank top charts.
Featured apps endpoint path: /api/:store/featured_lists
Query parameters
Section titled “Query parameters”| Param | Description |
|---|---|
date |
string, ISO 8601 date |
country_iso |
string, ISO 3166 A2 country code |
list_name_in_us |
optional string, name of featured list, as it appears in US store; when not present - returns all lists matching other parameters |
match_type |
string, can be any of: eq, regexp, defines how list_name_in_us is used for string matching. Optional, default value is eq |
category_id |
required integer, store specific category id, referencing store category page on which featured list appears |
Root page of an app store can be referenced by Overall category id (store specific).