万有引擎
搜索⌘K
中文
登录免费开始

社交内容 · 数据 API

优酷

优酷 API

检索优酷节目卡片，核对剧集、单集和作者资料；对可匿名下载的公开视频提交异步语音转写，为内容检索准备文本。 调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次–$2.78 / 千次；失败不计费。

免费开始 看文档

4

个能力

$1.39 / 千次–$2.78 / 千次

能力价格

同步/异步

调用模式

1 个

一把 Key 通用 89 个平台

优酷 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeyword—默认 30 · 最多 150同步$1.39 / 千次id · url · title · subtitle · category · source_name · release_date · is_completed · corner_tag · thumbnail_url · platform
videoid——同步$1.39 / 千次id · show_id · url · title · show_name · subtitle · category · video_type · duration_seconds · episode_total · episode_last · is_completed · comment_count · like_count · is_vip · allow_comment · posted_at · show_release_time · thumbnail_url · tags · author_id · author_name · author_avatar_url · author_follower_count · author_url · platform
profileuser_id——同步$1.39 / 千次user_id · numeric_id · name · url · bio · avatar_url · gender · like_count · follower_count · is_verified · verified_desc · location · platform
transcripturl——异步$2.78 / 千次title · text · language · translated_text · translated_language · duration_seconds · author_name · author_id · author_url · thumbnail_url · tags · platform

优酷 每个接口分别做什么

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

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

怎么调用 优酷 视频详情 API？

video

使用 platform="youku"、action="video" 调用“视频详情”能力；返回单个对象，主要包含 id、show_id、url、title、show_name、subtitle 等 26 个字段。

优酷协议区分观看、缓存、搜索、评论等平台功能，并对内容复制、传播和下载设有限制。这里引用的是使用边界，不将节目或视频详情可读取解释成获得播放、下载、转载许可或优酷官方背书。官方来源：优酷：视频元数据与内容使用许可的边界来源核查：

优酷 video 的参数分别是什么意思？

id必填
video 的节目 showId 或视频 vid，可从搜索结果的标识或观看页 id_…html 提取；UGC 编码 ID 与剧集哈希不同，部分路径只支持 UGC。该字段不是作者 UID。
优酷 特有返回字段与含义（11）
is_completed
是否完结。连载中 episode_last 会小于 episode_total。
subtitle
副标题。
show_id
节目 ID。优酷把剧/综艺叫「节目(show)」。
show_name
节目名称。
episode_total
总集数。
episode_last
最新更新到第几集。
show_release_time
节目上线时间。
video_type
视频类型。
is_vip
是否需要会员观看。
allow_comment
是否开放评论。
author_avatar_url
评论者头像。

怎么调用 优酷 主页或对象详情 API？

profile

使用 platform="youku"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 user_id、numeric_id、name、url、bio、avatar_url 等 13 个字段。

阿里开放平台文档说明 taobao.tbmpc.youkuuser.getbyid 可按 havanaId 或优酷 ytid 获取一个 YoukuUserDto 的基本信息，包括 nickname、优酷 ID、用户类型与状态。该来源只支撑单个优酷用户资料对象，不证明 EveryInfra 的 encoded creator UID 语法，也不证明简介、头像、粉丝、获赞、认证、性别或所在地等全部字段都公开可读。官方来源：优酷开放 API：按 ytid 获取单个用户基本资料来源核查：

优酷 profile 的参数分别是什么意思？

user_id必填
profile 的编码态创作者 UID，可取自视频作者信息，不是用户名或节目 ID；不要在此字段放完整主页 URL。
优酷 特有返回字段与含义（3）
numeric_id
数字 ID。
gender
性别。
verified_desc
认证说明。

怎么调用 优酷 视频文稿 API？

transcript

使用 platform="youku"、action="transcript" 调用“视频文稿”能力；返回单个对象，主要包含 title、text、language、translated_text、translated_language、duration_seconds 等 12 个字段。

优酷协议的禁止行为包含自动化收集或处理平台内容，以及破坏版权保护措施让非会员取得会员内容。本页不把公开视频转写当作平台授权，也不承诺突破会员、版权或访问限制；使用前需核对相应许可。官方来源：优酷：自动化收集与会员内容访问限制来源核查：

优酷 transcript 的参数分别是什么意思？

url必填
transcript 的真实公开视频 URL；转录是异步任务，需等待任务完成，不支持受会员权限限制的正片。video 可从 id_…html 链接提取标识，但公开必填 id 仍需提供。
优酷 特有返回字段与含义（2）
translated_language
翻译目标语言。
translated_text
翻译文本。
优酷 search 调用流程一次 优酷 search 调用的全过程：向 POST /api/v1/social 发送 platform="youku"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、subtitle、category 等字段；返回列表，单次最多 150 条，计费 $1.39 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "youku"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表idurltitlesubtitlecategory
一次 优酷 search 调用的全过程：向 POST /api/v1/social 发送 platform="youku"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、subtitle、category 等字段；返回列表，单次最多 150 条，计费 $1.39 / 千次，失败与空结果不计费。

