社交内容 · 数据 API

Lemmy

Lemmy API

按关键词、社区或实例时间线读取 Lemmy 帖子,并按社区展开评论层级;保留实例、原帖和作者出处,不承诺完整联邦范围或讨论树。 调用 POST /api/v1/social ;返回结构化 JSON,$1.39 / 千次;失败不计费。

4

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Lemmy 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordinstance, sort, top_range默认 20 · 最多 200同步$1.39 / 千次id · title · body · url · external_url · community · community_url · instance · author_username · author_url · score · upvote_count · downvote_count · comment_count · thumbnail_url · embed_title · is_nsfw · is_locked · is_featured · posted_at · updated_at · platform
communitycommunityinstance, sort, top_range默认 20 · 最多 200同步$1.39 / 千次id · title · body · url · external_url · community · community_url · instance · author_username · author_url · score · upvote_count · downvote_count · comment_count · thumbnail_url · embed_title · is_nsfw · is_locked · is_featured · posted_at · updated_at · platform
feed—instance, sort, top_range默认 20 · 最多 100同步$1.39 / 千次id · title · body · url · external_url · community · community_url · instance · author_username · author_url · score · upvote_count · downvote_count · comment_count · thumbnail_url · embed_title · is_nsfw · is_locked · is_featured · posted_at · updated_at · platform
commentscommunityinstance, max_comments, sort, top_range默认 10 · 最多 200同步$1.39 / 千次id · text · author_username · author_url · score · upvote_count · downvote_count · depth · parent_comment_id · is_deleted · post_url · post_title · community · posted_at · platform

Lemmy 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

怎么调用 Lemmy 社区资料 API?

community

使用 platform="lemmy"、action="community" 调用“社区资料”能力;返回列表,默认 20 条、单次最多 200 条,主要包含 id、title、body、url、external_url、community 等 22 个字段。

Lemmy community 的参数分别是什么意思?

community必填
Lemmy 社区名或 name@instance 形式的跨实例社区标识。community 列社区帖子;comments 按社区读取帖子并展开评论,不是直接按单个帖子 URL 查询。

官方展示社区 URL 与 !name@instance 标识,并区分本地和联邦社区。EveryInfra 此参数声明为 name 或 name@instance;官方 UI 的 ! 前缀和 URL 形式不自动成为本接口支持格式。官方来源:Lemmy 社区标识与跨实例访问来源核查:

instance可选
Lemmy 实例域名,例如 lemmy.world,默认 lemmy.world;可以传带协议的实例 URL,最终只保留主机名。它指定查询入口,不是社区名称。
sort可选
帖子排序:hot 热门、active 活跃、new 新帖、top 高分、most_comments 评论最多、new_comments 新评论活动。search/community 默认 hot,feed 默认 active,comments 默认 most_comments。
查看全部 6 个允许值

activehotmost_commentsnewnew_commentstop

top_range可选
只在 sort=top 时生效的积分时间窗:hour 1 小时、sixhour 6 小时、twelvehour 12 小时、day 1 天、week 1 周(默认)、month 1 月、threemonths 3 月、sixmonths 6 月、ninemonths 9 月、year 1 年、all 全部。不是评论发布时间过滤。
查看全部 11 个允许值

alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear

Lemmy 特有返回字段与含义(13)
instance
所在实例(服务器)。Lemmy 是联邦宇宙社区,同名社区可存在于不同实例。
community
社区名。
community_url
社区链接。
body
正文。
score
净得分(顶减踩)。
upvote_count
顶数。
downvote_count
踩数。
is_featured
是否为置顶精选。
is_locked
是否锁定(禁止新评论)。
is_nsfw
是否为成人内容。
external_url
帖子指向的外部链接。
embed_title
外链的标题。
updated_at
编辑时间。

怎么调用 Lemmy 信息流 API?

feed

使用 platform="lemmy"、action="feed" 调用“信息流”能力;返回列表,默认 20 条、单次最多 100 条,主要包含 id、title、body、url、external_url、community 等 22 个字段。

Lemmy feed 的参数分别是什么意思?

instance可选
Lemmy 实例域名,例如 lemmy.world,默认 lemmy.world;可以传带协议的实例 URL,最终只保留主机名。它指定查询入口,不是社区名称。

Lemmy 官方入门说明不同实例由不同运营者管理,常规浏览只覆盖该实例已知的本地与联邦社区。EveryInfra feed 的 instance 用于选择实例视角;sort、top_range、默认实例和结果完整性属于自身契约,不代表整个 Fediverse 的全局 feed。官方来源:Lemmy:实例视角与联邦内容范围来源核查:

