> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Keyword Demand Trend

> Market-heat snapshot for one keyword — how result count and top-app review velocity are changing.

```
GET /v1/keywords/demand-trend
```

Compares the *current* state of a keyword's SERP against the closest snapshot on or before today − N days:

* **`resultCountDelta`** — change in the number of apps Apple returns for the keyword. Rising = more competition entering the niche.
* **`reviewVelocity`** — average daily growth in the top app's review count over the window. A leader pulling away fast means a maturing market with a clear winner.
* **`trend`** — coarse bucket so you can sort dashboards by momentum without comparing raw deltas across keywords of different sizes.

***

## Query Parameters

| Name    | Type   | Required | Default  | Description                     |
| ------- | ------ | -------- | -------- | ------------------------------- |
| keyword | string | Yes      | —        | The keyword to analyse          |
| country | string | No       | `us`     | ISO 3166-1 alpha-2 storefront   |
| device  | string | No       | `iphone` | `iphone` or `ipad`              |
| days    | number | No       | `14`     | Comparison window in days, 3–90 |

***

## Response

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": {
    "keyword": "ai chat",
    "country": "us",
    "device": "iphone",
    "windowDays": 14,
    "current":  { "date": "2026-04-21", "resultCount": 248, "topAppReviews": 1840221 },
    "previous": { "date": "2026-04-07", "resultCount": 211, "topAppReviews": 1610115 },
    "resultCountDelta": 37,
    "resultCountChangePct": 17.5,
    "reviewVelocity": 16436,
    "reviewVelocityPct": 14.3,
    "trend": "rising",
    "hasFullWindow": true,
    "interpretation": "Result count +17.5%, leader reviews +14.3% — demand is expanding faster than the leader is consolidating."
  },
  "meta": {
    "lastScrapedAt": "2026-04-21T00:00:00Z",
    "dataAgeHours": 3,
    "source": "stored",
    "freshness": "fresh"
  }
}
```

`trend` values: `surging` · `rising` · `steady` · `cooling` · `declining`. Buckets are deliberately coarse so noise on small keywords doesn't flip the verdict day to day.

`hasFullWindow` is `false` when one of the snapshots is missing — usually for very new keywords with less than `days` of history.

`interpretation` is a short, plain-English summary of the bucket and the underlying deltas — safe to surface directly in a UI and useful for LLM agents that don't want to combine raw numbers.

The response-level `meta` envelope describes data freshness — see [Keyword Metrics → meta envelope](/docs/keyword-metrics#meta-envelope-response-level) for the full schema.

## Credit Cost

2 credits per request.

## Use Cases

* Filter keyword tracking dashboards by `trend = surging` to surface emerging niches.
* Pair with `/keywords/metrics` for "high opportunity + rising demand" lists.
* Trigger alerts when a keyword you rank for moves to `cooling`.