Keyword Services

This section describes AppStore related API services.

Keyword Ranking ( 3 Credits / Request )

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

bash

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

Request Parameters

Parameter	Description
`trackId`	(required) AppStore track id of the 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`	AppStore track id of app
`keyword`	Keyword
`countryCode`	Two letter country code
`date`	Date in epoch time format
`appKind`	IPHONE or IPAD
`rank`	Keyword ranking for current day

Example request

bash

curl "https://api.mobileaction.co/appstore-keyword-ranking/366562751/US/keywordrankings?keywords=ticket&token=YOUR_API_KEY"

Example response

json

[
  {
    "trackId": 366562751,
    "keyword": "ticket",
    "rank": 3,
    "countryCode": "US",
    "date": 1466060806000,
    "appKind": "IPHONE"
  },
  {
    "trackId": 366562751,
    "keyword": "ticket",
    "rank": 1,
    "countryCode": "US",
    "date": 1466060806000,
    "appKind": "IPAD"
  }
]

Keyword History ( 10 Credits / Request )

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

bash

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

Request Parameters

Parameter	Description
`trackId`	(required) AppStore track id of the app
`countryCode`	(required) Two letter country code
`keyword`	(required) Keyword to get ranking history
`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`	AppStore track id of app
`keyword`	Keyword
`countryCode`	Two letter country code
`date`	Date in epoch time format
`appKind`	IPHONE or IPAD
`rank`	Keyword ranking for current day

Example request

bash

curl "https://api.mobileaction.co/appstore-keyword-ranking/366562751/US/ticket/keywordrankings?startDate=2017-01-01&endDate=2017-01-15&token=YOUR_API_KEY"

Example response

json

[
  {
    "trackId": 366562751,
    "keyword": "ticket",
    "rank": 3,
    "countryCode": "US",
    "date": 1466060806000,
    "appKind": "IPHONE"
  },
  {
    "trackId": 366562751,
    "keyword": "ticket",
    "rank": 1,
    "countryCode": "US",
    "date": 1466060806000,
    "appKind": "IPAD"
  }
]

Top Keywords ( 20 Credits / Request )

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

bash

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

Request Parameters

Parameter	Description
`trackId`	(required) AppStore track id of the app
`countryCode`	(required) Two letter country code
`date`	(required) YYYY-MM-DD formatted date
`device`	(optional) Device type(IPHONE, IPAD), IPHONE is used if omitted
`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/appstore-keyword-ranking/284882215/US/top-keywords?date=2018-06-26&device=IPAD&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 AppStore.

bash

GET /appstore-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
`numberOfIpadApps`	Number of IPAD apps
`numberOfIphoneApps`	Number of IPHONE apps
`searchVolume`	Search Volume
`ownIphoneChance`	IPHONE Chance
`ownIpadChance`	IPAD Chance
`popularity`	Search Ads Popularity Score
`brandApp`	Brand app track id

Example request

bash

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

Example response

json

{
  "keyword": "whatsapp",
  "countryCode": "US",
  "numberOfIpadApps": 610,
  "numberOfIphoneApps": 968,
  "searchVolume": 61.0,
  "ownIphoneChance": 38.4,
  "ownIpadChance": 37.7,
  "popularity": 87,
  "brandApp": 310633997
}

List of Apps ( 5 Credits / Request )

Provides app list for given keyword for AppStore.

bash

GET /appstore-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
`iphoneApps`	List of track id for IPHONE apps
`ipadApps`	List of track id for IPAD apps

Example request

bash

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

Example response

json

{
  "keyword": "twitter",
  "countryCode": "US",
  "lastUpdateDate": 1535703195000,
  "iphoneApps": [
    333903271,
    972909677,
    1018355599,
    580311103,
    420792544,
    426026150,
    286756410,
    396050119,
    341249709,
    528626975,
    1003751089,
    1114106691
  ],
  "ipadApps": [
    333903271,
    1018355599,
    580311103,
    420792544,
    286756410,
    341249709,
    528626975,
    972909677,
    1207818210,
    1222206149,
    523005640,
    468155091,
    1350019098,
    1136209740,
    1296056912
  ]
}

Organic Keywords ( 50 Credits / Request )

