EveryInfra

社交内容 · 数据 API

爱奇艺

爱奇艺 API

剧集、专辑与视频条目——中文长视频内容库与排播观察。POST /api/v1/social 就行,返回结构化 JSON,$1.39 / 千次/次、失败不计费。

3

个能力

$1.39 / 千次

每次调用

秒级

响应

1 个

API Key 通 87 平台

爱奇艺 能力清单

action必填参数可选参数单次条数模式单价 / 次返回字段
searchkeywordcategory, publish_date, published, 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
videourlcategory, sort同步$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
albumkeywordlang, 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 · order · name · role

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

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 只需切换 action

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

search

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

keyword必填
检索关键词。
category可选
分类筛选。取值随平台而异,见该能力的 allowed_values。

允许值很多,示例:advertisement、all、animation、beauty、car、comedy、documentary、entertainment、fashion、finance、game、health在机器目录查看全部 29 个值

publish_date可选
按发布日期筛选。
published可选
是否已发布。
sort可选
排序方式。取值随平台而异,见该能力的 allowed_values。
查看全部 3 个允许值

newestpopularrelevance

爱奇艺 特有返回字段与含义(11
album_id
剧集/专辑 ID。爱奇艺把一部剧叫「专辑」,单集是其下的视频。
album_title
剧集名称。
album_url
剧集链接。
album_episode_count
总集数。
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 等 29 个字段

url必填
目标页面的完整链接,直接从该平台复制。
category可选
分类筛选。取值随平台而异,见该能力的 allowed_values。

允许值很多,示例:advertisement、all、animation、beauty、car、comedy、documentary、entertainment、fashion、finance、game、health在机器目录查看全部 29 个值

sort可选
排序方式。取值随平台而异,见该能力的 allowed_values。
查看全部 3 个允许值

newestpopularrelevance

爱奇艺 特有返回字段与含义(11
album_id
剧集/专辑 ID。爱奇艺把一部剧叫「专辑」,单集是其下的视频。
album_title
剧集名称。
album_url
剧集链接。
album_episode_count
总集数。
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 等 22 个字段

keyword必填
检索关键词。
lang可选
内容语言,ISO 639-1 代码(如 zh、en)。
查看全部 11 个允许值

arsaenusesesididjajpkokrmsmyththvivnzhcnzhtw

language可选
语言,取值格式随平台而异(可能是 en 也可能是 en-US)。
查看全部 11 个允许值

ar_saen_uses_esid_idja_jpko_krms_myth_thvi_vnzh_cnzh_tw

region可选
地区。取值可能是国家码也可能是平台自有的地区标识,见 allowed_values。
查看全部 10 个允许值

idintljpkrmyphsgthtwvn

爱奇艺 特有返回字段与含义(12
episode_count
集数。
episode_available_count
当前可看集数。连载中会小于总集数,判断完结看这两个字段之差。
episodes
分集列表。
is_series
是否为剧集(相对单片)。
cast
演员表。
role
角色名。
year
年份。
release_date
上线日期。
content_rating
内容分级。
subtitle
副标题。
order
序号。
play_url
播放页链接。
爱奇艺 search 调用流程一次 爱奇艺 search 调用的全过程:向 POST /api/v1/social 发送 platform="iqiyi"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、title、text、category 等字段;单次最多 50 条,计费 $1.39 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "iqiyi"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 最多 50 条idurltitletextcategory
一次 爱奇艺 search 调用的全过程:向 POST /api/v1/social 发送 platform="iqiyi"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、title、text、category 等字段;单次最多 50 条,计费 $1.39 / 千次,失败与空结果不计费。

爱奇艺 原始字段名

EveryInfra 统一字段名

左边是 爱奇艺 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。右边这一列在 87 个平台上是同一套—— 换平台时只改请求里的 platform 一个字段, 解析代码一行不用动。

只有 爱奇艺 返回的字段

全站 87 个平台里,这 12 个字段只有 爱奇艺 会返回——换别的平台拿不到这些数据。 字段名与其余平台同样遵循 snake_case 命名,解析方式一致。

  • 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
  • order

返回字段含义

字段名跨 87 个平台统一,同一个键在哪个平台都是同一个意思—— 这也是换平台只需改 platform 一个字段的原因。 机器可读版:/api/v1/social/fields

id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
url
该记录在原平台上的可访问链接。
title
标题。平台无标题概念时(如纯文本帖)为 null。
text
正文内容,已去除 HTML 标签。长文可能被截断。
category
分类名称,取值为原平台的分类体系,未做跨平台归一。
duration_seconds
时长,单位秒。非视频/音频内容为 null。
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。
image_url
图片链接。多图能力可能返回 image_urls 数组。
author_name
作者昵称(显示名)。
author_id
作者在原平台的唯一 ID。
author_follower_count
作者粉丝数。null 表示不公开。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
type
记录类型,取值随能力而定(如 video / image / text)。
name
名称。用于账号/商品/商家类能力,指该对象本身的名字。

另有 爱奇艺 特有字段 category_id · heat_count · album_id · album_title · album_url · album_episode_count · wide_image_url · author_avatar_url · author_video_count · author_location · author_org · play_url · subtitle · is_series · year · release_date · content_rating · episode_count · episode_available_count · episodes · cast · order · role,保留该平台自身的语义。

30 秒调用示例

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":"咖啡"}}'

返回长这样

response.json
{
  "id": "iqiyi_…",
  "search": [
    {
      "id": "…",
      "url": "https://…",
      "title": "…",
      "text": "…",
      "category": "…",
      "category_id": "…",
      "duration_seconds": "…",
      "heat_count": 128,
      "rating": 128,
      "rating_scale": "…",
      "rating_count": 128,
      "like_count": 128,
      "comment_count": 128,
      "collect_count": 128,
      "album_id": "…",
      "album_title": "…",
      "album_url": "https://…",
      "album_episode_count": 128,
      "image_url": "https://…",
      "wide_image_url": "https://…",
      "author_name": "…",
      "author_id": "…",
      "author_avatar_url": "https://…",
      "author_follower_count": 128,
      "author_video_count": 128,
      "author_location": "…",
      "author_org": "…",
      "posted_at": "2026-08-01T09:30:00Z",
      "platform": "iqiyi"
    }
  ],
  "count": 20,
  "billing": { "charged": true, "credits": 100, "cny": 0.009356 }
}

常见用例

关键词监控

按关键词轮询 爱奇艺 的新内容,配合 Gemini 文本 API 做情绪分类与异常波动告警。

舆情监控

品牌词与竞品词轮询,情绪聚类,异常波动告警。

爱奇艺 API 常见问题

爱奇艺 API 怎么调用?

调 POST /api/v1/social,请求体传 platform="iqiyi"、action 和 params。以 search 为例,必填 keyword,可选 category、publish_date、published、sort。爱奇艺 共 3 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 87 个平台。

爱奇艺 API 怎么收费?

$1.39 / 千次/次,爱奇艺 全部 3 个能力同价。$1 免费额度约等于 719 次 爱奇艺 调用。一次调用一次计费,不按条数或页数加价;参数错误、鉴权失败和空结果都不计费。

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

最多的是 search,单次上限 50 条(默认 20 条)。另外 1 个能力返回单个对象,没有条数概念。传 limit 控制,一次调用就返回这么多,不需要翻页也不多收钱。

爱奇艺 API 返回哪些字段?

search 返回 id、url、title、text、category、category_id 等 29 个字段。其中 12 个字段只有 爱奇艺 会返回(见上方「独有字段」)。字段名跨平台统一,换平台不用改解析代码。

爱奇艺怎么按关键词批量采集?

调 POST /api/v1/social,传 platform="iqiyi"、action="search",必填参数 keyword。单次最多 50 条,一次调用一次计费、不按条数加价;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,关键词搜索字段为 id、url、title、text、category。

爱奇艺视频详情怎么用接口取?

调 POST /api/v1/social,传 platform="iqiyi"、action="video",必填参数 url。返回单个对象,没有条数上限;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,视频详情字段为 id、url、title、text、category。

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

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用或 576 次 AI 调用),足够把 爱奇艺 的 3 个能力都试一遍。无需信用卡。

开始调用 爱奇艺 API

加微信领 $1 免费额度 —— ≈720 次数据调用或 576 次 AI 调用,足够把 爱奇艺 的能力全试一遍。

免费开始