Category Services

Top Charts ( 10 Credits / Request )

Provides top charts information for given category, country, ranking type and device.

GET /playstore-category/topcharts/{category}/{countryCode}/{categoryType}

Request Parameters

Parameter	Description
category	(required) Category name
countryCode	(required) Two letter country code
categoryType	(required) FREE, PAID, GROSSING
date	(required) YYYY-MM-DD formatted date

Response Fields

Field	Description
trackId	Google Play track id of the app
category	Category id
rank	Category ranking value
date	Date in epoch time format
type	0=Free, 1= Paid, 2=Grossing

Example request

curl "https://api.mobileaction.co/playstore-category/topcharts/FAMILY/US/FREE?date=2019-03-01&token=YOUR_API_KEY"

Example response

[
  {
    "trackId": "com.roblox.client",
    "category": 57,
    "rank": 1,
    "date": 1551436343000,
    "type": 0
  },
  {
    "trackId": "com.google.android.apps.youtube.kids",
    "category": 57,
    "rank": 2,
    "date": 1551436343000,
    "type": 0
  },
  {
    "trackId": "com.duolingo",
    "category": 57,
    "rank": 3,
    "date": 1551436343000,
    "type": 0
  },
  {
    "trackId": "com.superbinogo.jungleboyadventure",
    "category": 57,
    "rank": 4,
    "date": 1551436343000,
    "type": 0
  },
  {
    "trackId": "com.WildWorks.RyansTag",
    "category": 57,
    "rank": 5,
    "date": 1551436343000,
    "type": 0
  },
  {
    "trackId": "org.pbskids.video",
    "category": 57,
    "rank": 6,
    "date": 1551436343000,
    "type": 0
  },
  {
    "trackId": "com.KnowledgeAdventure.SchoolOfDragons",
    "category": 57,
    "rank": 7,
    "date": 1551436343000,
    "type": 0
  },
  {
    "trackId": "com.disney.datg.videoplatforms.android.watchdc",
    "category": 57,
    "rank": 8,
    "date": 1551436343000,
    "type": 0
  },
  {
    "trackId": "org.pbskids.gamesapp",
    "category": 57,
    "rank": 9,
    "date": 1551436343000,
    "type": 0
  },
  {
    "trackId": "no.mobitroll.kahoot.android",
    "category": 57,
    "rank": 10,
    "date": 1551436343000,
    "type": 0
  }
]

Category Ranking ( 10 Credits / Request )

Provides category rankings history of an app in Google Play. Max 30 days of history is allowed for a single request.

GET /playstore-category/{trackId}/{country}&startDate={startDate}&endDate={endDate}

Request Parameters

Parameter	Description
trackId	(required) Google Play track id of app
countryCode	(required) Two letter country code
startDate	(required) YYYY-MM-DD formatted date, history start date, inclusive.
endDate	(required) YYYY-MM-DD formatted date, history end date, exclusive.

Response Fields

Field	Description
trackId	Google Play track id of app
countryCode	Two letter country code, categories are mapped by this
categoryName	Category name, ranking type and ranking data are mapped by this
rankingType	0 = FREE, 1 = PAID, 2 = GROSSING
date	Date in timestamp format
ranking	Category ranking value

Example request

curl "https://api.mobileaction.co/playstore-category/com.facebook.katana/US?startDate=2019-09-01&endDate=2019-09-03&token=YOUR_API_KEY"

Example response

{
  "trackId": "com.facebook.katana",
  "countryCode": "US",
  "ranksByCategoryNames": [
    {
      "categoryName": "OVERALL",
      "rankings": [
        {
          "rankingType": 0,
          "ranksByDate": [
            {
              "date": 1567321200000,
              "rank": 37
            },
            {
              "date": 1567407600000,
              "rank": 52
            }
          ]
        },
        {
          "rankingType": 2,
          "ranksByDate": [
            {
              "date": 1567321200000,
              "rank": 261
            },
            {
              "date": 1567407600000,
              "rank": 266
            }
          ]
        }
      ]
    },
    {
      "categoryName": "SOCIAL",
      "rankings": [
        {
          "rankingType": 0,
          "ranksByDate": [
            {
              "date": 1567321200000,
              "rank": 4
            },
            {
              "date": 1567407600000,
              "rank": 4
            }
          ]
        },
        {
          "rankingType": 2,
          "ranksByDate": [
            {
              "date": 1567321200000,
              "rank": 10
            },
            {
              "date": 1567407600000,
              "rank": 10
            }
          ]
        }
      ]
    }
  ]
}