优酷 原始字段名

EveryInfra 统一字段名

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

优酷 的独有字段名（当前目录）

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

  • source_name
  • is_completed
  • corner_tag
  • show_id
  • show_name
  • video_type
  • episode_total
  • episode_last
  • allow_comment
  • show_release_time
  • numeric_id
  • verified_desc
  • translated_text
  • translated_language

返回字段含义

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

id
该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url
该记录在原平台上的可访问链接。
title
标题。平台无标题概念时（如纯文本帖）为 null。
subtitle
副标题。
category
分类名称，取值为原平台的分类体系，未做跨平台归一。
source_name
来源名称。
release_date
发布日期。
is_completed
是否完结。连载中 episode_last 会小于 episode_total。
corner_tag
角标文字（如「VIP」「独播」）。
thumbnail_url
缩略图链接，分辨率低于 image_url。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
show_id
节目 ID。优酷把剧/综艺叫「节目(show)」。
show_name
节目名称。
video_type
视频类型。
duration_seconds
时长，单位秒。非视频/音频内容为 null。
episode_total
总集数。
episode_last
最新更新到第几集。
comment_count
评论数。null 表示不公开，不等于 0。
like_count
点赞数。null 表示该平台或该接口不公开此数据，不等于 0。
is_vip
是否需要会员观看。
allow_comment
是否开放评论。
posted_at
发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
show_release_time
节目上线时间。
tags
标签数组。无标签时为空数组，不是 null。
author_id
作者在原平台的唯一 ID。
author_name
作者昵称（显示名）。
author_avatar_url
评论者头像。
author_follower_count
作者粉丝数。null 表示不公开。
author_url
作者在原平台的主页链接。
user_id
用户在原平台的唯一 ID。
numeric_id
数字 ID。
name
名称。用于账号/商品/商家类能力，指该对象本身的名字。
bio
个人简介，账号自己填写的文本。可能含换行和 emoji。
avatar_url
头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。
gender
性别。
follower_count
粉丝数。null 表示不公开，不等于 0。
is_verified
是否为平台认证账号（蓝V等）。null 表示无法判定。
verified_desc
认证说明。
location
地理位置描述，原文透传，格式随平台而异。
text
正文内容，已去除 HTML 标签。长文可能被截断。
language
内容语言代码（如 zh、en），由平台判定，可能不准。
translated_text
翻译文本。
translated_language
翻译目标语言。

请求填写示例

这里检索视频或节目；单个 UGC 视频 ID 与节目 ID 不能互换。

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

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

记录字段预览（非真实响应）

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

fields.preview.json
{
  "id": null,
  "url": null,
  "title": null,
  "subtitle": null,
  "category": null,
  "source_name": null,
  "release_date": null,
  "is_completed": null,
  "corner_tag": null,
  "thumbnail_url": null,
  "platform": null
}

常见用例

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

在优酷搜索节目卡片，再定位具体视频

用 search 找剧集、综艺或视频线索，先分清节目与单集。

查看 search 的 keyword 参数 →
  • keyword 是节目、剧集或视频检索词，不是评论全文搜索；结果中的 id 对应节目 showId，可用于 video。title、subtitle、category、release_date 与 corner_tag 描述搜索卡片，不保证每行就是一个独立单集。
  • is_completed 是完结信息，corner_tag 是页面角标文字，不是调用方会员状态。当前默认返回 30 条、公开上限 150 条，最终响应按条数硬截断；仍不能据本次返回数量推断节目总量或承诺完整搜索覆盖。

分开保存优酷单集视频与所属节目信息

用 video 核对视频元数据、剧集更新情况及关联作者。

查看 video 的 id 参数 →
  • id 填节目 showId 或视频 vid，不填作者 UID；即使从观看页 id_…html 提取标识，公开必填 id 仍要提供。返回 id 与 show_id 分别保留视频和节目关系，episode_total、episode_last、is_completed 描述剧集更新，不表示已经返回所有集的视频列表。
  • duration_seconds 是单条视频时长；is_vip 是内容会员限制信息，不是调用方权限。comment_count / allow_comment 只描述评论数量与开关，本页没有评论正文 action，也不交付播放流或下载文件。author_id 可继续用于 profile，内容使用仍需核对授权和平台规则。

按编码 UID 核对优酷创作者主页

用 profile 读取作者资料，不将节目编号或昵称当作账号标识。

