社交内容 · 数据 API

爱奇艺 API

Q: 爱奇艺 API 怎么收费？

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

Q: 爱奇艺 API 一次能返回多少条数据？

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

Q: 可以先免费试用 爱奇艺 API 吗？

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

查找爱奇艺视频与内容分类，按剧名整理国际站专辑的分集和人物信息；热度分与播放量分开理解，不提供视频下载或完整内容库。调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次；失败不计费。

免费开始看文档

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

爱奇艺能力清单

action	必填参数	可选参数	单次条数	模式	单价	返回字段
search	keyword	category, publish_date, published, quality, scrape_additional_info, site, sort	默认 20 · 最多 50	同步	$1.39 / 千次	id · url · title · text · category · category_id · duration_seconds · heat_count · rating · rating_scale · rating_count · like_count · comment_count · collect_count · album_id · album_title · album_url · album_episode_count · image_url · wide_image_url · author_name · author_id · author_avatar_url · author_follower_count · author_video_count · author_location · author_org · posted_at · platform · cast
video	url	scrape_additional_info	—	同步	$1.39 / 千次	id · url · title · text · category · category_id · duration_seconds · heat_count · rating · rating_scale · rating_count · like_count · comment_count · collect_count · album_id · album_title · album_url · album_episode_count · image_url · wide_image_url · author_name · author_id · author_avatar_url · author_follower_count · author_video_count · author_location · author_org · posted_at · platform · cast
album	keyword	lang, language, region	默认 10 · 最多 50	同步	$1.39 / 千次	id · url · play_url · title · subtitle · type · is_series · year · release_date · duration_seconds · rating · rating_scale · content_rating · episode_count · episode_available_count · image_url · episodes · cast · platform

爱奇艺每个接口分别做什么

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

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

怎么调用爱奇艺关键词搜索 API？

search

使用 platform="iqiyi"、action="search" 调用“关键词搜索”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 id、url、title、text、category、category_id 等 30 个字段。

爱奇艺 2018 年公告将内容热度解释为观看、互动和分享等维度的综合数据，与播放量区分。这里只解释 heat_count 的指标类型，不外推当前算法、阈值或跨平台可比性，也不据热度反推真实播放量。官方来源：爱奇艺：内容热度与前台播放量的区别来源核查：2026-09-04

爱奇艺 search 的参数分别是什么意思？

keyword必填: 爱奇艺视频搜索词，用于返回视频结果；不是剧集专辑的直接详情查询。
category可选: 视频内容分类。movie 电影、tv_series 电视剧、variety_shows 综艺、animation 动画、documentary 纪录片等；其余包括广告、汽车、美妆、娱乐、财经、游戏、健康、生活、军事、母婴、音乐、新闻、原创、短片、体育、广场舞、访谈、科技、预告、旅游、热门与时尚，按本接口允许值选择，all 为不限。不是演员或剧集标签。
查看全部 29 个允许值
advertisementallanimationbeautycarcomedydocumentaryentertainmentfashionfinancegamehealthlifemilitarymother_babymoviemusicnews_infooriginalsshort_filmssportssquare_dancetalk_showstechnologytrailerstraveltrendingtv_seriesvariety_shows
publish_date可选: search 发布时间窗：all 不限、last_24_hours 最近 24 小时、last_7_days 最近 7 天、last_30_days 最近 30 天。不是 YYYY-MM-DD 日期；published 同时存在时优先 published。
published可选: publish_date 的优先输入，取 all / last_24_hours / last_7_days / last_30_days；它不是“是否已发布”的布尔值，不能传 true/false。
quality可选: search 的画质条件文本；当前接口已确认的常见值包括 all 不限、hd 高清、ultra_hd 超清、720p、1080p。它不是下载或转码选项；本接口尚未声明封闭值域，未识别文本可能不起筛选作用。
scrape_additional_info可选: 是否为爱奇艺搜索结果读取额外上传者与互动信息，传 JSON 布尔值，默认 true。false 会关闭这部分读取，但不改变 EveryInfra API 单价。
site可选: search 的视频站点条件文本；当前接口已确认的常见值包括 all、iqiyi、tencent_video、sohu、youku、tudou、acfun、bilibili、ifeng、cntv、m1905。它只影响搜索来源，不等于这些站点都有详情接口；本接口尚未声明封闭值域。
sort可选: 爱奇艺视频搜索顺序：relevance 相关度、newest 最新、popular 热门；不是电影评分或分集播放顺序。
查看全部 3 个允许值
newestpopularrelevance

