---
title: "Timing / momentum / lifecycle for a topic (rising vs peaking)."
method: GET
path: "/api/public/forecast"
tags: ["data"]
---

# Timing / momentum / lifecycle for a topic (rising vs peaking).

`GET /api/public/forecast`

## Request

- Base URL: `https://lolikai.com`
- URL: `https://lolikai.com/api/public/forecast`
- Auth: API key in header `x-lolik-api-key`

## Query parameters

- `q` string, required

## Response `200`

Success

- Envelope
  - `data` unknown, required
  - `confidence` 'observed' | 'aiEstimated' | 'pending', required
  - `credits_used` integer, required
  - `credits_remaining` integer, required

## Other responses

- `401`: Missing / invalid / revoked key
- `402`: Out of credits (carries credits_remaining + topup_url)
- `429`: Over a rate limit (scope: burst | daily | intel). Retry-After header set.

---

[API](https://skmtc.dev/lolikai/apis/lolik-intelligence-api.md) · [All operations](https://skmtc.dev/lolikai/apis/lolik-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lolikai/apis/lolik-intelligence-api/revisions/426a852610f9?raw)