POST
接口健康状态
- 24h 健康值
- 正常
- 健康 / 正常
- 可用
- 少量可用
- 基本不可用
正常
24 小时趋势
30 天趋势
用户内容:返回列表,默认 20 条、单次最多 100 条;主要字段 id、url、text、author_username、author_name、like_count。
请求发到 POST https://api.everyinfra.com/api/v1/social,platform 填 gab,action 填 user_posts。 单价 $1.39 / 千次(每次 $0.001389),失败和空结果都不收费。 同步返回;慢任务可在请求体加 "mode": "async",先拿 job_id 再轮询。
用户内容按 username 读取一个 Gab 账号的公开帖子,一行一条,带正文、点赞转发回复数、媒体链接和 UTC 发布时间。它回答「这个账号发了什么」,适合持续跟踪一个账号的发言,或者挑出它互动最高的几条。
username 填 Gab 的账号用户名,不带 @,也可以填账号主页的完整 URL。这一页按账号查,不是按人名搜索,所以填真名搜不到人。账号资料属于另一类能力,这一页只读帖子。
AI 提示词
#请帮我用 EveryInfra 的「Gab 用户内容」接口(gab/user_posts)写一个数据采集脚本。
接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 gab,action 填 user_posts,参数放在 params 里。
- 必填参数:
- username:Gab 账号用户名(不带 @)或完整账号主页 URL;profile 查账号资料,user_posts 查该账号公开帖子。不是按人名搜索。
- 可选参数:
- limit:这次调用最多返回的条数,整数,1–100;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。(默认 20)
- 返回一组记录,每条记录的主要字段:id、url、text、author_username、author_name、like_count、repost_count、reply_count、media_urls(媒体文件链接)、posted_at。
- 示例请求体:
{
"platform": "gab",
"action": "user_posts",
"params": {
"username": "a"
}
}
- 计费:$1.39 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。
写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。请求参数
#| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
Authorization | header | string | 是 | - | Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。 |
platform | body | string | 是 | gab | 平台标识,固定值。 |
action | body | string | 是 | user_posts | 能力标识,固定值。 |
username | body.params | string | 是 | - | Gab 账号用户名(不带 @)或完整账号主页 URL;profile 查账号资料,user_posts 查该账号公开帖子。不是按人名搜索。 |
limit | body.params | integer (1–100) | 否 | 20 | 这次调用最多返回的条数,整数,1–100;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。 |
代码示例
#bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "gab",
"action": "user_posts",
"params": {
"username": "a"
}
}'OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。
响应示例
#2026年9月26日 16:56(北京时间)用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回,已隐去名字、账号、头像、主页链接、联系方式等个人信息,列表只保留前 2 条;id、billing、quota 每次调用都不同,只给结构。
json
{ "id": "req_…", "platform": "gab", "action": "user_posts", "results": [ { "id": "•••", "url": "https://gab.com/a/posts/117335894018810516", "text": "The rise of AI is the biggest Gospel opportunity in our lifetimes for this reason btw. When your identity is in Christ you don't worry about such things.", "author_username": "•••", "author_name": "•••", "like_count": 21, "repost_count": 4, "reply_count": 7, "media_urls": [ "https://m3.gab.com/media_attachments/6e/1a/8a/6e1a8a522b253d8f0bfb4fd3cb1e8d52.jpg" ], "posted_at": "2026-09-26T06:20:56.315000+00:00", "platform": "gab" }, { "id": "•••", "url": "https://gab.com/a/posts/117334988995901537", "text": "imagine. You don’t need to worship the technology, but you also don’t need to fear it either. You need to understand it and put it to work in service of things that matter. Be humble enough to learn. Be disciplined enough to practice. The promise and vision that we have for AI is…", "author_username": "•••", "author_name": "•••", "like_count": 58, "repost_count": 7, "reply_count": 11, "posted_at": "2026-09-26T02:30:46.751000+00:00", "platform": "gab" } ], "count": 20, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
返回字段
#业务数据在 results 里;下表是每条记录可能包含的字段,平台没有提供的值不会被编造。
| 字段 | 含义 |
|---|---|
id | 该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。 |
url | 该记录在原平台上的可访问链接。 |
text | 正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。 |
author_username | 作者用户名(@handle),通常可用于拼 URL。 |
author_name | 作者昵称(显示名)。 |
like_count | 点赞数。null 表示该平台或该接口不公开此数据,不等于 0。 |
repost_count | 转发数(区别于引用转发)。null 表示不公开。 |
reply_count | 回复数,通常用于评论的子回复。null 表示不公开。 |
media_urls | 媒体文件链接。 |
posted_at | 发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。 |
platform | 数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。 |
常见问题
#错误与计费
#- 401
- 缺少 Key 或 Key 无效。
- 402
- 余额不足,先充值。
- 422
- 参数名或取值不对,按错误信息给的候选改;不扣费。
- 429
- 超过每分钟请求上限,按 Retry-After 等待后再试。
- 503
- 暂时无法完成,预扣的费用退回;结果未知时先核对,不要直接重发。
- 200 空结果
- 没有数据,不扣费。