Keywords Rankings for Applications

GET 1 Credit / Keyword / Application / 30 days /ios/keywords/app-rankings.json

The keywords rankings for Applications allow you to get the 90 days rankings for one or several applications for a keywords list. We compute the position of the apps for each keyword on a best effort basis and the list may thus be incomplete or even empty. However, once an App Keyword Ranking is performed asking for data for a specifi keyword, the keyword is flagged in our system and fetched once a day. Subsequent calls for the same keyword should thus yield complete results.

Note that the default selected period is for 90 days, but you can provide your date range in order to extend the targetted period.

Keywords Rankings for Applications Request

This method returns the rankings for the provided keywords.

Header parameters
X-AppTweak-Key:
Your AppTweak API Key.
Query parameters
applications: string 284882215,389801252 Required

A url encoded comma separated list of application IDs you wish to fetch rankings on. We allow a maximum of 5 applications per query.

country: string us

The two letter country code (ISO Alpha-2) you want to fetch the app in.

us. Get the list of our country codes, here.

device: string iphone

The device you want to fetch the application for.

iphone or ipad

keywords: string toon,pop,blast,cubes Required

A url encoded comma separated list of keywords you wish to fetch stats on. We allow a maximum of 10 keywords per query.

language: string en

The two letter language (ISO Alpha-2) you want to fetch the application in.

en. Get the list of our language codes, here.

start_date: date

Start date, format: YYYY-MM-DD

end_date: date

End date, format: YYYY-MM-DD

GET /ios/keywords/app-rankings.json

Request example
GET /ios/keywords/app-rankings.json?country=us&language=us&device=iphone&keywords=photo,friend,share,free%20app&applications=284882215,389801252&start_date=2018-12-01&end_date=2018-12-10
cURL example
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" https://api.apptweak.com/ios/keywords/app-rankings.json?country=us&language=us&device=iphone&keywords=photo,friend,share,free%20app&applications=284882215,389801252&start_date=2018-12-01&end_date=2018-12-10

Keywords Rankings for Applications Response

The response is a JSON object. Each key of the object is one of the provided keyword, the matching value is a ranking object holding the ranks and the dates per application.

Object properties
end_date: datetime

The date of the last integer of the ranks array.

ranks: hash

Key/value pair containing an ordered list of integer giving the position of each targetted app in the search result of the keyword between start_date and end_date. Lower is better. null indicates that the app was not found in the chart on the matching day.

start_date: datetime

The date of the first integer of the ranks array.

total_size: array

An ordered list of integer giving the total number of applications for which the rankings have been calculated between start_date and end_date.

Response Example

{
  "content": {
    "friend": {
      "ranks": {
        "284882215": [
          12,
          22,
          13,
          22,
          12,
          20,
          12,
          13,
          13,
          13
        ],
        "389801252": [
          4,
          5,
          4,
          5,
          4,
          5,
          4,
          4,
          4,
          4
        ]
      },
      "total_size": [
        23621,
        23899,
        23637,
        23934,
        23665,
        23968,
        23718,
        23739,
        23749,
        23765
      ],
      "start_date": "2018-12-01 00:00:00 +0000",
      "end_date": "2018-12-10 00:00:00 +0000"
    }
  },
  "metadata": {
    "request": {
      "path": "/ios/keywords/app-rankings.json",
      "store": "ios",
      "params": {
        "country": "us",
        "language": "us",
        "device": "iphone",
        "keywords": "photo,friend,share,free app",
        "applications": "284882215,389801252",
        "start_date": "2018-12-01T00:00:00+00:00",
        "end_date": "2018-12-10T00:00:00+00:00",
        "format": "json"
      },
      "performed_at": "2018-12-11 16:23:56 UTC"
    },
    "content": {
    }
  }
}