Featured Stories

Featured Stories allows you to fetch all the stories (Featured Apps) that AppTweak has been able to gather about a specific app on the App Store in the selected countries on a given period. This is particularly useful when you suddenly see a huge spike in App Impressions and you have no idea where they come from. You know your app has probably been featured on the App Store, but it’s not easy to find out in which type of Story or in which countries it was published.

Featured Stories endpoints

In order to fetch all the data related to the Featured Apps within stories, we split our endpoints into two parts. The first one would provide a list of stories ids with the related apps ids per country at a specific date. The second one would give the content of a given story (story cover and details).

Object Example

{
  "2019-04-23": {
    "be": {
      "1451509117": {
        "position": 3,
        "app_ids": [
          1060878359
        ]
      },
      "1451703987": {
        "position": 2,
        "app_ids": [
          1354478141
        ]
      },
      "1455081440": {
        "position": 1,
        "app_ids": [
          306310789
        ]
      },
      "1457297020": {
        "position": 4,
        "app_ids": [
          585512923,
          1058370552,
          1038007349,
          1315946489,
          1229630187,
          403858572,
          977281041,
          965965461,
          1392863702,
          435871950,
          466252999,
          1199350277
        ]
      }
    }
  }
}