API PlatformBuild with AIPersona
专为 Openclaw 设计的
推特和 Reddit 自动化 API
面向自动化工作流：用统一的 Key 管理、稳定的限流策略与清晰的计费规则，把 Twitter 与 Reddit 的选题/爆款学习/内容生产接到 Openclaw。
一把钥匙，直接调用
通过 API Key 鉴权，几行代码完成接入。支持 x-api-key / Authorization Bearer。
透明计费与成本控制
按次扣费（credits），响应里返回 requestId/扣费信息，便于对账与追踪。
生产级限流与保护
429 + Retry-After + x-ratelimit-*，同时支持 IP 与 Key 两级保护。
面向工作流的输出
返回 tweetUrl/内容/发布时间/score，适配内容创作、选题与工作流编排。
Quick Start
Twitter + Reddit
curl-twitter.sh
curl -sS \
-H "x-api-key: $VIRALPOST_API_KEY" \
"https://aipersona.web/api/public/viralpost/recommendations?username=elonmusk&period=today&limit=10"curl-reddit.sh
curl -sS \
-H "x-api-key: $REDDIT_RANKER_API_KEY" \
"https://aipersona.web/api/reddit-ranker?keyword=ai%20agents&maxPosts=20&maxSubreddits=8"node.mjs
const url = new URL("https://aipersona.web/api/public/viralpost/recommendations");
url.searchParams.set("username", "elonmusk");
url.searchParams.set("period", "today");
url.searchParams.set("limit", "10");
const res = await fetch(url, { headers: { "x-api-key": process.env.VIRALPOST_API_KEY } });
const data = await res.json();
console.log(data.requestId, data.count);429 时请遵循 Retry-After；建议对相同输入做短 TTL 缓存以降低重试与重复扣费风险。
API Catalog
我们有的 API
Openclaw
给 Openclaw 的接入方式
Latest APIs
为工作流准备的接口
ViralPost
recommendations
输入 username，返回推荐爆款推文卡片列表（tweetUrl/score/发布时间等）。
GET /api/public/viralpost/recommendations
Reddit
ranker
输入 keyword，返回相关 subreddit 的热帖分析与建议，用于选题与调研。
GET/POST /api/reddit-ranker
Developer
API Keys
Key 管理与撤销，用于服务端调用公开 API。
GET/POST /api/developer/api-keys
Billing
Wallet
查看 credits、充值记录与自动充值设置。
GET/POST /api/developer/wallet