Keyword Services

This section describes Google Play related API services.

Keyword Ranking ( 3 Credits / Request )

Provides single day's keyword ranking for given keyword list and track id of an app in Google Play.

bash

GET /playstore-keyword-ranking/{trackId}/{countryCode}/keywordrankings?keywords={keywords}&date={date}

Request Parameters

Parameter	Description
`trackId`	(required) Google Play track id of app
`countryCode`	(required) Two letter country code
`keywords`	(required) Comma separated keyword list (max 100 keywords are allowed)
`date`	(optional) YYYY-MM-DD formatted date, yesterday is used if omitted.

Response Fields

Field	Description
`trackId`	Google Play track id of app
`keyword`	Keyword
`countryCode`	Two letter country code
`date`	Date in epoch time format
`rank`	Keyword ranking for current day

Example request

bash

curl "https://api.mobileaction.co/playstore-keyword-ranking/com.facebook.katana/US/keywordrankings?keywords=face&token=YOUR_API_KEY"

Example response

json

[
  {
    "trackId": "com.facebook.katana",
    "keyword": "face",
    "rank": 1,
    "countryCode": "US",
    "date": 1480579200000
  }
]

Keyword History ( 10 Credits / Request )

Provides historic keyword ranking for given keyword and track id of an app in Google Play. Max 30 days of history is allowed for a single request.

bash

GET /playstore-keyword-ranking/{trackId}/{countryCode}/{keyword}/keywordrankings?startDate={startDate}&endDate={endDate}

Request Parameters

Parameter	Description
`trackId`	(required) Google Play track id of app
`countryCode`	(required) Two letter country code
`keywords`	(required) Comma separated keyword list (max 100 keywords are allowed)
`date`	(optional) YYYY-MM-DD formatted date, yesterday is used if omitted.
`startDate`	(required) YYYY-MM-DD formatted date, history start date, inclusive.
`endDate`	(required) YYYY-MM-DD formatted date, history end date, inclusive.

Response Fields

Field	Description
`trackId`	Google Play track id of app
`keyword`	Keyword
`countryCode`	Two letter country code
`date`	Date in epoch time format
`rank`	Keyword ranking for current day

Example request

bash

curl "https://api.mobileaction.co/playstore-keyword-ranking/com.facebook.katana/US/face/keywordrankings?startDate=2017-01-01&endDate=2017-01-15&token=YOUR_API_KEY"

Example response

json

[
  {
    "trackId": "com.facebook.katana",
    "keyword": "face",
    "rank": 1,
    "countryCode": "US",
    "date": 1480579200000
  }
]

Top Keywords ( 20 Credits / Request )

Provides single day's top keywords for given track id of an app in Google Play.

bash

GET /playstore-keyword-ranking/{trackId}/{countryCode}/top-keywords?date={date}&limit={limit}

Request Parameters

Parameter	Description
`trackId`	(required) Google Play track id of the app
`countryCode`	(required) Two letter country code
`date`	(required) YYYY-MM-DD formatted date
`limit`	(optional) Requested number of keywords in result, default value is 100

Response Fields

Field	Description
`keyword`	Keyword
`searchVolume`	Search volume of keyword
`rank`	Keyword ranking of the app

Example request

bash

curl "https://api.mobileaction.co/playstore-keyword-ranking/com.facebook.katana/US/top-keywords?date=2018-06-26&limit=150&token=YOUR_API_KEY"

Example response

json

[
  {
    "keyword": "facebook",
    "searchVolume": 85,
    "rank": 1
  },
  {
    "keyword": "face",
    "searchVolume": 75,
    "rank": 1
  }
]

Keyword Metadata ( 5 Credits / Request )

Provides last day's keyword meta-data for given keyword for Google Play.

bash

GET /playstore-keyword-ranking/{countryCode}/keyword-metadata?keyword={keyword}

Request Parameters

Parameter	Description
`countryCode`	(required) Two letter country code
`keyword`	(required) Keyword

Response Fields

Field	Description
`keyword`	Keyword
`countryCode`	Two letter country code
`numberOfApps`	Number of apps
`searchVolume`	Search Volume
`playChance`	Chance
`brandApp`	Brand app track id

Example request

bash

curl "https://api.mobileaction.co/playstore-keyword-ranking/US/keyword-metadata?keyword=whatsapp&token=YOUR_API_KEY"

Example response

json

{
  "keyword": "whatsapp",
  "countryCode": "US",
  "numberOfApps": 249,
  "searchVolume": 61,
  "playChance": 56.3,
  "brandApp": "com.whatsapp"
}

List of Apps ( 5 Credits / Request )

Provides app list for given keyword for Google Play.

bash

GET /playstore-keyword-ranking/{countryCode}/keyword-apps?keyword={keyword}

Request Parameters

Parameter	Description
`countryCode`	(required) Two letter country code
`keyword`	(required) Keyword

Response Fields

Field	Description
`keyword`	Keyword
`countryCode`	Two letter country code
`lastUpdateDate`	Last update date
`apps`	List of track id for PlayStore apps

Example request

bash

curl "https://api.mobileaction.co/playstore-keyword-ranking/US/keyword-apps?keyword=twitter&token=YOUR_API_KEY"

Example response

json