sort可选
帖子排序:hot 热门、active 活跃、new 新帖、top 高分、most_comments 评论最多、new_comments 新评论活动。search/community 默认 hot,feed 默认 active,comments 默认 most_comments。
查看全部 6 个允许值

activehotmost_commentsnewnew_commentstop

top_range可选
只在 sort=top 时生效的积分时间窗:hour 1 小时、sixhour 6 小时、twelvehour 12 小时、day 1 天、week 1 周(默认)、month 1 月、threemonths 3 月、sixmonths 6 月、ninemonths 9 月、year 1 年、all 全部。不是评论发布时间过滤。
查看全部 11 个允许值

alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear

Lemmy 特有返回字段与含义(13)
instance
所在实例(服务器)。Lemmy 是联邦宇宙社区,同名社区可存在于不同实例。
community
社区名。
community_url
社区链接。
body
正文。
score
净得分(顶减踩)。
upvote_count
顶数。
downvote_count
踩数。
is_featured
是否为置顶精选。
is_locked
是否锁定(禁止新评论)。
is_nsfw
是否为成人内容。
external_url
帖子指向的外部链接。
embed_title
外链的标题。
updated_at
编辑时间。

怎么调用 Lemmy 评论 API?

comments

使用 platform="lemmy"、action="comments" 调用“评论”能力;返回列表,默认 10 条、单次最多 200 条,主要包含 id、text、author_username、author_url、score、upvote_count 等 15 个字段。

Lemmy comments 的参数分别是什么意思?

community必填
Lemmy 社区名或 name@instance 形式的跨实例社区标识。community 列社区帖子;comments 按社区读取帖子并展开评论,不是直接按单个帖子 URL 查询。
instance可选
Lemmy 实例域名,例如 lemmy.world,默认 lemmy.world;可以传带协议的实例 URL,最终只保留主机名。它指定查询入口,不是社区名称。
max_comments可选
comments 每个帖子最多读取的评论数,默认 50,限制 1–200;不是整个请求的帖子数或评论总数,超范围会截取到边界。

官方解释顶层评论与嵌套回复的层级,以及得分为顶减踩。EveryInfra 的每帖评论限额是自身契约,不是官方排序选项;达到限额也不能保证所有父子节点齐全。官方来源:Lemmy 评论具有父子层级,限额不等于完整讨论来源核查:

sort可选
帖子排序:hot 热门、active 活跃、new 新帖、top 高分、most_comments 评论最多、new_comments 新评论活动。search/community 默认 hot,feed 默认 active,comments 默认 most_comments。
查看全部 6 个允许值

activehotmost_commentsnewnew_commentstop

top_range可选
只在 sort=top 时生效的积分时间窗:hour 1 小时、sixhour 6 小时、twelvehour 12 小时、day 1 天、week 1 周(默认)、month 1 月、threemonths 3 月、sixmonths 6 月、ninemonths 9 月、year 1 年、all 全部。不是评论发布时间过滤。
查看全部 11 个允许值

alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear

Lemmy 特有返回字段与含义(9)
community
社区名。
score
净得分(顶减踩)。
upvote_count
顶数。
downvote_count
踩数。
post_title
帖子标题。
post_url
帖子链接。
depth
评论层级深度。
parent_comment_id
父评论 ID。
is_deleted
是否已删除。
Lemmy search 调用流程一次 Lemmy search 调用的全过程:向 POST /api/v1/social 发送 platform="lemmy"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、title、body、url、external_url 等字段;返回列表,单次最多 200 条,计费 $1.39 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "lemmy"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表idtitlebodyurlexternal_url
一次 Lemmy search 调用的全过程:向 POST /api/v1/social 发送 platform="lemmy"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、title、body、url、external_url 等字段;返回列表,单次最多 200 条,计费 $1.39 / 千次,失败与空结果不计费。

Lemmy 原始字段名

EveryInfra 统一字段名

左边是 Lemmy 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

Lemmy 的独有字段名(当前目录)