爱奇艺特有返回字段与含义（12）

album_id: 剧集/专辑 ID。爱奇艺把一部剧叫「专辑」，单集是其下的视频。
album_title: 剧集名称。
album_url: 剧集链接。
album_episode_count: 总集数。
cast: 演员表。
category_id: 分类 ID。
heat_count: 爱奇艺热度值。平台自有指标不是播放量，跨平台不可比。
wide_image_url: 横版海报。
author_avatar_url: 评论者头像。
author_location: 评论者 IP 属地。
author_org: 认证机构名（机构号用）。
author_video_count: 作者发布视频数。

怎么调用爱奇艺视频详情 API？

video

使用 platform="iqiyi"、action="video" 调用“视频详情”能力；返回单个对象，主要包含 id、url、title、text、category、category_id 等 30 个字段。

爱奇艺 video 的参数分别是什么意思？

url必填: 爱奇艺 v_*.html 视频播放页完整链接，用于读取单条视频详情；不接受 a_*.html 专辑页或创作者主页。
官方合作方接口按 qipuId 获取片名、导演、演员、简介、评分、时长、类型、上映时间和付费状态等影片资料；它不是任意公开视频读取接口，也没有证明 EveryInfra 当前要求的 v_*.html 播放页 URL 是爱奇艺官方参数格式。官方来源：爱奇艺：官方影片详情使用 qipuId来源核查：2026-09-05
scrape_additional_info可选: 是否为目标爱奇艺视频读取额外上传者与互动信息，传 JSON 布尔值，默认 true。false 会关闭这部分读取，但不改变 EveryInfra API 单价。

爱奇艺特有返回字段与含义（12）

album_id: 剧集/专辑 ID。爱奇艺把一部剧叫「专辑」，单集是其下的视频。
album_title: 剧集名称。
album_url: 剧集链接。
album_episode_count: 总集数。
cast: 演员表。
category_id: 分类 ID。
heat_count: 爱奇艺热度值。平台自有指标不是播放量，跨平台不可比。
wide_image_url: 横版海报。
author_avatar_url: 评论者头像。
author_location: 评论者 IP 属地。
author_org: 认证机构名（机构号用）。
author_video_count: 作者发布视频数。

怎么调用爱奇艺专辑 API？

album

使用 platform="iqiyi"、action="album" 调用“专辑”能力；返回列表，默认 10 条、单次最多 50 条，主要包含 id、url、play_url、title、subtitle、type 等 19 个字段。

爱奇艺 album 的参数分别是什么意思？

keyword必填: 爱奇艺国际站剧集或专辑搜索词，用于返回专辑、分集和演员信息；该动作不接受专辑 URL。
lang可选: album 的标题语言，使用本接口列出的紧凑代码，如 zhcn 简体中文、zhtw 繁体中文、enus 英语、jajp 日语。不是字幕翻译请求，也不控制片库地区。
查看全部 11 个允许值
arsaenusesesididjajpkokrmsmyththvivnzhcnzhtw
language可选: album 的语言兼容输入，使用 zh_cn、zh_tw、en_us、id_id、ms_my、th_th、vi_vn、ko_kr、ja_jp、es_es、ar_sa；默认 zh_cn。lang 同时存在时最终以 lang 为准，两个参数的格式不能混用。
查看全部 11 个允许值
ar_saen_uses_esid_idja_jpko_krms_myth_thvi_vnzh_cnzh_tw
region可选: album 片库地区只接受 intl（国际库，省略时默认）、vn（越南）、th（泰国）、id（印尼）、my（马来西亚）、tw（台湾）、ph（菲律宾）、sg（新加坡）、kr（韩国）或 jp（日本）。其他显式值会在公开 API 参数校验阶段返回 422；它不是页面语言选择。
爱奇艺国际站帮助的版权限制问答说明，地区版权可能导致内容无法播放，外部搜索结果也未必反映当前片库。因此 album 的地区选项与检索元数据不构成播放权限保证，更不表示绕过地区限制。官方来源：爱奇艺国际站：地区版权限制与当前片库来源核查：2026-09-04
查看全部 10 个允许值
idintljpkrmyphsgthtwvn

爱奇艺特有返回字段与含义（10）

cast: 演员表。
episode_count: 集数。
episode_available_count: 当前可看集数。连载中会小于总集数，判断完结看这两个字段之差。
episodes: 分集列表。
is_series: 是否为剧集（相对单片）。
year: 年份。
release_date: 上线日期。
content_rating: 内容分级。
subtitle: 副标题。
play_url: 播放页链接。

