新词雷达 API
只读 REST API。其它应用按周期或按增量游标拉取;每个词条自带上下文、指标、关联资产和验证结果,调用方不用再查别处。
鉴权
登录后在 账户页 生成 key,每个请求带上请求头 Authorization: Bearer <key>。key 只存哈希,生成时只显示一次。默认每个 key 每分钟 60 次,响应头 X-RateLimit-Remaining 显示剩余次数;周期类接口带 ETag。
端点
| 方法与路径 | 用途 |
|---|---|
| GET /v1/cycles/latest | 最新周期概况:时间、各线和各市场产出数、花费 |
| GET /v1/cycles | 最近若干周期列表 |
| GET /v1/cycles/{cycle_id}/words | 某个周期新增和变化的词 |
| GET /v1/words | 条件查询:line market lang state stage type min_score updated_since sort cursor limit |
| GET /v1/words/{id} | 词条详情,include=contexts,history,assets,verifications,related |
| GET /v1/words/{id}/history | 各市场、各源的时间序列 |
| GET /v1/search?q= | 模糊查词,含译名和变体 |
| GET /v1/changes?after_seq=&line=&limit= | 增量变更流(推荐) |
| GET /v1/exports/{cycle_id}.jsonl | 整批导出 |
| GET /v1/meta/lines · /v1/meta/markets | 枚举值 |
| GET /v1/health | 健康检查 |
| GET /v1/public/latest | 公开预览(不需要 key,只有少量词和少量字段) |
增量同步
推荐用 /v1/changes。每条变更有单调递增的 seq,记住最后一个 seq,下次从这里接着取,不会漏;至少一次投递,按 seq 去重。变更类型: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) # 按 seq 去重 state.write_text(str(r["next_after_seq"]))
典型用法
- MEME 工具:
/v1/changes?line=social - 选品:
/v1/words?line=commodity&market=US,JP&state=confirmed - 建站:
/v1/words?line=seo&min_score=60&sort=lead - FDE 销售:
/v1/words?line=budget,rules
词条对象
{
"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
}
分页用游标:响应里的 next_cursor 原样传回 cursor 参数;limit 默认 50,最大 200。 OpenAPI / Swagger · openapi.json