Lolik API — Developer Docs

LolikAPI Docs

The Lolik Intelligence API

Live trend → money-ready brief, in one call. REST + MCP.

The intelligence layer for content agents: what's rising, why, and possible ways to monetize it. Every response is served from our aggregated cache — your call volume never touches an upstream provider's quota.

Sources: YouTube · Google Trends · News — updated daily. Live coverage numbers added soon.

Get your API key Quickstart

Quickstart

1. Get your key
We're in free beta. Create a free account (30 credits, no card), then generate keys under Account → API Keys (shown once).
2. Authenticate
Send your key in the x-lolik-api-key header on every request.

3. Make your first call

One credit, real data from the cache:

bash

curl -H "x-lolik-api-key: lk_live_xxx" \
  "https://lolikai.eu/api/public/trends?niche=AI"

4. Wire it into Claude (MCP)
Drop the Lolik MCP server into your config — see MCP Server.
5. Or call it from n8n / HTTP
Any HTTP client works — no SDK required. See n8n / HTTP.
6. Explore the endpoints
Nine endpoints, REST + MCP — jump to the reference.

Live Sample

A real response from GET /api/public/brief — today's data, regenerated at most hourly, not a canned example. Empty sections mean no data today: the API never pads with plausible filler.

json

{
  "data": {
    "date": "2026-07-10",
    "contract": "Every draft must carry at least one verifiable number from this brief. Empty sections mean no data today — never invent.",
    "alerts": [
      {
        "topic": "Not the answer that I expected...",
        "phase": "early",
        "creator": "Doctor Mike",
        "source": "youtube",
        "niche": "Health",
        "hookType": "plain",
        "velocity": 153945,
        "velocityUnit": "views/day",
        "acceleration": 975.6,
        "daysTracked": 13,
        "vaultScore": 87.5,
        "tier": "PRIME",
        "confidence": "medium",
        "url": "https://www.youtube.com/watch?v=sC15hZ9PMHY"
      },
      {
        "topic": "speed keyboard roblox escape",
        "phase": "early",
        "creator": "",
        "source": "radar-snapshots",
        "niche": "Tech",
        "hookType": null,
        "velocity": 40,
        "velocityUnit": "arbitrage-score-0-100",
        "acceleration": 7,
        "daysTracked": 7,
        "vaultScore": 58.5,
        "tier": "STRONG",
        "confidence": "medium",
        "url": null
      },
      {
        "topic": "captcha exe",
        "phase": "early",
        "creator": "",
        "source": "radar-snapshots",
        "niche": "Tech",
        "hookType": null,
        "velocity": 35,
        "velocityUnit": "arbitrage-score-0-100",
        "acceleration": 5,
        "daysTracked": 6,
        "vaultScore": 54.5,
        "tier": "STRONG",
        "confidence": "medium",
        "url": null
      }
    ],
    "receipts": [
      {
        "topic": "How The U.S. Uses Israel",
        "alertDate": "2026-07-09",
        "viewsFirst": 34480,
        "viewsLast": 54282,
        "growthPct": 57,
        "daysMeasured": 1,
        "phase": "peak_momentum"
      },
      {
        "topic": "How to Scale From $4M to $400M With Content You Already Have",
        "alertDate": "2026-07-09",
        "viewsFirst": 157492,
        "viewsLast": 202677,
        "growthPct": 29,
        "daysMeasured": 1,
        "phase": "peak_momentum"
      }
    ],
    "pattern": {
      "pattern": "struct:has_number",
      "kind": "structure",
      "hookType": null,
      "daysPresent": 21,
      "creatorsCount": 22,
      "strength": 93,
      "evidence": {
        "convergence": true,
        "persistence": true,
        "amplification": true
      }
    },
    "moment": {
      "topic": "kusumgar ipo",
      "source": "radar-snapshots",
      "url": null,
      "velocityPrev": 11,
      "velocityNow": 24,
      "ratio": 2.2
    },
    "transparency": {
      "alertsConsidered": 30,
      "alertsShown": 3,
      "excludedNotAccelerating": 0,
      "excludedBelowTopCut": 27,
      "note": "The sieve, in public: 'not accelerating' failed the quality bar at check time; 'below top cut' were accelerating but ranked under the daily top-N. Numbers add up to everything we considered."
    }
  },
  "confidence": "observed"
}

Shown: the data and confidence fields of the envelope. Calls made with a key also return credits_used and credits_remaining.

Authentication

Every request carries your key in the x-lolik-api-key header. Keys are prefixed lk_live_. There is no SDK to install — just the header.

bash

curl -H "x-lolik-api-key: lk_live_xxx" \
  "https://lolikai.eu/api/public/usage"

