Skip to content

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:

Terminal window
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

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).