Sign in

v1

latestOpenAPI 3.1.02026-07-24450694.7 KB

Featured Content Details

Allows you to fetch all the featurings that AppTweak has been able to gather on App Store or Google play in the selected countries on a given period.

get/featured_content/filter.json

Query parameters

appstring required

Application Id for which we try to find related featured content. <br/> <a href="https://developers.apptweak.com/reference/how-to-find-app-ids" target="_blank">How to find App IDs?</a>

start_datestring date required

Start date of the period in format YYYY-MM-DD

end_datestring date required

End date of the period in format YYYY-MM-DD. <br/><b>Maximum 14 days per call</b>

countrystring

Two letter <a href="https://apptweak.readme.io/reference/country-codes">country code</a>. <br/><b>Default:</b> us

languagestring

<b>Only for Android</b>. Two letter <a href="https://apptweak.readme.io/reference/country-codes" target="_blank">language code</a>. <br/><b>Default:</b> us

typestring

Tab/Section of the store: "today", "apps" or "games" for iOS or "apps" or "games" for Android. Only <b>one</b> type is allowed. <br/><b>Default:</b> apps

device'iphone' | 'android'

Choose a device from iphone or android. <br/><b>Default:</b> iphone

Response

200

OR

Example response

{
  "result": {
    "featured_content": [
      {
        "apps": [
          "447188370"
        ],
        "artworks": [
          {
            "subscription_hero": {
              "width": 4320,
              "height": 1080,
              "url": "https://is4-ssl.mzstatic.com/image/thumb/Features125/v4/da/92/c1/da92c16c-0896-29f7-9238-2484167c05c2/source/4320x1080.png"
            }
          }
        ],
        "date": "2022-08-01",
        "header": "THE SOCIAL SCENE",
        "position": 1,
        "position_in_story_group": 6,
        "subtitle": "Chat, stream, and be together",
        "title": "Stay Connected With These Apps"
      }
    ]
  },
  "metadata": {
    "request": {
      "path": "/api/public/store/featured_content/filter.json",
      "params": {
        "device": "iphone",
        "country": "us",
        "language": "us",
        "start_date": "2022-08-01",
        "end_date": "2022-08-01",
        "type": "apps",
        "app": "447188370"
      },
      "cost": 101,
      "max_credit_cost": 101,
      "status": 200
    }
  }
}