# 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.com/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](https://lolikai.com/api/public/trends): Top trending topics from our aggregated cache. [1 credit] (params: niche, source)
- [GET /api/public/news](https://lolikai.com/api/public/news): Freshest news stories from our cache. [1 credit] (params: topic)
- [GET /api/public/forecast](https://lolikai.com/api/public/forecast): Timing / momentum / lifecycle for a topic (rising vs peaking). [1 credit] (params: q*)
- [GET /api/public/virality-score](https://lolikai.com/api/public/virality-score): Virality score + breakout probability + hook type for a topic. [1 credit] (params: q*)
- [GET /api/public/opportunities](https://lolikai.com/api/public/opportunities): Ranked opportunities with possible monetization paths. [5 credits] (params: niche)
- [GET /api/public/brief](https://lolikai.com/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](https://lolikai.com/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](https://lolikai.com/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](https://lolikai.com/api/public/prebreakout): What's accelerating now, before it peaks — early-mover signal. [5 credits] (params: niche)
- [GET /api/public/viral-patterns](https://lolikai.com/api/public/viral-patterns): Validated viral patterns (hook / structure) confirmed over time by convergence + persistence + amplification. The moat. [5 credits]
- [GET /api/public/usage](https://lolikai.com/api/public/usage): Credits remaining + rate-limit status. Free — spends no credit or rate slot. [free]

## Docs
- [Developer docs](https://lolikai.com/developers): full API reference — quickstart, auth, endpoints, credits, rate limits
- [OpenAPI spec](https://lolikai.com/openapi.json): machine-readable schema of every public endpoint
- [MCP setup](https://lolikai.com/mcp): `npx -y @lolikai/mcp` (npm package, stdio, 12 tools) — no remote MCP URL yet
- [Claude Skills](https://lolikai.com/skills): free skills, no signup
- [lolik-daily-brief SKILL.md](https://lolikai.com/skills/lolik-daily-brief/SKILL.md): the daily what-to-post brief as a Claude Skill
- [lolik-what-to-post SKILL.md](https://lolikai.com/skills/lolik-what-to-post/SKILL.md): "what should I post today" as a Claude Skill

## Pages
- [Homepage](https://lolikai.com/): what Lolik is — trend intelligence with honest confidence scores, free beta (30 credits, no card), paid from $19/mo
- [Features](https://lolikai.com/features): every live capability (feeds, AI breakdowns, Opportunity Radar, alerts), honest status included
- [Pricing](https://lolikai.com/pricing): real plans and what each buys (credits + API throughput); no hidden numbers
- [Receipts](https://lolikai.com/receipts): PUBLIC prediction log — every alert timestamped and re-measured, wins AND misses
- [Methodology](https://lolikai.com/methodology): where the data comes from and how far to trust it
- [Free tools](https://lolikai.com/free): no signup — hashtag radar, early checker, hook patterns, today's top opportunity
- [What to post](https://lolikai.com/what-to-post): "I don't know what to post" answered from measured signals
- [For journalists](https://lolikai.com/for-journalists): editorial intelligence — story lifecycle, coverage gap, honest confidence
- [Build](https://lolikai.com/build): API overview for builders
- [FAQ](https://lolikai.com/faq): costs, sources, what we promise (and don't)

## Notes
- Redistribution / resale of raw responses is prohibited (X-Lolik-ToS header).
- Monetization figures are estimates, not guarantees of income.
- [llms-full.txt](https://lolikai.com/llms-full.txt): full plain-text version of the public pages

## Optional
- [Privacy](https://lolikai.com/privacy): what we collect and never do
- [Terms](https://lolikai.com/terms): terms of service