A missing, invalid or revoked key returns 401 unauthorized. Never commit your key; regenerate it if it leaks.

Credits & Pricing

Usage is metered per call against a single wallet shared with the Lolik web app. Data endpoints cost 1 credit; intelligence endpoints (opportunities, prebreakout, viral-patterns) cost 5 credits. /usage is free.

The free tier includes 30 credits, one-time, valid 14 days, no card. For plan prices see Pricing.

Reads are not free here — we serve our own aggregated data. Over a limit you get a 429, never a suspend.

Rate Limits

Limits are per plan. Over a limit returns 429 rate_limited with a Retry-After header — back off and retry.

Plan	Calls / day	Burst / min	Intelligence / day
Pro	500	30	20
Builder	5,000	120	60
Agency	50,000	600	200

We emit Retry-After and X-RateLimit-Tier. The intelligence cap is a stricter, separate daily limit for the heavy endpoints.

Base URLs

REST base: https://lolikai.eu/api/public/...

MCP: a local stdio server (scripts/mcp-server.mjs) — there is no remote MCP URL to point at.

Don't guess another host or scheme: the header is x-lolik-api-key (not Authorization: Bearer), and the only REST host is https://lolikai.eu.

MCP Server

The same endpoints are exposed as MCP tools so Claude (Desktop / Code) or Cursor can call them directly. The server is a thin wrapper over the REST API — same auth, credits and limits apply.

json

{
  "mcpServers": {
    "lolik": {
      "command": "npx",
      "args": ["-y", "@lolikai/mcp"],
      "env": {
        "LOLIK_API_KEY": "lk_live_your_key_here",
        "LOLIK_API_BASE_URL": "https://lolikai.eu"
      }
    }
  }
}

Requires Node 18+. Restart your client after editing the config.