一次爱奇艺 search 调用的全过程：向 POST /api/v1/social 发送 platform="iqiyi"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、text、category 等字段；返回列表，单次最多 50 条，计费 $1.39 / 千次，失败与空结果不计费。

爱奇艺原始字段名

EveryInfra 统一字段名

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

爱奇艺的独有字段名（当前目录）

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

heat_count
album_title
album_url
album_episode_count
wide_image_url
author_video_count
author_org
play_url
is_series
episode_available_count
episodes

返回字段含义

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

id: 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url: 该记录在原平台上的可访问链接。
title: 标题。平台无标题概念时（如纯文本帖）为 null。
text: 正文内容，已去除 HTML 标签。长文可能被截断。
category: 分类名称，取值为原平台的分类体系，未做跨平台归一。
category_id: 分类 ID。
duration_seconds: 时长，单位秒。非视频/音频内容为 null。
heat_count: 爱奇艺热度值。平台自有指标不是播放量，跨平台不可比。
rating: 评分。分制随平台而异，同一行的 rating_scale 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale: 上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
rating_count: 参与评分的人数。null 表示不公开，不等于 0。
like_count: 点赞数。null 表示该平台或该接口不公开此数据，不等于 0。
comment_count: 评论数。null 表示不公开，不等于 0。
collect_count: 收藏数。null 表示不公开，不等于 0。
album_id: 剧集/专辑 ID。爱奇艺把一部剧叫「专辑」，单集是其下的视频。
album_title: 剧集名称。
album_url: 剧集链接。
album_episode_count: 总集数。
image_url: 图片链接。多图能力可能返回 image_urls 数组。
wide_image_url: 横版海报。
author_name: 作者昵称（显示名）。
author_id: 作者在原平台的唯一 ID。
author_avatar_url: 评论者头像。
author_follower_count: 作者粉丝数。null 表示不公开。
author_video_count: 作者发布视频数。
author_location: 评论者 IP 属地。
author_org: 认证机构名（机构号用）。
posted_at: 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
platform: 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
cast: 演员表。
play_url: 播放页链接。
subtitle: 副标题。
type: 记录类型，取值随能力而定（如 video / image / text）。
is_series: 是否为剧集（相对单片）。
year: 年份。
release_date: 上线日期。
content_rating: 内容分级。
episode_count: 集数。
episode_available_count: 当前可看集数。连载中会小于总集数，判断完结看这两个字段之差。
episodes: 分集列表。

请求填写示例

按节目或视频主题检索；没有在公开清单中的筛选项不要直接传入。

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

iqiyi_search.sh

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

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

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

fields.preview.json

{
  "id": null,
  "url": null,
  "title": null,
  "text": null,
  "category": null,
  "category_id": null,
  "duration_seconds": null,
  "heat_count": null,
  "rating": null,
  "rating_scale": null,
  "rating_count": null,
  "like_count": null,
  "comment_count": null,
  "collect_count": null,
  "album_id": null,
  "album_title": null,
  "album_url": null,
  "album_episode_count": null,
  "image_url": null,
  "wide_image_url": null,
  "author_name": null,
  "author_id": null,
  "author_avatar_url": null,
  "author_follower_count": null,
  "author_video_count": null,
  "author_location": null,
  "author_org": null,
  "posted_at": null,
  "platform": null,
  "cast": null
}

常见用例

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

按爱奇艺内容分类搜索，分清热度与播放量

用 search 发现电影、电视剧或综艺候选，再核对视频与专辑关系。

查看 search 的 category 参数 →

keyword 查视频内容；category 中 movie、tv_series、variety_shows、documentary 分别是电影、电视剧、综艺和纪录片，不能当作演员标签。sort 用 relevance、newest、popular；published / publish_date 是发布时间窗，不是布尔值或 YYYY-MM-DD 日期，同时出现时优先 published。
id / url 对应内容，album_id / album_url 对应关联专辑；text 是简介，不是语音转写。heat_count 是爱奇艺的综合热度，不是播放量；rating、rating_count、like_count、comment_count 分别保留，缺失计数不补零，也不假定每条搜索记录都有完整互动信息。

读取爱奇艺播放页的单条视频详情

用 video 查看内容与上传者元数据，不把专辑页或创作者主页混进来。

查看 video 的 url 参数 →