Global Last Day Category Rankings ( 20 Credits / Request )

Provides global category rankings of an app in PlayStore for last day.

GET /playstore-category/global-rankings-last-day/{trackId}

Request Parameters

Parameter	Description
trackId	(required) Google Play track id of app

Response Fields

Field	Description
trackId	Google Play track id of app
countryCode	Two letter country code, categories are mapped by this
categoryName	Category name, ranking type and ranking data are mapped by this
rankingType	FREE, PAID, GROSSING
date	Date in LocalDateTime format
ranking	Category ranking value

Example request

curl "https://api.mobileaction.co/playstore-category/global-rankings-last-day/com.facebook.katana?token=YOUR_API_KEY"

Example response

{
  "trackId": "com.facebook.katana",
  "ranksByCategory": {
    "PK": {
      "OVERALL": [
        {
          "rankingType": "FREE",
          "rankingsByDate": [
            {
              "date": "2019-06-18T07:00:00",
              "ranking": 9
            }
          ]
        },
        {
          "rankingType": "GROSSING",
          "rankingsByDate": [
            {
              "date": "2019-06-18T07:00:00",
              "ranking": 444
            }
          ]
        }
      ],
      "SOCIAL": [
        {
          "rankingType": "FREE",
          "rankingsByDate": [
            {
              "date": "2019-06-18T07:00:00",
              "ranking": 2
            }
          ]
        },
        {
          "rankingType": "GROSSING",
          "rankingsByDate": [
            {
              "date": "2019-06-18T07:00:00",
              "ranking": 42
            }
          ]
        }
      ]
    }
  }
}

New Apps ( 3 Credits / Request )

Provides app infos for newly released app for given country and category.

GET /playstore-category/new-apps/{category}/{countryCode}/{rankingType}?date={date}

Request Parameters

Parameter	Description
category	(required) Category name
countryCode	(required) Two letter country code
rankingType	(required) FREE, PAID or GROSSING
date	(optional) YYYY-MM-DD formatted date, default value is yesterday's date

Response Fields

Field	Description
trackId	Google Play track id of app
name	App name
url	App URL
price	App price, empty if app is free
iconUrl	URL containing app's icon
developerId	Google Play Store name of the developer
releaseDate	Release date of the app in date-time format
developerName	Name of the developer

Example request

curl "https://api.mobileaction.co/playstore-category/new-apps/BOOKS_AND_REFERENCE/US/FREE?token=YOUR_API_KEY"

Example response

[
  {
    "trackId": "com.aorio.freediamond.freefirediamondforfree1",
    "name": "Guide and Free Diamonds for Free App",
    "url": "",
    "price": "",
    "iconUrl": "https://play-lh.googleusercontent.com/kMgW0BSLyIZpjxr9wN6AInHd3kf7v5Qm7iTegzoxofyw4t0k9krbjaiVjQF7mqBneMCR",
    "category": "",
    "developerId": "Aorio Apps",
    "releaseDate": "2021-04-28T00:00:00",
    "developerName": "Aorio Apps"
  },
  {
    "trackId": "com.istory.lite",
    "name": "iStory Lite-Read & Write Stories",
    "url": "",
    "price": "",
    "iconUrl": "https://play-lh.googleusercontent.com/i7-mEqMDSyzj7QqCj2Crb3wDyVyFTjBqqISZmc9KiqeG8sbWcFiwWLuk_MgincDRZgOM",
    "category": "",
    "developerId": "Reader Studio",
    "releaseDate": "2021-04-29T00:00:00",
    "developerName": "Reader Studio"
  }
]