Tool	What it does	Cost
`get_trends`	Top trending topics by niche.	1 cr
`forecast`	Timing / momentum / lifecycle for a topic.	1 cr
`virality_score`	Virality score + breakout probability + hook type.	1 cr
`get_news`	Freshest news stories.	1 cr
`opportunities`	Ranked opportunities + possible monetization.	5 cr
`prebreakout`	What's accelerating now, pre-peak.	5 cr
`get_brief`	Daily what-to-post brief: phased alerts + receipts + pattern + mover.	5 cr
`get_viral_patterns`	Validated viral patterns (what's working now).	5 cr
`rescue_hooks`	Hooks for your topic from live validated title patterns, with measured proof.	5 cr
`grade_draft`	Grade a draft title against this week's validated patterns (score math in code).	5 cr
`get_usage`	Credits + rate-limit status.	free
`lolik_content_brain`	One-call brief: trends + opportunities + forecast.	7 cr

n8n / HTTP

There's no official n8n node yet — use a generic HTTP Request node (n8n, Make, or any client). Set the method, URL and the API-key header:

text

Method:  GET
URL:     https://lolikai.eu/api/public/trends?niche=AI
Header:  x-lolik-api-key: lk_live_xxx

curl Examples

Every endpoint is a plain GET. Authenticate with the header, read JSON back:

bash

curl -H "x-lolik-api-key: lk_live_xxx" \
  "https://lolikai.eu/api/public/trends?niche=AI&source=google"

bash

curl -H "x-lolik-api-key: lk_live_xxx" \
  "https://lolikai.eu/api/public/opportunities?niche=Finance"

Endpoints

Nine endpoints. Standard envelope { data, confidence, credits_used, credits_remaining }; confidence is observed | aiEstimated | pending. Max 10 items per call — no pagination or bulk export by design.

GET /api/public/trends1 credit

Top trending topics from our aggregated cache.

Query parameters

nicheoptional · AI | Crypto | Tech | Finance | Business | Health— Filter to a niche.
sourceoptional · default google · google | youtube— Where the trend is measured.

bash

curl -H "x-lolik-api-key: lk_live_xxx" \
  "https://lolikai.eu/api/public/trends?niche=AI&source=google"

json

{
  "data": [
    {
      "title": "...",
      "source": "google",
      "niche": "AI",
      "viralScore": null,
      "searchVolume": "500000+",
      "views": null,
      "geos": ["US", "GB"],
      "publishedAt": "2026-06-20T..."
    }
  ],
  "confidence": "observed",
  "credits_used": 1,
  "credits_remaining": 486
}

GET /api/public/news1 credit

Freshest news stories from our cache.

Query parameters

topicoptional— Filter to a topic.

bash

curl -H "x-lolik-api-key: lk_live_xxx" \
  "https://lolikai.eu/api/public/news?topic=Tech"

json

{
  "data": [ { "title": "...", "url": "...", "source": "...", "publishedAt": "2026-06-21T..." } ],
  "confidence": "observed",
  "credits_used": 1,
  "credits_remaining": 485
}

GET /api/public/forecast1 credit

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

Query parameters

qrequired— Topic to forecast.

bash

curl -H "x-lolik-api-key: lk_live_xxx" \
  "https://lolikai.eu/api/public/forecast?q=ai%20agents"

json

{
  "data": {
    "query": "ai agents",
    "matchedTopic": "...",
    "momentum": "accelerating",
    "timing": "enter_now",
    "lifecycle": "growth",
    "breakoutProbability": 90,
    "acceleration": 3992,
    "accelTrend": "rising",
    "vaultScore": 80,
    "trajectory": [9380, 13372],
    "source": "vault"
  },
  "confidence": "observed",
  "credits_used": 1,
  "credits_remaining": 485
}

GET /api/public/virality-score1 credit

Virality score + breakout probability + hook type for a topic.

Query parameters

qrequired— Topic or title to score.

bash

curl -H "x-lolik-api-key: lk_live_xxx" \
  "https://lolikai.eu/api/public/virality-score?q=SEO%20is%20dead"

json

{
  "data": {
    "query": "SEO is dead",
    "matchedTopic": "...",
    "viral_score": 77,
    "breakoutProbability": 87,
    "hook_type": "bold_claim",
    "source": "vault"
  },
  "confidence": "observed",
  "credits_used": 1,
  "credits_remaining": 484
}

GET /api/public/opportunities5 credits · intelligence

Ranked opportunities with possible monetization paths.

Query parameters

nicheoptional— Filter to a niche.

bash

curl -H "x-lolik-api-key: lk_live_xxx" \
  "https://lolikai.eu/api/public/opportunities?niche=Finance"

json

{
  "data": [
    {
      "topic": "...",
      "niche": "Finance",
      "opportunityScore": 92,
      "demandScore": 98,
      "supplyScore": 7,
      "conviction": "HIGH",
      "opportunityType": "Video Gap",
      "possibleMonetization": [
        {
          "model": "Premium briefing / consulting",
          "basis": "estimate",
          "disclaimer": "Estimates based on available data — not a guarantee of income."
        }
      ]
    }
  ],
  "confidence": "observed",
  "credits_used": 5,
  "credits_remaining": 479
}

GET /api/public/brief5 credits · intelligence

The daily what-to-post brief: phase-labeled pre-breakout alerts + measured receipts + a validated pattern + the day's steepest mover.

Query parameters

nicheoptional— Filter to a niche.

bash

curl -H "x-lolik-api-key: lk_live_xxx" \
  "https://lolikai.eu/api/public/brief?niche=AI"

json

{
  "data": {
    "date": "2026-07-03",
    "contract": "Every draft must carry at least one verifiable number from this brief...",
    "alerts": [
      { "topic": "...", "phase": "early", "velocity": 13372, "acceleration": 3992, "niche": "AI" }
    ],
    "receipts": [
      { "topic": "...", "alertDate": "2026-07-01", "viewsFirst": 100000, "viewsLast": 180000, "growthPct": 80, "daysMeasured": 2 }
    ],
    "pattern": { "pattern": "hook:contrarian", "creatorsCount": 12, "daysPresent": 14, "strength": 88 },
    "moment": { "topic": "...", "velocityPrev": 5000, "velocityNow": 26000, "ratio": 5.2 }
  },
  "confidence": "observed",
  "credits_used": 5,
  "credits_remaining": 469
}

GET /api/public/hook-rescue5 credits · intelligence

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.

Query parameters

topicrequired— Your topic or working title (4-120 chars).

bash

curl -H "x-lolik-api-key: lk_live_xxx" \
  "https://lolikai.eu/api/public/hook-rescue?topic=AI%20agents%20for%20small%20business"

json

{
  "data": {
    "status": "ok",
    "topic": "AI agents for small business",
    "hooks": [
      { "text": "...", "pattern": "A number in the title", "proof": { "validated_across_creators": 4, "days_active": 5, "strength": 92 } }
    ],
    "note": "Hook text is AI-drafted; the proof next to each is measured from live data."
  },
  "confidence": "aiEstimated",
  "credits_used": 5,
  "credits_remaining": 464
}

GET /api/public/grade5 credits · intelligence

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).

Query parameters

draftrequired— Your draft title or hook (4-200 chars).

bash

curl -H "x-lolik-api-key: lk_live_xxx" \
  "https://lolikai.eu/api/public/grade?draft=I%20tested%205%20AI%20agents%20for%20a%20week"

json

