# 爱奇艺 专辑 API (iqiyi.album)

- Canonical page: [https://everyinfra.com/iqiyi-api/album](https://everyinfra.com/iqiyi-api/album?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "iqiyi", "action": "album", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 10, 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=album

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | 爱奇艺国际站剧集或专辑搜索词，用于返回专辑、分集和演员信息；该动作不接受专辑 URL。 |
| lang | enum: arsa / enus / eses / idid / jajp / kokr / msmy / thth / vivn / zhcn / zhtw | no | not declared | album 的标题语言，使用本接口列出的紧凑代码，如 zhcn 简体中文、zhtw 繁体中文、enus 英语、jajp 日语。不是字幕翻译请求，也不控制片库地区。 |
| language | enum: ar_sa / en_us / es_es / id_id / ja_jp / ko_kr / ms_my / th_th / vi_vn / zh_cn / zh_tw | no | not declared | 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 为准，两个参数的格式不能混用。 |
| region | enum: id / intl / jp / kr / my / ph / sg / th / tw / vn | no | not declared | album 片库地区只接受 intl（国际库，省略时默认）、vn（越南）、th（泰国）、id（印尼）、my（马来西亚）、tw（台湾）、ph（菲律宾）、sg（新加坡）、kr（韩国）或 jp（日本）。其他显式值会在公开 API 参数校验阶段返回 422；它不是页面语言选择。 |
| limit | integer (1–50) | no | 10 | 这次调用最多返回的条数，整数，1–50；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
| url | 该记录在原平台上的可访问链接。 |
| play_url | 播放页链接。 |
| title | 标题。平台无标题概念时（如纯文本帖）为 null。 |
| subtitle | 副标题。 |
| type | 记录类型，取值随能力而定（如 video / image / text）。 |
| is_series | 是否为剧集（相对单片）。 |
| year | 年份。 |
| release_date | 上线日期。 |
| duration_seconds | 时长，单位秒。非视频/音频内容为 null。 |
| duration_sec | platform-native meaning |
| rating | 评分。**分制随平台而异**，同一行的 `rating_scale` 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算。直接比数字会得出反的结论。 |
| rating_scale | 上一列 `rating` 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。 |
| content_rating | 内容分级。 |
| episode_count | 集数。 |
| episode_available_count | 当前可看集数。连载中会小于总集数，判断完结看这两个字段之差。 |
| image_url | 图片链接。多图能力可能返回 image_urls 数组。 |
| episodes | 分集列表。 |
| cast | 演员表。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |

## 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": "album",
  "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": "album",
        "params": {
            "keyword": "电影",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

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

```text
{
  "id": "req_…",
  "platform": "iqiyi",
  "action": "album",
  "results": [
    {
      "id": "•••",
      "play_url": "https://www.iq.com/play/%E5%B0%8F%E7%BE%8A%E8%82%96%E6%81%A9%E5%A4%A7%E7%94%B5%E5%BD%B1-2015-19rro5fml8?lang=zh_cn",
      "title": "小羊肖恩大电影",
      "type": "Movie",
      "is_series": false,
      "year": 2015,
      "release_date": "2015-07-17",
      "duration_seconds": 5103,
      "rating": 8.2,
      "content_rating": "13+",
      "image_url": "http://pic2.iqiyipic.com/image/20251202/cf/44/v_109440751_m_601_m11.jpg",
      "cast": [
        {
          "name": "贾斯汀·弗莱彻",
          "role": "mainActor",
          "url": "https://www.iq.com/star/%E8%B4%BE%E6%96%AF%E6%B1%80-%E5%BC%97%E8%8E%B1%E5%BD%BB-justin-fletcher-216368005?lang=zh_cn",
          "image_url": "http://pic4.iqiyipic.com/image/20250606/5c/6c/p_216368005_m_601.jpg"
        },
        {
          "name": "约翰·斯帕克斯",
          "role": "mainActor",
          "url": "https://www.iq.com/star/%E7%BA%A6%E7%BF%B0-%E6%96%AF%E5%B8%95%E5%85%8B%E6%96%AF-john-sparkes-216368105?lang=zh_cn",
          "image_url": "http://pic9.iqiyipic.com/image/20250606/a8/94/p_216368105_m_601.jpg"
        },
        {
          "name": "欧米德·吉亚李利",
          "role": "mainActor",
          "url": "https://www.iq.com/star/%E6%AC%A7%E7%B1%B3%E5%BE%B7-%E5%90%89%E4%BA%9A%E6%9D%8E%E5%88%A9-omid-djalili-214853005?lang=zh_cn",
          "image_url": "http://pic1.iqiyipic.com/image/20250613/a1/97/p_214853005_m_601_m1.jpg"
        }
      ],
      "platform": "iqiyi",
      "rating_scale": 10
    },
    {
      "id": "•••",
      "play_url": "https://www.iq.com/play/%E8%BF%98%E6%98%9F%E7%88%B7%E4%B8%80%E9%83%A8%E7%94%B5%E5%BD%B1-2017-19rr986tjo?lang=zh_cn",
      "title": "还星爷一部电影",
      "type": "Movie",
      "is_series": false,
      "year": 2017,
      "release_date": "2017-06-27",
      "duration_seconds": 3720,
      "rating": 4.5,
      "content_rating": "13+",
      "image_url": "http://pic5.iqiyipic.com/image/20220819/d4/9d/v_111181663_m_601_m7.jpg",
      "cast": [
        {
          "name": "闫志鹏",
          "role": "mainActor",
          "url": "https://www.iq.com/star/%E9%97%AB%E5%BF%97%E9%B9%8F-yan-zhi-peng-208619205?lang=zh_cn",
          "image_url": "http://pic6.iqiyipic.com/image/20250606/5e/02/p_208619205_m_601.jpg"
        },
        {
          "name": "杨能",
          "role": "actor",
          "url": "https://www.iq.com/star/%E6%9D%A8%E8%83%BD-yang-neng-232678205?lang=zh_cn",
          "image_url": "http://pic0.iqiyipic.com/image/20250605/ad/ba/p_232678205_m_601.jpg"
        },
        {
          "name": "张美娥",
          "role": "actor",
          "url": "https://www.iq.com/star/%E5%BC%A0%E7%BE%8E%E5%A8%A5-zhang-mei-e-231928105?lang=zh_cn",
          "image_url": "http://pic6.iqiyipic.com/image/20250605/6f/3b/p_231928105_m_601.jpg"
        }
      ],
      "platform": "iqiyi",
      "rating_scale": 10
    }
  ],
  "count": 10,
  "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
