Find out exactly when and in which lists a selected app was featured.

Unlike the other endpoints, this one returns data about how the store looks, so it feels appropriate to give an in-depth explanation of the response format and the input parameters.

What data does AppTweak fetch for this endpoint?

AppTweak performs a daily search on the store looking for the featured content of the store. Depending on the store this can mean different things since Google and Apple chose to market the apps differently.

PlayStore data

Games & Apps

AppTweak collects data for the following displayed menus in color. When the menus is greyed out, it means that AppTweak doesn't fetch the data.

12211221

Non-available data is greyed out. "Games - For you" is not fetched by AppTweak because it is too user-dependent data.

12221222

Non-available data is greyed out. "Games - New" & "Games - Premium" are not fetched by AppTweak.

Menu nameData available?CommentApplies to
For you🚫This section is too dependent on the user and therefore varies greatly.Games/Apps
Top Charts✅The data is provided in the Top Charts endpointGames/Apps
Children⚠️The data is partially available under the Family sectionGames/Apps
New🚫This data is not being currently fetched by AppTweak.Games
Premium🚫This data is not being currently fetched by AppTweak.Games
Categories✅This data is available for all categories.Games/Apps

Featurings

On Google Play, we identified the following featurings for the menus for which AppTweak fetches data.

11111111

On the left image, an apps group (1.) and a top chart (2.) are featured. On the right image, an in-store link (3.), a top chart (2.) and an apps group (1.) are featured.

Featuring typeData available?Comment
App groups✅Group of apps with a title and subtitle.
Top Charts✅Best 30 "free" ranked apps in a category.
In Store Links🚫Link to a new app store page containing new app groups. AppTweak does not currently fetch that data.

AppStore Data

Menu's

AppTweak collects data for the following displayed sections in color. When the section is greyed out, it means that AppTweak doesn't fetch the data.

17621762

AppTweak fetches data for the sections "Today", "Games", "Apps" but not for "Arcade".

Featurings

Based on the menu you're in you might see different types of featurings.

On the "Today" tab, AppTweak fetches the first 6 app cards from iOS 11. Since AppTweak fetches data from iOS 11 for the featured content you might not see some stories such as "Now available" or "Now Happening".

On the "Apps" tab, AppTweak fetches the whole store page on iOS 11. However, there are some featuring that AppTweak doesn't fetch such as "Popular Apps".

On the "Games" tab, AppTweak fetches the whole store page on iOS 11. We didn't identify yet any missing sections compared to the latest version of iOS.

Input values

Input parameterExplanation
appId of an app for which we will search in the given store.
deviceStore where the featured content will be searched for: iphone or android.
countryCountry of the store to be searched, complete list can be found here.
languageAndroid only : language of the featured content. The list of countries/language combinations is available here.
typeTab/Section of the store where to look for. It can be "today", "games" and "apps" for iOS or "family", "apps" and "games" for Android.
start_dateStart date for which you would like to analysed featured content.
end_dateEnd date for which you would like to analysed featured content.

Response format explanation

Since both stores are visually different, the response format varies greatly based on this. You will therefore have to parse the response differently if the featured content happens on the App Store or Google Play.

In the table below you can find the different fields that are present in the responses for iPhone & Android devices.

Attributeiphoneandroidcomment
apps✅✅list of single or multiple app id(s)
artworks✅➖object that contains the full artwork details of an app
category➖✅Google Play category ID in which the app was featured. Find the full list here.
date✅✅date of the featuring
header✅➖
position✅✅Vertical position of the featuring on the screen. "1" is the first featuring on the screen.
position_in_story_group✅➖Position of the featuring when multiple featurings appear at the same position on the screen (= carousel).
subtitle✅✅
title✅✅

PlayStore Featured Content

AppTweak logically divides the screen into what are called "Groups". Each group consists of a horizontally scrollable set of apps that are related under the same title. The following screenshot marks two different examples of groups in the PlayStore:

13821382

Featured content types in the PlayStore as of August 2022

The featured content in the PlayStore app, at the time of writing, can be easily divided into two subcategories; "App Groups" (marked with a one) and "In-Store Links" (marked with a two). From this screen, and with these divisions, AppTweak scraps the apps and collects the data. Unfortunately, for "In-Store Links" Apptweak does not fetch the list of applications.