{
  "data": {
    "status": "ok",
    "draft": "I tested 5 AI agents for a week",
    "score": 78,
    "verdict": "post_it",
    "components": [
      { "key": "pattern_validation", "points": 35, "max": 40, "basis": "measured", "proof": { "validated_across_creators": 4, "days_active": 5, "strength": 88 } },
      { "key": "hook_mechanics", "points": 22, "max": 30, "basis": "ai_judged" }
    ],
    "rewrites": [{ "text": "...", "pattern": "A number in the title", "proof": { "validated_across_creators": 4, "days_active": 5, "strength": 88 } }],
    "note": "Graded against this week's live validated patterns, not a static rubric."
  },
  "confidence": "aiEstimated",
  "credits_used": 5,
  "credits_remaining": 459
}

GET /api/public/prebreakout5 credits · intelligence

What's accelerating now, before it peaks — early-mover signal.

Query parameters

nicheoptional— Filter to a niche.

bash

curl -H "x-lolik-api-key: lk_live_xxx" \
  "https://lolikai.eu/api/public/prebreakout?niche=AI"

json

{
  "data": [
    {
      "topic": "...",
      "creator": "...",
      "source": "youtube",
      "niche": "AI",
      "hookType": "question",
      "velocity": 13372,
      "acceleration": 3992,
      "daysTracked": 2,
      "vaultScore": 80,
      "tier": "PRIME",
      "confidence": "low",
      "phase": "early"
    }
  ],
  "confidence": "observed",
  "credits_used": 5,
  "credits_remaining": 474
}

GET /api/public/viral-patterns5 credits · intelligence

Validated viral patterns (hook / structure) confirmed over time by convergence + persistence + amplification. The moat.

No parameters.

bash

curl -H "x-lolik-api-key: lk_live_xxx" \
  "https://lolikai.eu/api/public/viral-patterns"

json

{
  "data": [
    {
      "pattern": "hook:list_preview",
      "kind": "hook",
      "hookType": "list_preview",
      "daysPresent": 3,
      "creatorsCount": 4,
      "strength": 72,
      "evidence": { "convergence": true, "persistence": true, "amplification": true }
    }
  ],
  "confidence": "observed",
  "credits_used": 5,
  "credits_remaining": 469
}

GET /api/public/usageFree

Credits remaining + rate-limit status. Free — spends no credit or rate slot.

No parameters.

bash

curl -H "x-lolik-api-key: lk_live_xxx" \
  "https://lolikai.eu/api/public/usage"

json

{
  "tier": "pro",
  "credits_remaining": 487,
  "rate_limit": {
    "calls_today": 13,
    "daily_cap": 500,
    "calls_remaining": 487,
    "intel_calls_today": 2,
    "intel_daily_cap": 20,
    "burst_per_min": 30
  }
}

hook_type is one of: list_preview, question, before_after, confession, contrarian, story, statistic, empathy, bold_claim, plain. niche is one of: AI, Crypto, Tech, Finance, Business, Health.

Agent Playbook

Route the intent — pick the endpoint by the money question you're answering. Check /usage (free) before spending; intelligence calls cost 5 credits.

I want to…	Call	Cost
Find a business idea from what's rising now	`/api/public/opportunities`	5 cr
Check whether a niche is already saturated	`/api/public/viral-patterns`	5 cr
Catch a trend before it breaks out	`/api/public/prebreakout`	5 cr
Know what to post today (full daily brief)	`/api/public/brief`	5 cr
Score a title / idea for virality	`/api/public/virality-score`	1 cr
Fix a weak title (hooks from live validated patterns)	`/api/public/hook-rescue`	5 cr
Grade a draft before posting (against this week's validated patterns)	`/api/public/grade`	5 cr
See what's trending today	`/api/public/trends`	1 cr
Time your move on a topic (rising vs peaking)	`/api/public/forecast`	1 cr

Monetization figures are estimates, not guarantees of income.

llms.txt

A plain-text index for agents and MCP marketplaces lives at /llms.txt — it lists what the API does plus every endpoint and its cost.

OpenAPI

A machine-readable spec for the nine endpoints lives at /openapi.json (OpenAPI 3.1) — point your codegen or agent at it.

Troubleshooting

Errors are JSON with a stable error code:

Status	Code	Meaning
400	`invalid_input`	Input looked like a prompt-injection attempt.
400	`invalid_param`	Enumeration param (page/offset/export/cursor) or limit > 10.
401	`unauthorized`	Missing / invalid / revoked key.
402	`insufficient_credits`	Out of credits (carries topup_url).
429	`rate_limited`	Over a rate limit (scope: burst / daily / intel). Retry-After header set.
403	`usage_review`	Account flagged for review (rare).
500	`internal_error`	Server error.

Check your balance + limits any time with GET /api/public/usage — it's free.

Contact

Beta support is founder-led. Email us and we answer directly — no ticket queue, no bots.

contact@lolikai.eu