Keyword Metrics by App — History: rank​

GET
/keywords/app/metrics/rankings/history

One app's rank for a keyword over time.

Authorizations​

bearerAuth

Your appmanai API key as a Bearer token.

Type
HTTP (bearer)

Parameters​

Query Parameters

store*

Which app store.

Type
string
Required
Valid values
"android""ios"
country*

Two-letter ISO country code. Case-insensitive.

Type
string
Required
Example"US"
Min Length
2
Max Length
2
Pattern
"^[A-Za-z]{2}$"
package*

App package / bundle id — com.discord on Android, a numeric id on iOS. Use /apps/search to resolve a name.

Type
string
Required
Example"com.discord"
keyword*

A single search term.

Type
string
Required
Example"habit tracker"
period

Window to report. Defaults to month.

Type
string
Valid values
"week""month""year"

Responses​

Successful response.

application/json
JSON
{
  
"status": 200,
  
"meta": {
  
  
"exec_time": 0.318,
  
  
"cache": false,
  
  
"count": 471
  
},
  
"data": {
  
  
"history": [
  
  
  
{
  
  
  
  
"time_plot": "2025-02-07",
  
  
  
  
"rank": 7
  
  
  
},
  
  
  
{
  
  
  
  
"time_plot": "2025-02-13",
  
  
  
  
"rank": 7
  
  
  
},
  
  
  
{
  
  
  
  
"time_plot": "2025-02-14",
  
  
  
  
"rank": 7
  
  
  
}
  
  
]
  
}
}

Samples​

Powered by VitePress OpenAPI