# 爱奇艺 关键词搜索 API (iqiyi.search)

- Canonical page: [https://everyinfra.com/iqiyi-api/search](https://everyinfra.com/iqiyi-api/search?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "iqiyi", "action": "search", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 50 per call
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=iqiyi&action=search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | 爱奇艺视频搜索词，用于返回视频结果；不是剧集专辑的直接详情查询。 |
| category | enum: advertisement / all / animation / beauty / car / comedy / documentary / entertainment / fashion / finance / game / health / life / military / mother_baby / movie / music / news_info / originals / short_films / sports / square_dance / talk_shows / technology / trailers / travel / trending / tv_series / variety_shows | no | not declared | 视频内容分类。movie 电影、tv_series 电视剧、variety_shows 综艺、animation 动画、documentary 纪录片等；其余包括广告、汽车、美妆、娱乐、财经、游戏、健康、生活、军事、母婴、音乐、新闻、原创、短片、体育、广场舞、访谈、科技、预告、旅游、热门与时尚，按本接口允许值选择，all 为不限。不是演员或剧集标签。 |
| publish_date | not declared | no | not declared | search 发布时间窗：all 不限、last_24_hours 最近 24 小时、last_7_days 最近 7 天、last_30_days 最近 30 天。不是 YYYY-MM-DD 日期；published 同时存在时优先 published。 |
| published | not declared | no | not declared | publish_date 的优先输入，取 all / last_24_hours / last_7_days / last_30_days；它不是“是否已发布”的布尔值，不能传 true/false。 |
| quality | not declared | no | not declared | search 的画质条件文本；常见值：all 不限、hd 高清、ultra_hd 超清、720p、1080p。它不是下载或转码选项；未列出的值可能不起筛选作用。 |
| scrape_additional_info | not declared | no | not declared | 是否为爱奇艺搜索结果读取额外上传者与互动信息，传 JSON 布尔值，默认 true。false 会关闭这部分读取，但不改变 EveryInfra API 单价。 |
| site | not declared | no | not declared | search 的视频站点条件文本；常见值：all、iqiyi、tencent_video、sohu、youku、tudou、acfun、bilibili、ifeng、cntv、m1905。它只限定搜索结果的来源站点，不代表这些站点都有详情接口。 |
| sort | enum: newest / popular / relevance | no | not declared | 爱奇艺视频搜索顺序：relevance 相关度、newest 最新、popular 热门；不是电影评分或分集播放顺序。 |
| limit | integer (1–50) | no | 20 | 这次调用最多返回的条数，整数，1–50；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
| url | 该记录在原平台上的可访问链接。 |
| title | 标题。平台无标题概念时（如纯文本帖）为 null。 |
| text | 正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。 |
| category | 分类名称，取值为原平台的分类体系，未做跨平台归一。 |
| category_id | 分类 ID。 |
| duration_seconds | 时长，单位秒。非视频/音频内容为 null。 |
| duration_sec | platform-native meaning |
| 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 | 上传者头像（search / video）。 |
| author_follower_count | 作者粉丝数。null 表示不公开。 |
| author_video_count | 作者发布视频数。 |
| author_location | 上传者所在地，按页面原文（search / video）。 |
| author_org | 认证机构名（机构号用）。 |
| posted_at | 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |
| cast | 演员表。 |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "iqiyi",
  "action": "search",
  "params": {
    "keyword": "纪录片"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "iqiyi",
        "action": "search",
        "params": {
            "keyword": "纪录片",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-10-24T18:28:34Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "iqiyi",
  "action": "search",
  "results": [
    {
      "id": "•••",
      "url": "https://qy.net/63KmTun-1f",
      "title": "大黄蜂捕食蜜蜂，实力碾压 #好奇昆虫 #动物世界 #纪录片",
      "category": "纪录片",
      "category_id": 3,
      "duration_seconds": 82,
      "heat_count": 123,
      "like_count": 0,
      "comment_count": 0,
      "collect_count": 0,
      "image_url": "https://m.iqiyipic.com/u1/image/20261024/cb/27/pv_8409605938704600_d_601_m1_120_160.jpg",
      "wide_image_url": "https://m.iqiyipic.com/u1/image/20261024/cb/27/pv_8409605938704600_d_601_m1_480_270.jpg",
      "author_name": "•••",
      "author_id": "•••",
      "author_avatar_url": "https://img7.iqiyipic.com/•••",
      "author_follower_count": 529,
      "author_video_count": 52,
      "author_location": "河南",
      "author_org": "漯河市郾城区芝芝文化传媒工作室（个体工商户）",
      "posted_at": "2026-10-24T15:30:00+00:00",
      "platform": "iqiyi",
      "duration_sec": 82
    },
    {
      "id": "•••",
      "url": "https://qy.net/f6KjGub-7c",
      "title": "听说过日本姓氏奇葩，没想到这么奇葩 #搞笑 #大型纪录片 ",
      "category": "搞笑",
      "category_id": 22,
      "duration_seconds": 98,
      "heat_count": 7,
      "like_count": 0,
      "comment_count": 0,
      "collect_count": 0,
      "image_url": "https://m.iqiyipic.com/u1/image/20261024/64/15/pv_1225408606708600_d_601_m1_120_160.jpg",
      "wide_image_url": "https://m.iqiyipic.com/u1/image/20261024/64/15/pv_1225408606708600_d_601_m1_480_270.jpg",
      "author_name": "•••",
      "author_id": "•••",
      "author_avatar_url": "https://img7.iqiyipic.com/•••",
      "author_follower_count": 217,
      "author_video_count": 156,
      "author_location": "河南",
      "author_org": "漯河市郾城区芝芝文化传媒工作室（个体工商户）",
      "posted_at": "2026-10-24T10:40:00+00:00",
      "platform": "iqiyi",
      "duration_sec": 98
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=iqiyi
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
