# Lolik Intelligence API

> Live trend → money-ready brief, in one call. REST + MCP. What's rising, why, and
> possible ways to monetize it — served from our aggregated cache, so your call
> volume never touches an upstream provider's quota.

## Basics
- Base URL: https://lolikai.eu/api/public
- Auth: header `x-lolik-api-key: lk_live_...` (no Authorization: Bearer, no SDK)
- Envelope: { data, confidence, credits_used, credits_remaining }; confidence = observed | aiEstimated | pending
- Max 10 items per call. No pagination or bulk export by design.
- Credits: data endpoints = 1, intelligence endpoints = 5, /usage = free.

## Endpoints
- GET /api/public/trends — Top trending topics from our aggregated cache. [1 credit] (params: niche, source)
- GET /api/public/news — Freshest news stories from our cache. [1 credit] (params: topic)
- GET /api/public/forecast — Timing / momentum / lifecycle for a topic (rising vs peaking). [1 credit] (params: q*)
- GET /api/public/virality-score — Virality score + breakout probability + hook type for a topic. [1 credit] (params: q*)
- GET /api/public/opportunities — Ranked opportunities with possible monetization paths. [5 credits] (params: niche)
- GET /api/public/brief — The daily what-to-post brief: phase-labeled pre-breakout alerts + measured receipts + a validated pattern + the day's steepest mover. [5 credits] (params: niche)
- GET /api/public/hook-rescue — Hooks for your topic, anchored in the title patterns currently VALIDATED across creators (live data, not a static list). Hook text is AI-drafted; the proof next to each is measured. [5 credits] (params: topic*)
- GET /api/public/grade — Grade a draft title/hook against the patterns currently VALIDATED in live data — this week's data, not a static rubric. Score math runs in code; every component states its basis (measured / ai_judged / rule). [5 credits] (params: draft*)
- GET /api/public/prebreakout — What's accelerating now, before it peaks — early-mover signal. [5 credits] (params: niche)
- GET /api/public/viral-patterns — Validated viral patterns (hook / structure) confirmed over time by convergence + persistence + amplification. The moat. [5 credits]
- GET /api/public/usage — Credits remaining + rate-limit status. Free — spends no credit or rate slot. [free]

## Docs
- Developer docs: https://lolikai.eu/developers
- OpenAPI: https://lolikai.eu/openapi.json
- MCP: `npx -y @lolikai/mcp` (npm package, stdio, 12 tools) — no remote MCP URL yet. Setup: https://lolikai.eu/mcp
- Claude Skills (free): https://lolikai.eu/skills — SKILL.md at /skills/lolik-daily-brief/SKILL.md and /skills/lolik-what-to-post/SKILL.md

## Notes
- Redistribution / resale of raw responses is prohibited (X-Lolik-ToS header).
- Monetization figures are estimates, not guarantees of income.