{
  "keyword": "twitter",
  "countryCode": "US",
  "lastUpdateDate": 1535698790000,
  "apps": [
    "com.twitter.android",
    "tv.periscope.android",
    "co.vine.android",
    "com.klinker.android.twitter_l",
    "com.handmark.tweetcaster",
    "tweeter.gif.twittervideodownloader",
    "com.arthurivanets.owly",
    "it.mvilla.android.fenix2",
    "com.dwdesign.tweetings",
    "twitter.android.finch",
    "org.mariotaku.twidere",
    "nubianplanet.com",
    "com.innovatty.followersplus",
    "com.echofon",
    "com.tweetkit.app",
    "com.filippocicirelli.followers",
    "com.levelup.touiteur",
    "com.twidroid",
    "com.rosteam.saveinstaa",
    "com.ubersocialpro",
    "ccstudio.followers.unfollowers.twitter"
  ]
}

Organic Keywords ( 50 Credits / Request )

Provides list of organic keywords and their rankings for Google Play.

bash

GET /playstore-keyword-ranking/{trackId}/{countryCode}/organic-keywords?date={date}

Request Parameters

Parameter	Description
`trackId`	(required) Track id of the app
`countryCode`	(required) Two letter country code
`date`	(required) YYYY-MM-DD formatted date

Response Fields

Field	Description
`trackId`	Track id of the app
`countryCode`	Two letter country code
`date`	Given date
`rankings`	List of keywords and their rankings

Example request

bash

curl "https://api.mobileaction.co/playstore-keyword-ranking/com.facebook.katana/US/organic-keywords?date=2019-06-13&token=YOUR_API_KEY"

Example response

json

{
  "trackId": "com.facebook.katana",
  "countryCode": "US",
  "date": 1560409200000,
  "rankings": [
    {
      "keyword": "fees",
      "rank": 1
    },
    {
      "keyword": "fase",
      "rank": 1
    },
    {
      "keyword": "gace",
      "rank": 1
    },
    {
      "keyword": "f",
      "rank": 1
    }
  ]
}

Provides a list of organic impression shares of a keyword for Google Play.

bash

GET /playstore-keyword-ranking/organic-impression-share/keyword/{keyword}/{countryCode}

Request Parameters

Parameter	Description
`keyword`	(required) Keyword
`countryCode`	(required) Two letter country code

Response Fields

Field	Description
`keyword`	Keyword
`countryCode`	Two letter country code
`date`	Given date
`keywordShares`	List of shareParameterId (unique trackId), dates and shares

Example request

bash

curl "https://api.mobileaction.co/playstore-keyword-ranking/organic-impression-share/keyword/health/US&token=YOUR_API_KEY"

Example response

json

{
  "keyword": "health",
  "countryCode": "US",
  "date": "2025-05-23",
  "keywordShares": [
    {
      "shareParameterId": "com.sec.android.app.shealth",
      "date": "2025-05-21",
      "share": 0.23349294670601428
    },
    {
      "shareParameterId": "com.google.android.apps.fitness",
      "date": "2025-05-21",
      "share": 0.11674647335300714
    },
    {
      "shareParameterId": "com.google.android.apps.healthdata",
      "date": "2025-05-21",
      "share": 0.07783098223533809
    },
    {
      "shareParameterId": "com.fitbit.FitbitMobile",
      "date": "2025-05-21",
      "share": 0.05837323667650357
    },
    {
      "shareParameterId": "com.myfitnesspal.android",
      "date": "2025-05-21",
      "share": 0.045141969696496094
    }
  ]
}

Provides the top categories of searched keyword is used in metadata of apps.

bash

GET /playstore-keyword-ranking/share-of-category/keyword/{keyword}/{countryCode}

Request Parameters

Parameter	Description
`keyword`	(required) Keyword
`countryCode`	(required) Two letter country code

Response Fields

Field	Description
`keyword`	Keyword
`countryCode`	Two letter country code
`date`	Given date
`keywordShares`	List of shareParameterId (category name), dates and shares

Example request

bash

curl "https://api.mobileaction.co/playstore-keyword-ranking/share-of-category/keyword/health/US&token=YOUR_API_KEY"

Example response

json

{
  "keyword": "health",
  "countryCode": "US",
  "date": "2025-05-23",
  "keywordShares": [
    {
      "shareParameterId": "HEALTH_AND_FITNESS",
      "date": "2025-05-21",
      "share": 0.9401125763097986
    },
    {
      "shareParameterId": "MEDICAL",
      "date": "2025-05-21",
      "share": 0.027550819988673574
    },
    {
      "shareParameterId": "SPORTS",
      "date": "2025-05-21",
      "share": 0.016078921511772315
    },
    {
      "shareParameterId": "LIFESTYLE",
      "date": "2025-05-21",
      "share": 0.013903196790981757
    },
    {
      "shareParameterId": "TOOLS",
      "date": "2025-05-21",
      "share": 0.0023544853987738485
    }
  ]
}

Keyword Services ​

Keyword Ranking ( 3 Credits / Request ) ​

Keyword History ( 10 Credits / Request ) ​

Top Keywords ( 20 Credits / Request ) ​

Keyword Metadata ( 5 Credits / Request ) ​

List of Apps ( 5 Credits / Request ) ​

Organic Keywords ( 50 Credits / Request ) ​

Organic Impression Share ( 20 Credits / Request ) ​

Share Of Category ( 5 Credits / Request ) ​

Keyword Services

Keyword Ranking ( 3 Credits / Request )

Keyword History ( 10 Credits / Request )

Top Keywords ( 20 Credits / Request )

Keyword Metadata ( 5 Credits / Request )

List of Apps ( 5 Credits / Request )

Organic Keywords ( 50 Credits / Request )

Organic Impression Share ( 20 Credits / Request )

Share Of Category ( 5 Credits / Request )