Filtered Featured Apps

GET 2 Credits / Day / Request /android/featured-contents/filter.json

Filtered Featured Apps allows you to fetch all the featured apps that AppTweak has been able to gather about a specific app on the Play Store in the selected countries on a given period.

Filtered Featured Apps Request

A list of featured content ids with their page name (category) and section. Those results are listed per date, country and language.

Header parameters
X-AppTweak-Key:
Your AppTweak API Key.
Query parameters
countries: string worldwide

A string of concatenated two-letter country code (ISO Alpha-2) separated per comma.

Get the list of our country codes, here.

start_date: date today - 3 days

Start date, format: YYYY-MM-DD

end_date: date today

End date, format: YYYY-MM-DD

application_id: string

Application Id for which we try to found related featured content.

section: string

apps, games, family

page_name: string

The category for which you want to get the featured apps. (which can be found here)

GET /android/featured-contents/filter.json

Request example
GET /android/featured-contents/filter.json?start_date=2019-12-01&end_date=2019-12-04&application_id=com.duolingo
cURL example
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com//android/featured-contents/filter.json?start_date=2019-12-01&end_date=2019-12-04&application_id=com.duolingo"

Filtered Featured Apps Response

The response to the filtered featured apps request is a JSON hash containing a list of featuring ids for the given countries, application id and period.

Object properties
FC id: string

The key of the hash is the featuring id

CHILD PROPERTIES

page: string

The category

section: string

The section ('apps', 'games' or 'family')

Response Example

{
  "content": {
    "2019-12-01": {
      "us": {
        "us": {
          "62880": {
            "page": "EDUCATION",
            "page_type": "category",
            "parent_page_info": null,
            "section": "apps",
            "groups": [
              {
                "id": "-883675926273808763",
                "elements": [
                  {
                    "id": "com.ted.android",
                    "type": "app",
                    "app_ids": [
                      "com.ted.android"
                    ]
                  },
                  {
                    "id": "uk.co.bbc.learningenglish",
                    "type": "app",
                    "app_ids": [
                      "uk.co.bbc.learningenglish"
                    ]
                  },
                  {
                    "id": "com.duolingo",
                    "type": "app",
                    "app_ids": [
                      "com.duolingo"
                    ]
                  },
                  {
                    "id": "com.mileoDev.geography",
                    "type": "app",
                    "app_ids": [
                      "com.mileoDev.geography"
                    ]
                  },
                  {
                    "id": "org.khanacademy.android",
                    "type": "app",
                    "app_ids": [
                      "org.khanacademy.android"
                    ]
                  },
                  {
                    "id": "com.lumoslabs.lumosity",
                    "type": "app",
                    "app_ids": [
                      "com.lumoslabs.lumosity"
                    ]
                  },
                  {
                    "id": "org.edx.mobile",
                    "type": "app",
                    "app_ids": [
                      "org.edx.mobile"
                    ]
                  }
                ]
              },
              {
                "id": "-6323286721262343090",
                "elements": [
                  {
                    "id": "apps_topselling_free",
                    "type": "top_chart",
                    "app_ids": [
                      "com.duolingo",
                      "com.nick.noggin",
                      "mobi.abcmouse.academy_goo",
                      "com.curiosity.curiositystream",
                      "kr.co.smartstudy.babyshark_android_googlemarket",
                      "org.pbskids.video",
                      "com.classdojo.android",
                      "no.mobitroll.kahoot.android",
                      "com.brainbow.peak.app",
                      "com.google.android.apps.classroom"
                    ]
                  },
                  {
                    "id": "apps_topgrossing",
                    "type": "top_chart",
                    "app_ids": [
                      "com.udemy.android",
                      "com.duolingo",
                      "com.wonder",
                      "air.com.rosettastone.mobile.CoursePlayer",
                      "com.nick.noggin",
                      "com.getepic.Epic",
                      "com.classdojo.android",
                      "com.lumoslabs.lumosity",
                      "com.memrise.android.memrisecompanion",
                      "com.babbel.mobile.android.en"
                    ]
                  },
                  {
                    "id": "apps_movers_shakers",
                    "type": "top_chart",
                    "app_ids": [
                      "com.microblink.photomath",
                      "com.curiosity.curiositystream",
                      "com.google.android.apps.classroom",
                      "com.remind101",
                      "com.bagatrix.mathway.android",
                      "co.brainly",
                      "com.quizlet.quizletandroid",
                      "com.classdojo.android",
                      "com.duolingo",
                      "org.socratic.android"
                    ]
                  },
                  {
                    "id": "apps_topselling_paid",
                    "type": "top_chart",
                    "app_ids": [
                      "com.tocaboca.tocalab",
                      "com.vitotechnology.StarWalk2",
                      "com.tocaboca.tocahairsalon3",
                      "com.t11.skyview",
                      "com.tocaboca.tocakitchensushi",
                      "com.tocaboca.tocahospital",
                      "com.tocaboca.tocaneighborhood",
                      "com.tocaboca.tocavacation",
                      "org.xtramath.mathfacts",
                      "com.tocaboca.tocaschool"
                    ]
                  }
                ]
              },
              {
                "id": "-7655323555932451493",
                "elements": [
                  {
                    "id": "air.nn.mobile.app.main",
                    "type": "app",
                    "app_ids": [
                      "air.nn.mobile.app.main"
                    ]
                  },
                  {
                    "id": "com.wonder",
                    "type": "app",
                    "app_ids": [
                      "com.wonder"
                    ]
                  },
                  {
                    "id": "com.brainbow.peak.app",
                    "type": "app",
                    "app_ids": [
                      "com.brainbow.peak.app"
                    ]
                  },
                  {
                    "id": "com.skillshare.Skillshare",
                    "type": "app",
                    "app_ids": [
                      "com.skillshare.Skillshare"
                    ]
                  },
                  {
                    "id": "com.linkedin.android.learning",
                    "type": "app",
                    "app_ids": [
                      "com.linkedin.android.learning"
                    ]
                  },
                  {
                    "id": "net.tandem",
                    "type": "app",
                    "app_ids": [
                      "net.tandem"
                    ]
                  }
                ]
              }
            ]
          }
        }
      }
    }
  },
  "metadata": {
    "request": {
      "path": "/featured-contents/filter.json",
      "store": "android",
      "params": {
        "start_date": "2019-12-01T00:00:00+00:00",
        "end_date": "2019-12-04T00:00:00+00:00",
        "countries": "us",
        "application_id": "com.duolingo",
        "format": "json"
      },
      "performed_at": "2020-08-10 09:27:24 UTC"
    },
    "content": {
    }
  }
}