Keyword Suggestion History

GET /v1/keywords/suggestions/history

{
  "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 }
    ],
    "trend": {
      "direction": "promoted",
      "startRank": 9,
      "endRank": 3,
      "rankImprovement": 6,
      "newPrefixes": ["ai c"]
    },
    "interpretation": "Apple promoted 'ai chat' from rank 9 to rank 3 — strong demand signal. New prefix coverage: ai c."
  },
  "meta": {
    "lastScrapedAt": "2026-04-21T00:00:00Z",
    "dataAgeHours": 4,
    "source": "stored",
    "freshness": "fresh"
  }
}