Trending Keywords

GET /v1/keywords/trending

Returns keywords whose reach (measured by the top-ranking app’s review count) has grown the most over a given period. Use this to identify rising search trends and high-momentum keywords for ASO.

Query Parameters

Name	Type	Default	Description
platform	string	`apple`	`apple` (default) or `google` for Google Play — see Platforms
country	string	`us`	ISO country code (e.g. `us`, `gb`, `de`)
days	number	`7`	Trend window in days (1-30)
limit	number	`50`	Max keywords to return (1-100)

Examples

curl "https://api.appeeky.com/v1/keywords/trending?country=us&days=7&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

const res = await fetch(
  "https://api.appeeky.com/v1/keywords/trending?country=us&days=7&limit=10",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const { data } = await res.json();
console.log(`${data.total} trending keywords in ${data.period}`);
for (const kw of data.keywords) {
  console.log(`${kw.keyword}: +${kw.growthPercent}% growth`);
}

import requests

res = requests.get(
    "https://api.appeeky.com/v1/keywords/trending",
    params={"country": "us", "days": 7, "limit": 10},
    headers={"X-API-Key": "YOUR_API_KEY"},
)
data = res.json()["data"]
for kw in data["keywords"]:
    print(f"{kw['keyword']}: +{kw['growthPercent']}% (vol={kw['volumeScore']})")

Response

{
  "data": {
    "country": "us",
    "period": "7d",
    "keywords": [
      {
        "keyword": "xai",
        "growthPercent": 330.5,
        "maxReach": 10509533,
        "currentReach": 10509533,
        "volumeScore": 86,
        "resultCount": 42,
        "difficulty": 88
      },
      {
        "keyword": "meditation",
        "growthPercent": 145.2,
        "maxReach": 3814828,
        "currentReach": 3814828,
        "volumeScore": 72,
        "resultCount": 48,
        "difficulty": 65
      }
    ],
    "total": 77
  }
}

Response Fields

Top Level

Field	Type	Description
`country`	string	ISO country code
`period`	string	Trend window (e.g. `7d`, `14d`, `30d`)
`keywords`	TrendingKeyword[]	Keywords sorted by growth percentage (descending)
`total`	number	Total trending keywords found (before limit)

TrendingKeyword

Field	Type	Description
`keyword`	string	The keyword
`growthPercent`	number	Percentage growth in reach over the period
`maxReach`	number	Maximum reach (top app review count) in current window
`currentReach`	number	Most recent reach value
`volumeScore`	number\|null	Estimated search volume (0-100)
`resultCount`	number	Number of apps returned by iTunes Search for this keyword
`difficulty`	number\|null	Ranking difficulty score (0-100)

How It Works

The trending algorithm compares keyword reach between two time windows:

Current window: Last days days
Previous window: The days before that

Reach is measured by top_app_reviews — the review count of the #1 ranking app for each keyword. This is a strong proxy for keyword popularity because high-traffic keywords attract apps with large user bases. A keyword is “trending” when its max reach in the current window exceeds the previous window. The growth percentage is: (current - previous) / previous × 100.

Trending data is computed from the tracked keyword set. Add new keywords with POST /v1/keywords/track to expand coverage.

Errors

Status	Code	When
500	INTERNAL_ERROR	Failed to compute trends

Getting Started

Apps

My Data - Appeeky Web

Keywords

ASO Tools

AI Visibility

Search & Discovery

Market Intelligence

RevenueCat

App Store Connect

Google Play Console

Apple Search Ads

Growth Channels

Reference

Query Parameters

Examples

Response

Response Fields

Top Level

TrendingKeyword

How It Works

Errors

​Query Parameters

​Examples

​Response

​Response Fields

​Top Level

​TrendingKeyword

​How It Works

​Errors

Query Parameters

Examples

Response

Response Fields

Top Level

TrendingKeyword

How It Works

Errors