Provides organic keywords and their rankings for given app in appstore.

bash

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

Request Parameters

Parameter	Description
`trackId`	(required) Track id of the app
`countryCode`	(required) Two letter country code
`device`	(required) Device type (IPHONE, IPAD)
`date`	(required) YYYY-MM-DD formatted date

Response Fields

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

Example request

bash

curl "https://api.mobileaction.co/appstore-keyword-ranking/1194582243/US/IPHONE/organic-keywords?date=2019-06-13&token=YOUR_API_KEY

Example response

json

{
  "trackId": 1194582243,
  "countryCode": "US",
  "deviceType": "IPHONE",
  "date": 1560409200000,
  "rankings": [
    {
      "keyword": "optimizador",
      "rank": 1
    },
    {
      "keyword": "smart phones",
      "rank": 1
    },
    {
      "keyword": "all smart",
      "rank": 1
    },
    {
      "keyword": "clean sweep",
      "rank": 1
    }
  ]
}

Provides a list of organic impression shares of a keyword for App Store.

bash

GET /appstore-keyword-ranking/organic-impression-share/keyword/{keyword}/{countryCode}/{device}

Request Parameters

Parameter	Description
`keyword`	(required) Keyword
`countryCode`	(required) Two letter country code
`device`	(required) Device type (IPHONE, IPAD)

Response Fields

Field	Description
`keyword`	Keyword
`countryCode`	Two letter country code
`date`	Given date
`keywordShares`	A list containing shareParameterId values (each a unique trackId used to identify and track individual app), along with the corresponding dates of sharing and the share ratios.

Example request

bash

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

Example response

json

{
  "keyword": "health",
  "countryCode": "US",
  "device": "IPHONE",
  "date": "2025-05-23",
  "keywordShares": [
    {
      "shareParameterId": 1242545199,
      "date": "2025-05-19",
      "share": 0.2236564188064727
    },
    {
      "shareParameterId": 1208224953,
      "date": "2025-05-19",
      "share": 0.11182820940323634
    },
    {
      "shareParameterId": 1020452064,
      "date": "2025-05-19",
      "share": 0.07455213960215756
    },
    {
      "shareParameterId": 1037595083,
      "date": "2025-05-19",
      "share": 0.05591410470161817
    },
    {
      "shareParameterId": 341232718,
      "date": "2025-05-19",
      "share": 0.04473128376129454
    },
    {
      "shareParameterId": 382952264,
      "date": "2025-05-19",
      "share": 0.034790998481006856
    }
  ]
}

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

bash

GET /appstore-keyword-ranking/share-of-category/keyword/{keyword}/{countryCode}/{device}

Request Parameters

Parameter	Description
`keyword`	(required) Keyword
`countryCode`	(required) Two letter country code
`device`	(required) Device type (IPHONE, IPAD)

Response Fields

Field	Description
`keyword`	Keyword
`countryCode`	Two letter country code
`date`	Given date
`keywordShares`	A list containing shareParameterId values (each a unique categoryId and it can be checked via https://app.mobileaction.co/api/introduction#app-store-categories), along with the corresponding dates of sharing and the share ratios.

Example request

bash

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

Example response

json

{
  "keyword": "health",
  "countryCode": "US",
  "device": "IPHONE",
  "date": "2025-05-23",
  "keywordShares": [
    {
      "shareParameterId": 6013,
      "date": "2025-05-19",
      "share": 0.910800859088774
    },
    {
      "shareParameterId": 6012,
      "date": "2025-05-19",
      "share": 0.309748353486552
    },
    {
      "shareParameterId": 6020,
      "date": "2025-05-19",
      "share": 0.21420732305479848
    },
    {
      "shareParameterId": 6007,
      "date": "2025-05-19",
      "share": 0.05034152052933569
    },
    {
      "shareParameterId": 6023,
      "date": "2025-05-19",
      "share": 0.04473128376129454
    },
    {
      "shareParameterId": 6002,
      "date": "2025-05-19",
      "share": 0.03791395934220994
    },
    {
      "shareParameterId": 6017,
      "date": "2025-05-19",
      "share": 0.004956510041529647
    }
  ]
}

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 )