Skip to content

Search Ads Insights

This section describes Apple Search Ads insight services.

Provides paid keywords of SearchAds and their shares for the given app.

bash
GET /searchads-stats/paid-keywords/{trackId}/{countryCode}?date={date}

Request Parameters

ParameterDescription
trackId(required) Appstore track id of the app
countryCode(required) Two letter country code
date(required) YYYY-MM-DD formatted date, history start date, covers to 7 days prior

Response Fields

FieldDescription
trackIdAppstore track id of the app
sharesList of paid keywords and their shares

Example request

bash
curl "http://api.mobileaction.co/searchads-stats/paid-keywords/479516143/US?date=2019-06-13&token=YOUR_API_KEY"

Example response

json
{
  "trackId": 479516143,
  "shares": [
    {
      "keyword": "platoon",
      "appShare": 100
    },
    {
      "keyword": "flappy golf",
      "appShare": 100
    },
    {
      "keyword": "pokémon",
      "appShare": 100
    },
    {
      "keyword": "duck life",
      "appShare": 100
    },
    {
      "keyword": "rick and morty",
      "appShare": 100
    },
    {
      "keyword": "fnaf free",
      "appShare": 100
    }
  ]
}

Paying Apps ( 50 Credits / Request )

Provides the track ids and shares of apps paying for the given keyword.

bash
GET /searchads-stats/paying-apps/{countryCode}?keyword={keyword}&date={date}

Request Parameters

ParameterDescription
trackId(required) Appstore track id of the app
countryCode(required) Two letter country code
date(required) YYYY-MM-DD formatted date, history start date, covers to 7 days prior

Response Fields

FieldDescription
keywordGiven keyword
sharesList of paying apps' track ids and their shares

Example request

bash
curl "http://api.mobileaction.co/searchads-stats/paying-apps/US?keyword=game&date=2019-06-13&token=YOUR_API_KEY"

Example response

json
{
  "keyword": "game",
  "shares": [
    {
      "trackId": 1315531311,
      "share": 37.3913
    },
    {
      "trackId": 1142128785,
      "share": 28.69565
    },
    {
      "trackId": 1397824035,
      "share": 13.91304
    },
    {
      "trackId": 1268486152,
      "share": 6.08696
    },
    {
      "trackId": 1367054026,
      "share": 4.34783
    }
  ]
}