Skip to main content
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

NameTypeDefaultDescription
countrystringusISO country code (e.g. us, gb, de)
daysnumber7Trend window in days (1-30)
limitnumber50Max 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"

​
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

FieldTypeDescription
countrystringISO country code
periodstringTrend window (e.g. 7d, 14d, 30d)
keywordsTrendingKeyword[]Keywords sorted by growth percentage (descending)
totalnumberTotal trending keywords found (before limit)

​
TrendingKeyword

FieldTypeDescription
keywordstringThe keyword
growthPercentnumberPercentage growth in reach over the period
maxReachnumberMaximum reach (top app review count) in current window
currentReachnumberMost recent reach value
volumeScorenumber|nullEstimated search volume (0-100)
resultCountnumberNumber of apps returned by iTunes Search for this keyword
difficultynumber|nullRanking difficulty score (0-100)

​
How It Works

The trending algorithm compares keyword reach between two time windows:
  1. Current window: Last days days
  2. 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.
This endpoint requires background scraping data. Keywords are scraped daily via the scrape:keywords worker. New keywords can be added to the pipeline via POST /v1/keywords/track.

​
Caching

Results are cached for 30 minutes.

​
Errors

StatusCodeWhen
500INTERNAL_ERRORFailed to compute trends