全站 89 个平台的当前目录中,这 6 个字段名只在 Lemmy 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • body
  • community_url
  • downvote_count
  • is_featured
  • depth
  • post_title

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
title
标题。平台无标题概念时(如纯文本帖)为 null。
body
正文。
url
该记录在原平台上的可访问链接。
external_url
帖子指向的外部链接。
community
社区名。
community_url
社区链接。
instance
所在实例(服务器)。Lemmy 是联邦宇宙社区,同名社区可存在于不同实例。
author_username
作者用户名(@handle),通常可用于拼 URL。
author_url
作者在原平台的主页链接。
score
净得分(顶减踩)。
upvote_count
顶数。
downvote_count
踩数。
comment_count
评论数。null 表示不公开,不等于 0。
thumbnail_url
缩略图链接,分辨率低于 image_url。
embed_title
外链的标题。
is_nsfw
是否为成人内容。
is_locked
是否锁定(禁止新评论)。
is_featured
是否为置顶精选。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
updated_at
编辑时间。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
text
正文内容,已去除 HTML 标签。长文可能被截断。
depth
评论层级深度。
parent_comment_id
父评论 ID。
is_deleted
是否已删除。
post_url
帖子链接。
post_title
帖子标题。

请求填写示例

检索指定实例上的公开内容,不代表联邦全网结果完整。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

lemmy_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"lemmy","action":"search","params":{"keyword":"self hosting"}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "id": null,
  "title": null,
  "body": null,
  "url": null,
  "external_url": null,
  "community": null,
  "community_url": null,
  "instance": null,
  "author_username": null,
  "author_url": null,
  "score": null,
  "upvote_count": null,
  "downvote_count": null,
  "comment_count": null,
  "thumbnail_url": null,
  "embed_title": null,
  "is_nsfw": null,
  "is_locked": null,
  "is_featured": null,
  "posted_at": null,
  "updated_at": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

搜索 Lemmy 社区帖子并保留实例出处

search 返回帖子对象,适合从主题词找到讨论线索,再区分原帖与帖子分享的外链。当前响应处理存在尚未修复的错误,修复通过验证前仅作格式参考。

查看 search 的 keyword 参数 →
  • keyword 是帖子搜索词。当前生成目录未开放 instance 参数,现有默认查询入口为 lemmy.world;不要把这一入口看到的结果写成整个联邦的全量搜索。
  • title / body 是帖子标题与正文,url 是 Lemmy 帖链接,external_url 才是帖子分享的外部资源。community_url、instance、author_url 用于保留社区及作者出处;跨实例归档不要只用局部数字 id 去重。
  • 当前非空帖子处理路径存在已确认的程序错误;本页说明不代表此 action 已通过功能验证,暂不建议接入生产任务。

按 Lemmy 社区标识读取讨论列表

community 定位社区而不是用户,同名社区必须连同实例一起识别。当前响应处理存在尚未修复的错误,修复通过验证前仅作格式参考。

查看 community 的 community 参数 →
  • community 当前声明接收社区短名或 name@instance。Lemmy 界面常把完整社区标识写成 !name@instance;本输入不要额外添加未登记处理的 ! 前缀,也不要用个人账号 @name@instance 或帖子 URL 代替社区。
  • 返回每条帖子的 community / community_url、title、score 和 comment_count。score 是顶数减踩数,不是浏览量;is_locked / is_featured 是当前条目的锁定或精选标记,不代表社区管理员身份或全局榜单。
  • 当前非空帖子处理路径存在已确认的程序错误;本页说明不代表此 action 已通过功能验证,暂不建议接入生产任务。

从 Lemmy 默认实例发现活跃帖子

feed 提供实例视角的发现入口,适合在没有社区或关键词时获取讨论样本。

查看 feed 的 instance 参数 →
  • instance 可指定 Lemmy 实例域名,默认 lemmy.world;sort 默认 active,也可切换 hot、new、top、most_comments 或 new_comments,sort=top 时再用 top_range 选择积分时间窗。它不是登录用户的订阅流,也不代表联邦全网完整内容。
  • 保留 url、community_url 与 instance 后再分析 title、score、comment_count 和 posted_at。Active 与按发布时间倒序不是同一规则;实例仅知道部分联邦内容,空结果不能被解释为全网无活跃讨论。
  • 本地已修复脱敏函数的正则别名错误并通过离线样本;尚未付费调用上游,因此不把该修复表述成实时可用性证明。

按 Lemmy 社区提取多帖评论及回复层级

comments 先选社区帖子,再把各帖的评论摊平成列表;它不是拿单条帖子 URL 直接查评论。

查看 comments 的 max_comments 参数 →
  • community 用社区短名或 name@instance。limit 同时影响选取的帖子数和最终返回评论总行数;max_comments 只控制每帖评论上限,默认 50,非零数值限制在 1–200,优先于兼容的 comment_limit,0 会回落兼容值或默认值。不能按 limit × max_comments 计算保证返回量,也不能把 0 当作不取评论。
  • post_url / post_title 表明评论属于哪篇帖子。depth=1 表示直接回复帖子,parent_comment_id 标识更深层回复的父评论;按 post_url 分组后再建立层级。返回可能缺少部分祖先、已删除内容或超过上限的回复,不能保证重建完整讨论树。

