> ## 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.

# Emerging Suggestions

> Apple autocomplete suggestions that just started surfacing — early-warning trend signal.

```
GET /v1/keywords/suggestions/emerging
```

Returns suggestions that appeared in Apple's autocomplete during the last `recentDays` window but were absent in the prior `baselineDays` window. These are the rawest possible early-trend signal — Apple has decided users are searching for these terms often enough to recommend them, but they're new enough that no one has built tracking around them yet.

***

## Query Parameters

| Name         | Type   | Required | Default | Description                          |
| ------------ | ------ | -------- | ------- | ------------------------------------ |
| country      | string | No       | `us`    | ISO 3166-1 alpha-2 storefront        |
| recentDays   | number | No       | `7`     | Recent window, 1–30                  |
| baselineDays | number | No       | `30`    | Baseline window before recent, 7–180 |
| limit        | number | No       | `50`    | Max suggestions returned, 1–200      |

`recentDays` must be smaller than `baselineDays`.

***

## Response

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": {
    "country": "us",
    "recentDays": 7,
    "baselineDays": 30,
    "asOf": "2026-04-21",
    "total": 17,
    "suggestions": [
      {
        "suggestion": "claude code",
        "firstSeenAt": "2026-04-16",
        "bestRank": 2,
        "prefixes": ["c", "cl", "claude"],
        "appearanceCount": 12
      },
      {
        "suggestion": "ai vibes",
        "firstSeenAt": "2026-04-18",
        "bestRank": 6,
        "prefixes": ["a", "ai"],
        "appearanceCount": 6
      }
    ],
    "interpretation": "17 new autocomplete suggestions surfaced in US in the last 7d (none in the prior 30d). Top mover: 'claude code' (best rank 2, 12 impressions)."
  },
  "meta": {
    "lastScrapedAt": "2026-04-21T00:00:00Z",
    "dataAgeHours": 4,
    "source": "stored",
    "freshness": "fresh"
  }
}
```

`interpretation` is a one-line plain-English summary that names the strongest emerging mover — handy for daily digest UIs and LLM agents.

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

Suggestions are sorted by `appearanceCount` desc → `bestRank` asc → `firstSeenAt` desc, so the top of the list is the strongest combination of "many times observed" + "high in Apple's list" + "still surfacing recently".

## Credit Cost

3 credits per request.

## Use Cases

* Daily "trend radar" feed for ASO teams.
* Auto-track newly-emerging suggestions before competitors catch on.
* Pair with `/keywords/metrics` to filter for emerging + low-difficulty opportunities.