| action | 必填参数 | 可选参数 | 单次条数 | 模式 | 单价 | 返回字段 |
|---|---|---|---|---|---|---|
| video_search | keyword | — | 默认 10 · 最多 50 | 同步 | $1.39 / 千次 | id · url · title · text · media_type · duration_sec · posted_at · view_count · like_count · repost_count · cover_image_url · owner_id · owner_url · platform |
| user_posts | username | — | 默认 20 · 最多 100 | 同步 | $1.39 / 千次 | id · url · text · posted_at · like_count · comment_count · repost_count · view_count · media_urls · author_id · author_name · author_type · author_url · author_avatar · platform |
下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。
下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。
video_search使用 platform="vk"、action="video_search" 调用“视频搜索”能力；返回列表，默认 10 条、单次最多 50 条，主要包含 id、url、title、text、media_type、duration_sec 等 14 个字段。
VK 官方视频对象区分视频 ID、owner_id、上传用户，并将 duration 定义为秒；用于解释视频字段，不代表本接口支持官方 Schema 中其他能力。官方来源：VK 官方 Schema：视频时长与归属主体来源核查：
keyword必填user_posts使用 platform="vk"、action="user_posts" 调用“用户内容”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、url、text、posted_at、like_count、comment_count 等 15 个字段。
username必填官方 wall.get 将对象定义为个人或社区墙，并说明 short address；用于解释 username 的主体语义，不把官方参数、认证、写入方法当成本接口能力。官方来源：VK 官方 Schema：个人及社区墙帖来源核查：
VK 原始字段名
EveryInfra 统一字段名
左边是 VK 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。
全站 89 个平台的当前目录中，这 3 个字段名只在 VK 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。
通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields
video_search 检索视频主题；不是用户或群组名称搜索。
以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer omg_你的KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"vk","action":"video_search","params":{"keyword":"уроки гитары"}}'
仅展示 video_search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。
{ "id": null, "url": null, "title": null, "text": null, "media_type": null, "duration_sec": null, "posted_at": null, "view_count": null, "like_count": null, "repost_count": null, "cover_image_url": null, "owner_id": null, "owner_url": null, "platform": null }
以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。
video_search 用 keyword 查找视频，以视频 URL 和 owner_id 区分内容所属的个人或社区。
查看 video_search 的 keyword 参数 →user_posts 的 username 接收公开主体标识，读取目标墙帖而不是按关键词搜索全站讨论。
查看 user_posts 的 username 参数 →video_search 返回 media_type 标记视频/音频等媒体形态，view_count、like_count、repost_count 是三个独立互动维度。
查看 video_search 的 keyword 参数 →user_posts 用 username 读取指定用户或社区的墙帖，保留发布者身份、媒体附件与互动计数，为俄语内容观察提供可追溯记录。
查看 user_posts 的 username 参数 →调用 POST /api/v1/social，请求体传 platform="vk"、action 和 params。以 video_search 为例，必填 keyword，没有可选参数。video_search 检索视频主题；不是用户或群组名称搜索。 VK 共 2 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。
$1.39 / 千次，VK 全部 2 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 719 次 VK 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。
VK 有 2 个列表接口，包括 video_search、user_posts。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。
当前目录为 video_search 列出 id、url、title、text、media_type、duration_sec 等 14 个字段名。按全站当前目录统计，3 个字段名只在 VK 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。
video_search 用 keyword 查找视频，以视频 URL 和 owner_id 区分内容所属的个人或社区。 keyword 是视频检索词；当前没有墙帖、用户、群组的对应关键词搜索 action，也没有公开视频排序枚举。不能据视频搜索能力推导出粉丝或社区成员接口。 duration_sec 以秒为单位；view_count、like_count、repost_count 是不同互动指标。owner_id 是归属主体，不一定是上传者本人；owner_url 仅在可解析数字主体时生成；保留 id 与主体或完整 URL，避免跨主体去重冲突。
user_posts 的 username 接收公开主体标识，读取目标墙帖而不是按关键词搜索全站讨论。 username 可用短名、club 后接数字 ID、数字 owner ID，或 vk.com 主页及 wall 链接；优先填写正式必填字段，不用未在当前目录公开的 user、group、url 别名替代。社区也能发布内容，不能把目标统一当成个人。 author_type 与 author_id 描述作者对象，comment_count 只是评论数量，media_urls 是附带媒体链接，不是完整评论树、成员列表或私密内容权限。text 当前最多保留 6000 字符，不能承诺长帖无截断。
video_search 返回 media_type 标记视频/音频等媒体形态，view_count、like_count、repost_count 是三个独立互动维度。 media_type 区分视频、音频等媒体形态；cover_image_url 是封面图链接，media_urls 是媒体文件链接数组（user_posts 中）。 view_count 是播放次数，like_count 是点赞数，repost_count 是转发数；三者不可互换，做热度排序需先明确用哪个维度。 owner_id 是内容归属主体（个人或社区）ID，author_type 区分发布者类型；owner_url 仅在可解析数字主体时生成。
user_posts 用 username 读取指定用户或社区的墙帖，保留发布者身份、媒体附件与互动计数，为俄语内容观察提供可追溯记录。 username 是 VK 用户或社区的短名（如 durov）；返回的 author_id、author_name、author_type 标识发布者。 media_urls 是帖子附带的媒体文件链接数组，可能为空（纯文本帖）；不是视频专属字段。 comment_count 是评论数，不是评论内容；需要评论正文时须另选支持评论读取的平台。
可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 VK 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 2 个能力。无需信用卡。