Lemmy API 常见问题

Lemmy API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="lemmy"、action 和 params。以 search 为例,必填 keyword,可选 instance、sort、top_range。检索指定实例上的公开内容,不代表联邦全网结果完整。 Lemmy 共 4 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Lemmy API 怎么收费?

$1.39 / 千次,Lemmy 全部 4 个能力同价。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 719 次 Lemmy 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

Lemmy API 一次能返回多少条数据?

Lemmy 有 4 个列表接口,包括 search、community、feed、comments。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

Lemmy API 返回哪些字段?

当前目录为 search 列出 id、title、body、url、external_url、community 等 22 个字段名。按全站当前目录统计,6 个字段名只在 Lemmy 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

「搜索 Lemmy 社区帖子并保留实例出处」怎样接入 Lemmy API?

search 返回帖子对象,适合从主题词找到讨论线索,再区分原帖与帖子分享的外链。当前响应处理存在尚未修复的错误,修复通过验证前仅作格式参考。 keyword 是帖子搜索词。当前生成目录未开放 instance 参数,现有默认查询入口为 lemmy.world;不要把这一入口看到的结果写成整个联邦的全量搜索。 title / body 是帖子标题与正文,url 是 Lemmy 帖链接,external_url 才是帖子分享的外部资源。community_url、instance、author_url 用于保留社区及作者出处;跨实例归档不要只用局部数字 id 去重。 当前非空帖子处理路径存在已确认的程序错误;本页说明不代表此 action 已通过功能验证,暂不建议接入生产任务。

「按 Lemmy 社区标识读取讨论列表」怎样接入 Lemmy API?

community 定位社区而不是用户,同名社区必须连同实例一起识别。当前响应处理存在尚未修复的错误,修复通过验证前仅作格式参考。 community 当前声明接收社区短名或 name@instance。Lemmy 界面常把完整社区标识写成 !name@instance;本输入不要额外添加未登记处理的 ! 前缀,也不要用个人账号 @name@instance 或帖子 URL 代替社区。 返回每条帖子的 community / community_url、title、score 和 comment_count。score 是顶数减踩数,不是浏览量;is_locked / is_featured 是当前条目的锁定或精选标记,不代表社区管理员身份或全局榜单。 当前非空帖子处理路径存在已确认的程序错误;本页说明不代表此 action 已通过功能验证,暂不建议接入生产任务。

「从 Lemmy 默认实例发现活跃帖子」怎样接入 Lemmy API?

feed 提供实例视角的发现入口,适合在没有社区或关键词时获取讨论样本。 instance 可指定 Lemmy 实例域名,默认 lemmy.world;sort 默认 active,也可切换 hot、new、top、most_comments 或 new_comments,sort=top 时再用 top_range 选择积分时间窗。它不是登录用户的订阅流,也不代表联邦全网完整内容。 保留 url、community_url 与 instance 后再分析 title、score、comment_count 和 posted_at。Active 与按发布时间倒序不是同一规则;实例仅知道部分联邦内容,空结果不能被解释为全网无活跃讨论。 本地已修复脱敏函数的正则别名错误并通过离线样本;尚未付费调用上游,因此不把该修复表述成实时可用性证明。

「按 Lemmy 社区提取多帖评论及回复层级」怎样接入 Lemmy API?

comments 先选社区帖子,再把各帖的评论摊平成列表;它不是拿单条帖子 URL 直接查评论。 community 用社区短名或 name@instance。limit 同时影响选取的帖子数和最终返回评论总行数;max_comments 只控制每帖评论上限,默认 50,非零数值限制在 1–200,优先于兼容的 comment_limit,0 会回落兼容值或默认值。不能按 limit × max_comments 计算保证返回量,也不能把 0 当作不取评论。 post_url / post_title 表明评论属于哪篇帖子。depth=1 表示直接回复帖子,parent_comment_id 标识更深层回复的父评论;按 post_url 分组后再建立层级。返回可能缺少部分祖先、已删除内容或超过上限的回复,不能保证重建完整讨论树。

可以先免费试用 Lemmy API 吗?

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用)。请先选择 Lemmy 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 4 个能力。无需信用卡。

开始调用 Lemmy API

加微信领 $1 免费额度,先选一个 Lemmy 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始