A response for Featured Content of the PlayStore app can be shown in the following code snippet:

"featured_content": [
  {
        "title": "Featured apps", 
        "subtitle": "Best for your watch",
    "apps": [...],
    "position": 1,
        "date": "2022-09-14",
        "category": "Android Wear"
  }
]

As you can see, the endpoint returns all the pertinent information of the featured content found, including the category where the app has been found and the date. Under the key android_featured_content, you will find the different app groups that contain the title of the featuring, the subtitle, the list of featured app(s), with the position of app group on the screen.

AppStore Featured Content

Similar to the PlayStore, AppTweak also divides the AppStore into different groups; "Stories" (marked with a 1) and "Apps Group" (marked with a 2). Those numbers (1 & 2) also indicate the vertical position of the featured content on the page. The following can be appreciated in the next two screenshots.

13841384

Featured content on the "Apps" tab on the 19th of August on the Belgian App Store. The number 1 and 2 indicates

The response format for the featured content of the app "LinkedIn: Job Search & News" with app ID 288429040 on the 19th of August on the Belgian App Store is the following:

"featured_content": [
      {
        "apps": "288429040",
        "artworks": ["..."],
        "date": "2022-08-19",
        "header": "FEATURED",
        "position": 1, // position on the story group on the screen
        "position_in_story_group": 6, // position of the story inside the story group
        "subtitle": "Network and grow your career",
        "title": "LinkedIn: Network & Job Finder"
      },
      {
        "apps": ["835599320",
          ...,
          "288429040", // the position of the app_id in the app list is the same the position on the store
                    ...
        ],
        "artworks": "",
        "date": "2022-08-19",
        "header": "",
        "position": 2, // position on the story group on the screen
        "position_in_story_group": "", // Does not apply since it is not a story
        "subtitle": "Network and grow your career",
        "title": "App Essentials"
        "title": "",
    ]

As you can see the response contains all the relevant details from the store. Featured content can either be a single app or an app listing. In this case, you can notice which one it is by taking a look at the apps field response. If the field contains more than one app, it is an app listing.

The position of an app featuring is present at different levels:

  • Its vertical position on the screen is indicated by the key position. If the position is 1 it means that the app is featured in the hero banners.
  • Its horizontal position inside a story group on a screen is indicated by position_in_story_group. This is only applicable for story groups and may be empty otherwise.
  • Its position inside an app group is indicated by app_id position inside the apps list. The position of the app inside the app listing is not explicitly mentioned. However, the position of the app is the same as its position in the list of app ids.

Here's an example of how the position of an app is defined on our API.

25222522

Featured Content Response for the App "Ibis Paint X" with app ID "450722833". The key position stands for the vertical position of the story indicated by the green arrow on the left image. The key position_in_story_group indicates the vertical position of the story indicated by the orange arrow on the left image. The position of the app inside the story can be deducted by its position in the list of app ids. App

FAQ

📘

Are the featurings the same for everyone?

The short answer is no. It depends on a lot of different factors such as the iOS/GP version the user is on and the user preferences. Moreover, you'll get different featured apps for the same user if he comes multiple times on the same day.

📘

Which Google Play version or iOS version does AppTweak fetch data for?

AppTweak fetches on the version 28.X of the Google Play Store. If you see some differences, it's probably because AppTweak didn't parse that data yet.

AppTweak currently fetches data from iOS 11 and is transitioning towards iOS 14. This means that you might see some differences with AppTweaks' data and what you see on your phone. Unfortunately, we don't have a timeline yet for a transition toward iOS 15. Features that are exclusive to this version such as In-App Events won't be available.

📘

Featuring type missing?

Since the featured content of the stores evolves very rapidly it can happen that AppTweak doesn't catch those. If you encounter some, please reach out to us.

📘

Unknown groups?

While AppTweak always strives to be at the top of every change, in an environment as dynamic as the Play Store and the AppStore it's not impossible that some groups can be left unparsed. In that case, AppTweak still fetches the data and still displays it in the endpoint, however, the formats can vary greatly from those demonstrated in this documentation