新词雷达 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

凭邀请码注册,看完整数据