Skip to main content
GET /v1/keywords/suggestions/history
For one suggestion (e.g. "ai chat"), returns the per-day record of every prefix that surfaced it in Apple’s autocomplete, plus the best rank Apple placed it in. Use this to confirm whether a suggestion is sticky or a one-day flicker, and to understand which prefix paths users follow to discover it.

​
Query Parameters

NameTypeRequiredDefaultDescription
suggestionstringYes—Exact autocomplete suggestion
countrystringNousISO 3166-1 alpha-2 storefront
daysnumberNo30Lookback window in days, 3–180

​
Response

{
  "ok": true,
  "data": {
    "suggestion": "ai chat",
    "country": "us",
    "windowDays": 30,
    "firstSeen": "2026-04-04",
    "lastSeen": "2026-04-21",
    "isCurrentlyVisible": true,
    "series": [
      { "date": "2026-04-04", "bestRank": 9, "prefixes": ["a", "ai"], "appearances": 2 },
      { "date": "2026-04-05", "bestRank": 7, "prefixes": ["a", "ai", "ai "], "appearances": 3 },
      { "date": "2026-04-21", "bestRank": 3, "prefixes": ["a", "ai", "ai c"], "appearances": 4 }
    ]
  }
}
isCurrentlyVisible is true when the suggestion appeared in today’s snapshot — a quick way to confirm whether the trend is still live before acting on it.

​
Credit Cost

2 credits per request.

​
Use Cases

  • Decide whether to invest in ranking for a suggestion based on its history (sticky vs one-off).
  • Detect when a previously-strong suggestion stops being surfaced (signal of changing search behaviour).
  • Build a “discovery path” view: which prefixes users type to reach the suggestion.