# iQIYI Search API (iqiyi.search)

- Canonical page: [https://everyinfra.com/en/iqiyi-api/search](https://everyinfra.com/en/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

iQIYI Search finds videos on iQIYI by `keyword` and returns each result's title, description, category, length, heat value, rating, likes, comments and saves, plus the series it belongs to, posters, the `cast` and the uploader's details. Use it to see which films, series, shows and clips exist for a title or topic and how they are received, for content licensing research, entertainment market studies or tracking a show on iQIYI.

Narrow results with `category`, such as `movie`, `tv_series` or `variety_shows`, a time window with `publish_date`, and the order with `sort`. iQIYI calls a series an album and each episode a video, which is why the series fields start with album. `heat_count` is iQIYI's own popularity index, not a view count, and cannot be compared across platforms. `rating` is out of 10; check `rating_scale` on the row before you compare it with five-star sites.

## 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 | Specifies search terms for the search action, or series, album, and cast-member names for the international album action. The album action does not fetch details directly from album URLs, and available libraries vary by region. |
| 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 | Filters video content by category, accepting allowed values such as movie, tv_series, variety_shows, animation, documentary, advertisement, beauty, car, comedy, entertainment, fashion, finance, game, health, life, military, mother_baby, music, news_info, originals, short_films, sports, square_dance, talk_shows, technology, trailers, travel, trending, or all (unrestricted). This parameter filters broad categories rather than cast-member or series tags. |
| publish_date | not declared | no | not declared | Filters search action results by publication timeframe, accepting all, last_24_hours, last_7_days, or last_30_days. This field does not accept YYYY-MM-DD dates, and when both this field and published are present, published takes precedence. |
| published | not declared | no | not declared | Overrides publish_date in the search action, accepting all, last_24_hours, last_7_days, or last_30_days. This field is a string filter and does not accept boolean true/false values. |
| quality | not declared | no | not declared | Filters iQIYI search results by the requested video quality. Common values include all, hd, ultra_hd, 720p, and 1080p. It is not a download or transcoding option, and unlisted values may have no effect. |
| scrape_additional_info | not declared | no | not declared | Controls whether iQIYI search results include additional uploader and engagement information. Pass a JSON boolean; the default is true. Setting it to false disables that extra lookup but does not change the EveryInfra API price. |
| site | not declared | no | not declared | Provides a source-site condition for search. Common values include all, iqiyi, tencent_video, sohu, youku, tudou, acfun, bilibili, ifeng, cntv, and m1905. It narrows search results to those sites and does not mean each site has a detail action. |
| sort | enum: newest / popular / relevance | no | not declared | Controls sorting order for video search results, accepting relevance, newest, or popular. It does not sort by user ratings or episode release sequences, and has no effect when requesting a single video. |
| limit | integer (1–50) | no | 20 | The most rows to return in this call, an integer from 1 to 50. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| title | Title. null when the platform has no titles (for example text-only posts). |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| category | Category name in the platform's own taxonomy, not normalized across platforms. |
| category_id | platform-native meaning |
| duration_seconds | Duration in seconds. null for content that is not video or audio. |
| duration_sec | platform-native meaning |
| heat_count | platform-native meaning |
| rating | Rating. **The scale varies by platform**: rating_scale on the same row gives the maximum (usually 5; Booking, Douban, iQIYI and NAVER use 10). Convert with rating_scale before comparing across platforms, or the comparison can come out backwards. |
| rating_scale | Maximum of rating in the same row: 5 for five-star scales, 10 for ten-point scales. Present only when the row has a rating. |
| rating_count | Number of people who rated. null means not disclosed, not 0. |
| like_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
| comment_count | Comments. null means not disclosed, not 0. |
| collect_count | Saves or favorites. null means not disclosed, not 0. |
| album_id | platform-native meaning |
| album_title | platform-native meaning |
| album_url | platform-native meaning |
| album_episode_count | platform-native meaning |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| wide_image_url | platform-native meaning |
| author_name | Author's display name. |
| author_id | Author's unique ID on the platform. |
| author_avatar_url | platform-native meaning |
| author_follower_count | Author's follower count. null means not disclosed. |
| author_video_count | platform-native meaning |
| author_location | platform-native meaning |
| author_org | platform-native meaning |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| cast | platform-native meaning |

## 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": { … }
}
```

## FAQ

### Is `heat_count` the number of views?

No. It is iQIYI's own heat index, a platform metric rather than a count of plays, so figures from other platforms cannot be set against it. Use it to rank results within iQIYI, and read it with `rating` and `rating_count` when you judge how a title is received.

### How do I keep only films or TV series?

Set `category` to `movie` or `tv_series`; `variety_shows`, `animation` and `documentary` work the same way, and `all` removes the filter. `category` is a content type, not a cast or series tag. For recent uploads, set `published` or `publish_date` to a window such as last_7_days; `published` wins when both are sent, and neither takes a calendar date.

### How do I group episodes of the same series?

iQIYI files each episode as a video under a series it calls an album. Rows from one series share `album_id` and `album_title`, `album_episode_count` gives the series' total episodes, and `album_url` links to the series page, so you can roll episode figures up to the show.

## 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