url 使用 iqiyi.com 的 v_*.html 播放页，不是 a_*.html 专辑页或创作者主页；title、album_title 与 author_name 分别描述视频、所属专辑和上传者。category / sort 即使列在参数表，也不能改变一个指定视频的排列顺序。
heat_count 与 comment_count 只是热度和评论数量，不返回评论正文；author_avatar_url 来自上传者头像，不是评论者头像。duration_seconds 按实际返回类型读取，本页没有视频下载、字幕或语音转写 action，也没有独立创作者 profile 查询。

按剧名检索爱奇艺国际站专辑与分集

用 album 整理剧集、分集列表与人物表，保持语言和片库地区分别可控。

查看 album 的 region 参数 →

keyword 填剧名或专辑关键词，album 不是专辑 URL 直接查询。region 选片库地区，如 intl 国际库、tw 台湾、th 泰国；lang 用 zhcn / zhtw / enus 等紧凑代码，language 用 zh_cn / zh_tw / en_us 等兼容代码，两个同时提供时以 lang 为准。这些语言参数控制标题文案，不请求字幕翻译。
episodes 是分集数组，最多保留 200 项；每集有自己的 id、order、name、url 与 release_date。cast 是人物列表，其中 role 可能表示主演、演员、导演等人物类别，不是剧中饰演角色；episode_available_count 当前按最大分集序号映射，不能直接当作可看集数或凭与 episode_count 的差值判断完结。元数据存在不保证当前地区或会员权限能够播放。

爱奇艺 API 常见问题

爱奇艺 API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="iqiyi"、action 和 params。以 search 为例，必填 keyword，可选 category、publish_date、published、quality。按节目或视频主题检索；没有在公开清单中的筛选项不要直接传入。爱奇艺共 3 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

爱奇艺 API 怎么收费？

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

爱奇艺 API 一次能返回多少条数据？

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

爱奇艺 API 返回哪些字段？

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

「按爱奇艺内容分类搜索，分清热度与播放量」怎样接入爱奇艺 API？

用 search 发现电影、电视剧或综艺候选，再核对视频与专辑关系。 keyword 查视频内容；category 中 movie、tv_series、variety_shows、documentary 分别是电影、电视剧、综艺和纪录片，不能当作演员标签。sort 用 relevance、newest、popular；published / publish_date 是发布时间窗，不是布尔值或 YYYY-MM-DD 日期，同时出现时优先 published。 id / url 对应内容，album_id / album_url 对应关联专辑；text 是简介，不是语音转写。heat_count 是爱奇艺的综合热度，不是播放量；rating、rating_count、like_count、comment_count 分别保留，缺失计数不补零，也不假定每条搜索记录都有完整互动信息。

「读取爱奇艺播放页的单条视频详情」怎样接入爱奇艺 API？

用 video 查看内容与上传者元数据，不把专辑页或创作者主页混进来。 url 使用 iqiyi.com 的 v_*.html 播放页，不是 a_*.html 专辑页或创作者主页；title、album_title 与 author_name 分别描述视频、所属专辑和上传者。category / sort 即使列在参数表，也不能改变一个指定视频的排列顺序。 heat_count 与 comment_count 只是热度和评论数量，不返回评论正文；author_avatar_url 来自上传者头像，不是评论者头像。duration_seconds 按实际返回类型读取，本页没有视频下载、字幕或语音转写 action，也没有独立创作者 profile 查询。

「按剧名检索爱奇艺国际站专辑与分集」怎样接入爱奇艺 API？

用 album 整理剧集、分集列表与人物表，保持语言和片库地区分别可控。 keyword 填剧名或专辑关键词，album 不是专辑 URL 直接查询。region 选片库地区，如 intl 国际库、tw 台湾、th 泰国；lang 用 zhcn / zhtw / enus 等紧凑代码，language 用 zh_cn / zh_tw / en_us 等兼容代码，两个同时提供时以 lang 为准。这些语言参数控制标题文案，不请求字幕翻译。 episodes 是分集数组，最多保留 200 项；每集有自己的 id、order、name、url 与 release_date。cast 是人物列表，其中 role 可能表示主演、演员、导演等人物类别，不是剧中饰演角色；episode_available_count 当前按最大分集序号映射，不能直接当作可看集数或凭与 episode_count 的差值判断完结。元数据存在不保证当前地区或会员权限能够播放。

可以先免费试用爱奇艺 API 吗？

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

Behance API B站 API Bluesky API Dailymotion API DeviantArt API Discord API 豆瓣 API 抖音 API 全部 89 平台 ↗

开始调用爱奇艺 API

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

免费开始

爱奇艺 API

爱奇艺 能力清单

爱奇艺 每个接口分别做什么

怎么调用 爱奇艺 关键词搜索 API？