Keyword Search — Current​

GET
/keywords/top-apps

The apps that rank highest for a keyword — the search results a user sees. Use it to find the incumbents for a keyword.

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}$"
keyword*

A single search term.

Type
string
Required
Example"habit tracker"
limit

How many rows to return, up to 500.

Type
integer
Minimum
1
Maximum
500

Responses​

Successful response.

application/json
JSON
{
  
"status": 200,
  
"meta": {
  
  
"exec_time": 0.221,
  
  
"cache": false,
  
  
"count": 10
  
},
  
"data": {
  
  
"top_apps": [
  
  
  
{
  
  
  
  
"package": "com.google.android.apps.dynamite",
  
  
  
  
"title": "Google Chat",
  
  
  
  
"developer": "Google LLC",
  
  
  
  
"icon": "https://play-lh.googleusercontent.com/MfBDUGFOSiROvn2EpD2pPby2z-PwpXqX3QHfCfpaz_0_U1o6mJQxGLW0WrlLo847MvxDqo5fEF4MG2pzBbu9rw",
  
  
  
  
"rank": 1,
  
  
  
  
"refreshed_at": "2026-09-17"
  
  
  
},
  
  
  
{
  
  
  
  
"package": "com.openai.chatgpt",
  
  
  
  
"title": "ChatGPT",
  
  
  
  
"developer": "OpenAI",
  
  
  
  
"icon": "https://play-lh.googleusercontent.com/T9J8e9oxxPd600j_KPM4KK2GHfNpUpGBdTy8lHPXBXpOUfGusRuZXj0UMgFNrP8we6LVt9V-AibEgcLootE6VK4",
  
  
  
  
"rank": 2,
  
  
  
  
"refreshed_at": "2026-09-17"
  
  
  
},
  
  
  
{
  
  
  
  
"package": "com.snapchat.android",
  
  
  
  
"title": "Snapchat",
  
  
  
  
"developer": "Snap Inc",
  
  
  
  
"icon": "https://play-lh.googleusercontent.com/nOJWJoDAzuRSHmlFfpzHXAj8UbTJwk_JGYf0uAPTKPtiiIX_2Y7r5ATO1ZtxHRqaFTqfIDZ40PnBK4hukeJh",
  
  
  
  
"rank": 3,
  
  
  
  
"refreshed_at": "2026-09-17"
  
  
  
}
  
  
]
  
}
}

Samples​

Powered by VitePress OpenAPI