New Word Radar API
A read-only REST API. Pull by cycle or by incremental cursor; each word object carries its context, metrics, linked assets and verification results, so you never need a second lookup.
Authentication
Sign in and create a key on your account page, then send Authorization: Bearer <key> with every request. Keys are stored hashed and shown only once. Each key gets 60 requests per minute by default (see X-RateLimit-Remaining); cycle endpoints send ETags.
Endpoints
| Method & path | Purpose |
|---|---|
| GET /v1/cycles/latest | Latest cycle: time, output per line and market, cost |
| GET /v1/cycles | Recent cycles |
| GET /v1/cycles/{cycle_id}/words | Words added or changed in a cycle |
| GET /v1/words | Filtered query: line market lang state stage type min_score updated_since sort cursor limit |
| GET /v1/words/{id} | Word detail, include=contexts,history,assets,verifications,related |
| GET /v1/words/{id}/history | Time series per market and source |
| GET /v1/search?q= | Fuzzy search incl. translations and variants |
| GET /v1/changes?after_seq=&line=&limit= | Incremental change stream (recommended) |
| GET /v1/exports/{cycle_id}.jsonl | Batch export |
| GET /v1/meta/lines · /v1/meta/markets | Enumerations |
| GET /v1/health | Health check |
| GET /v1/public/latest | Public preview (no key; a few words, few fields) |
Incremental sync
Use /v1/changes. Each change has a monotonically increasing seq; remember the last one and continue from it next time — nothing is missed. Delivery is at-least-once; de-duplicate by seq. Change types: new, state, score, context, asset.
# Python import requests, json, pathlib state = pathlib.Path("loudfm_seq.txt") seq = int(state.read_text()) if state.exists() else 0 r = requests.get("https://loud.fm/v1/changes", params={"after_seq": seq, "line": "social", "limit": 500}, headers={"Authorization": "Bearer " + KEY}, timeout=30).json() for ch in r["changes"]: handle(ch) # de-duplicate by seq state.write_text(str(r["next_after_seq"]))
Typical queries
- Meme tools:
/v1/changes?line=social - Product research:
/v1/words?line=commodity&market=US,JP&state=confirmed - Site building:
/v1/words?line=seo&min_score=60&sort=lead - Public-sector sales:
/v1/words?line=budget,rules
Word object
{
"id": "w_8f3k2…", "surface": "examplecoin", "normalized": "examplecoin", "lang": "en",
"lines": ["social", "seo"], "markets": ["US", "JP"],
"state": "watching", "stage": "spreading", "type": "product_or_model_name",
"definition": "…", "why": "…", "score": 74,
"score_breakdown": {"novelty": 0.9, "velocity": 0.7, "spread": 0.6, "consensus": 0.8, "intent": 0.4,
"demand": 0.3, "competition": 0.7, "monetization": 0.2, "lead": 0.8},
"first_seen_at": "2026-10-31T02:10:00Z", "last_seen_at": "2026-10-31T06:00:00Z",
"metrics": {"mentions_24h": 120, "platforms": 3, "domain_consensus_72h": 4, "token_count_24h": 2, "trend_vs_anchor": 0.35},
"contexts": [{"source": "x_keyword_search", "market": "US", "lang": "en", "url": "https://…", "snippet": "≤ 200 chars", "captured_at": "…"}],
"assets": {"domains": ["…"], "tokens": [{"chain": "solana", "address": "…", "symbol": "…"}], "asins": [], "filings": []},
"related": {"parent": null, "children": [{"keyword": "examplecoin price"}], "aliases": [{"lang": "ja", "text": "…"}]},
"verifications": [{"provider": "dataforseo", "check": "google_trends", "market": "US", "checked_at": "…", "result": {}}],
"cycle_id": "c_20261031_04", "private": null
}
Pagination is cursor-based: pass next_cursor back as cursor; limit defaults to 50, max 200. OpenAPI / Swagger · openapi.json