查看 profile 的 user_id 参数 →
  • user_id 使用视频返回的 author_id 或创作者编码 UID，不填昵称、节目 ID 或完整主页 URL。返回 user_id 与 numeric_id 是不同形式的标识，name 是显示名称；不要用 numeric_id 自动替换后续查询所需的编码 UID。
  • bio、url、follower_count、is_verified 与 verified_desc 用于核对主页信息，粉丝数不是粉丝名单，认证标记也不是 EveryInfra 的身份审核。本接口不返回创作者全部作品，本页没有 user_posts action。

为可公开访问的优酷视频制作语音文稿

用异步 transcript 整理语音文字，再由调用方做检索或摘要。

查看 transcript 的 url 参数 →
  • url 使用真实公开视频链接；任务需要等待完成后再读取 text 与 language，不把拿到任务标识当作转写成功。它不是优酷人工字幕下载，也不支持受会员权限限制的正片。
  • 当前 text 最多保留 20,000 个字符，长视频不能据此宣称全文齐全；translated_text / translated_language 仅在结果包含时提供，没有公开的翻译目标语言参数或时间轴分段字段。公开视频可访问不等于获得自动化收集、转载或绕过访问限制的许可。

优酷 API 常见问题

优酷 API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="youku"、action 和 params。以 search 为例，必填 keyword，没有可选参数。这里检索视频或节目；单个 UGC 视频 ID 与节目 ID 不能互换。 优酷 共 4 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

优酷 API 怎么收费？

$1.39 / 千次–$2.78 / 千次，按能力不同(清单里逐条标了)。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 359 次 优酷 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

优酷 API 一次能返回多少条数据？

优酷 有 1 个列表接口，包括 search。其余 3 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

优酷 API 返回哪些字段？

当前目录为 search 列出 id、url、title、subtitle、category、source_name 等 11 个字段名。按全站当前目录统计，14 个字段名只在 优酷 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

优酷 API 的异步能力怎么用？

transcript 是异步能力：提交后立即返回 job_id，用 GET /api/v1/jobs/{job_id} 轮询取结果。只在提交时计费一次，轮询免费。

「在优酷搜索节目卡片，再定位具体视频」怎样接入 优酷 API？

用 search 找剧集、综艺或视频线索，先分清节目与单集。 keyword 是节目、剧集或视频检索词，不是评论全文搜索；结果中的 id 对应节目 showId，可用于 video。title、subtitle、category、release_date 与 corner_tag 描述搜索卡片，不保证每行就是一个独立单集。 is_completed 是完结信息，corner_tag 是页面角标文字，不是调用方会员状态。当前默认返回 30 条、公开上限 150 条，最终响应按条数硬截断；仍不能据本次返回数量推断节目总量或承诺完整搜索覆盖。

「分开保存优酷单集视频与所属节目信息」怎样接入 优酷 API？

用 video 核对视频元数据、剧集更新情况及关联作者。 id 填节目 showId 或视频 vid，不填作者 UID；即使从观看页 id_…html 提取标识，公开必填 id 仍要提供。返回 id 与 show_id 分别保留视频和节目关系，episode_total、episode_last、is_completed 描述剧集更新，不表示已经返回所有集的视频列表。 duration_seconds 是单条视频时长；is_vip 是内容会员限制信息，不是调用方权限。comment_count / allow_comment 只描述评论数量与开关，本页没有评论正文 action，也不交付播放流或下载文件。author_id 可继续用于 profile，内容使用仍需核对授权和平台规则。

「按编码 UID 核对优酷创作者主页」怎样接入 优酷 API？

用 profile 读取作者资料，不将节目编号或昵称当作账号标识。 user_id 使用视频返回的 author_id 或创作者编码 UID，不填昵称、节目 ID 或完整主页 URL。返回 user_id 与 numeric_id 是不同形式的标识，name 是显示名称；不要用 numeric_id 自动替换后续查询所需的编码 UID。 bio、url、follower_count、is_verified 与 verified_desc 用于核对主页信息，粉丝数不是粉丝名单，认证标记也不是 EveryInfra 的身份审核。本接口不返回创作者全部作品，本页没有 user_posts action。

「为可公开访问的优酷视频制作语音文稿」怎样接入 优酷 API？

用异步 transcript 整理语音文字，再由调用方做检索或摘要。 url 使用真实公开视频链接；任务需要等待完成后再读取 text 与 language，不把拿到任务标识当作转写成功。它不是优酷人工字幕下载，也不支持受会员权限限制的正片。 当前 text 最多保留 20,000 个字符，长视频不能据此宣称全文齐全；translated_text / translated_language 仅在结果包含时提供，没有公开的翻译目标语言参数或时间轴分段字段。公开视频可访问不等于获得自动化收集、转载或绕过访问限制的许可。

可以先免费试用 优酷 API 吗？

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

更多社交内容 API

Behance APIB站 APIBluesky APIDailymotion APIDeviantArt APIDiscord API豆瓣 API抖音 API全部 89 平台 ↗

开始调用 优酷 API

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

免费开始