| action | 必填参数 | 可选参数 | 单次条数 | 模式 | 单价 | 返回字段 |
|---|---|---|---|---|---|---|
| search | keyword | — | 默认 20 · 最多 50 | 同步 | $1.39 / 千次 | id · title · description · channel_name · channel_id · channel_url · url · thumbnail_url · duration_seconds · view_count · like_count · published_at · media_type · languages · tags · platform |
| trending | — | — | 默认 20 · 最多 50 | 同步 | $1.39 / 千次 | id · title · description · channel_name · channel_id · channel_url · url · thumbnail_url · duration_seconds · view_count · like_count · published_at · media_type · languages · tags · platform |
| user_posts | username | sort | 默认 20 · 最多 200 | 同步 | $1.39 / 千次 | id · title · description · channel_name · channel_id · channel_url · url · thumbnail_url · duration_seconds · view_count · like_count · published_at · media_type · languages · tags · platform |
| tag | tag | sort | 默认 20 · 最多 200 | 同步 | $1.39 / 千次 | id · title · description · channel_name · channel_id · channel_url · url · thumbnail_url · duration_seconds · view_count · like_count · published_at · media_type · languages · tags · platform |
下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。
下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。
search使用 platform="odysee"、action="search" 调用“关键词搜索”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 id、title、description、channel_name、channel_id、channel_url 等 16 个字段。
keyword必填Odysee 明确区分上传内容的 Title、URL 与 Description，三者用途不同。搜索结果应保留原始链接和标题，不从标题自行拼出地址；描述文字也不是完整视频文稿。官方来源：Odysee：展示标题不等于内容 URL来源核查：
trending使用 platform="odysee"、action="trending" 调用“热榜”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 id、title、description、channel_name、channel_id、channel_url 等 16 个字段。
官方将 Trending 解释为近期数小时或数天内 tips 与 supports 增幅较大的内容，并与 New、Top 区分；它不是播放量或点赞量排行榜，也不证明 EveryInfra 的抓取范围、分页或结果数量。官方来源：Odysee：Trending 与 New、Top 的区别来源核查：
这个能力没有业务参数，只传 platform 与 action。
user_posts使用 platform="odysee"、action="user_posts" 调用“用户内容”能力；返回列表，默认 20 条、单次最多 200 条，主要包含 id、title、description、channel_name、channel_id、channel_url 等 16 个字段。
username必填Odysee 的命名说明指出，URL 冒号后的部分关联具体频道或内容的 Claim，同名地址需要靠完整标识区分。本接口当前提取频道名时会去掉该部分，因此引用该说明不等于已支持 Claim 精确查询。官方来源：Odysee：频道名与 Claim 标识的区别来源核查：
sort可选newestpopular
tag使用 platform="odysee"、action="tag" 调用“标签内容”能力；返回列表，默认 20 条、单次最多 200 条，主要包含 id、title、description、channel_name、channel_id、channel_url 等 16 个字段。
tag必填Odysee 将主题标签与控制互动的标签分开，并把内容语言和版权许可列为不同设置。本接口返回的 tags / languages 只描述实际取得的信息，不代表提供上传、互动控制、翻译或内容转载许可。官方来源：Odysee：内容标签、控制标签与语言设置来源核查：
sort可选newestpopular
Odysee 原始字段名
EveryInfra 统一字段名
左边是 Odysee 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。
这些字段名在当前目录中只出现在不超过 3 个平台，Odysee 是其中之一。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。
通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields
这里检索公开内容；频道或视频详情使用各自链接。
以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer omg_你的KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"odysee","action":"search","params":{"keyword":"open source hardware"}}'
仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。
{ "id": null, "title": null, "description": null, "channel_name": null, "channel_id": null, "channel_url": null, "url": null, "thumbnail_url": null, "duration_seconds": null, "view_count": null, "like_count": null, "published_at": null, "media_type": null, "languages": null, "tags": null, "platform": null }
以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。
用 search 发现内容，将内容标识、展示标题和来源频道分开保存。
查看 search 的 keyword 参数 →用 trending 取得当次趋势列表，不附加并未开放的关键词或时间条件。
查看 trending 接口说明 →用 user_posts 整理一个频道的发布记录，核对返回的频道身份。
查看 user_posts 的 username 参数 →用 tag 找同一主题标签的内容，分清内容标签与控制标签。
查看 tag 的 sort 参数 →调用 POST /api/v1/social，请求体传 platform="odysee"、action 和 params。以 search 为例，必填 keyword，没有可选参数。这里检索公开内容；频道或视频详情使用各自链接。 Odysee 共 4 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。
$1.39 / 千次，Odysee 全部 4 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 719 次 Odysee 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。
Odysee 有 4 个列表接口，包括 search、trending、user_posts、tag。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。
当前目录为 search 列出 id、title、description、channel_name、channel_id、channel_url 等 16 个字段名。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。
用 search 发现内容，将内容标识、展示标题和来源频道分开保存。 keyword 是内容检索词；id 是内容 Claim 标识，title 是展示标题，url 是内容链接，channel_name / channel_id / channel_url 是发布频道信息。不要从标题自行拼接 URL，也不把频道名当作视频 ID。 description 是内容描述，不是语音文稿；media_type、languages 和 tags 只按实际返回使用。view_count / like_count 缺失不补零，本页没有按搜索结果直接查询单个视频详情、评论或转写的操作。
用 trending 取得当次趋势列表，不附加并未开放的关键词或时间条件。 trending 不需要 keyword，也没有本接口公开的 sort、地区或日期筛选参数。id、title、url 与 channel_name 用于记录当次出现的内容；published_at 是内容发布时间，不是这次查询时间。 调用方若要观察变化，应另行保存查询时间与结果，而不是将一次返回当作历史榜单。本接口没有趋势分数、排名变化字段，也不以 view_count 或 like_count 推断官方趋势算法。
用 user_posts 整理一个频道的发布记录，核对返回的频道身份。 username 可填 name、@name 或包含 @name 的频道链接；当前解析会去掉冒号后的 Claim 标识，只按频道名查询。因此同名频道需要核对 channel_id / channel_url，不能宣称输入完整带 Claim 的链接就一定精确命中。 id、title、url 与 published_at 对应内容，不是频道个人资料；sort=newest 按发布时间，popular 是支持金额相关排序，不是播放量或点赞量排名。本页不提供频道认证、粉丝名单或完整历史保证。
用 tag 找同一主题标签的内容，分清内容标签与控制标签。 tag 填标签文字，可带或不带开头的 #；它不是任意全文关键词。sort=newest 表示发布时间顺序，popular 使用支持金额相关指标，不能标成最多播放或最多点赞。 返回 tags 只保留内容标签，控制评论或互动的内部标签已过滤；languages 描述返回的内容语言，不表示本接口提供语言筛选或翻译。url / id 用于进一步核对内容，标签相同不等于作者相同，也不保证所有标签内容都可访问。
可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 Odysee 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 4 个能力。无需信用卡。