Platform availability
- 24h health
- Normal
Last 30 days
Available capabilities
Each iQIYI action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000 | 24-hour health |
|---|---|---|---|
Searchsearch | Search iQIYI shows and videos by keyword, filtered by category, publish window, quality, source site or sort, with duration, heat value, rating, series and cast. | $1.39 per 1,000 requests | Normal |
Video detailsvideo | Read one iQIYI video from its playback url, with title, category, duration, publish date, heat value, rating, series details, cast and uploader. | $1.39 per 1,000 requests | Normal |
Albumalbum | Locate a series or film in iQIYI's international catalog by title or cast name, with episode list, total and available episodes, year, release date, rating and content rating. | $1.39 per 1,000 requests | Normal |
Open a capability for its parameters, response fields, code samples and trial.
What does each iQIYI action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search iQIYI shows and videos by keyword, filtered by category, publish window, quality, source site or sort, with duration, heat value, rating, series and cast. | keyword | category, publish_date, published, quality, scrape_additional_info, site, sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · title · text · category · category_id · duration_seconds · duration_sec · 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 |
videoVideo details Read one iQIYI video from its playback | url | scrape_additional_info | Sync delivery | — | $1.39 per 1,000 requests | id · url · title · text · category · category_id · duration_seconds · duration_sec · 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 |
albumAlbum Locate a series or film in iQIYI's international catalog by title or cast name, with episode list, total and available episodes, year, release date, rating and content rating. Catalogs differ by the library chosen in | keyword | lang, language, region | Sync delivery | Catalog values: defaultLimit=10, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · play_url · title · subtitle · type · is_series · year · release_date · duration_seconds · duration_sec · rating · rating_scale · content_rating · episode_count · episode_available_count · image_url · episodes · cast · platform |
What do the iQIYI search parameters mean?
Search iQIYI shows and videos by keyword, filtered by category, publish window, quality, source site or sort, with duration, heat value, rating, series and cast. heat_count is iQIYI's own popularity score, not a play count, and cannot be compared across platforms.
keywordRequired- 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.iQIYI: Difference Between Content Heat and On-Site Play Count — iQIYI's 2018 announcement explains content heat as a composite metric covering views, interactions, and shares, distinguishing it from play count. This only explains the metric type for heat_count and does not extrapolate current algorithms, thresholds, or cross-platform comparability, nor does it deduce actual play count from heat. · Checked
categoryOptional- 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.Allowed values:
advertisementallanimationbeautycarcomedydocumentaryentertainmentfashionfinancegamehealthlifemilitarymother_babymoviemusicnews_infooriginalsshort_filmssportssquare_dancetalk_showstechnologytrailerstraveltrendingtv_seriesvariety_shows publish_dateOptional- 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.
publishedOptional- 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.
qualityOptional- 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_infoOptional- 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.
siteOptional- 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.
sortOptional- 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.Allowed values:
newestpopularrelevance
What do the iQIYI video parameters mean?
Read one iQIYI video from its playback url, with title, category, duration, publish date, heat value, rating, series details, cast and uploader. Pass a single-video playback link; series pages and creator profiles are not supported, so use album to find a series.
urlRequired- Accepts a full iQIYI video playback URL (v_*.html format) for the video action. Series/album pages (a_*.html) and creator profile links are not supported; use the album action with keyword for series discovery.
scrape_additional_infoOptional- 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.
What do the iQIYI album parameters mean?
Locate a series or film in iQIYI's international catalog by title or cast name, with episode list, total and available episodes, year, release date, rating and content rating. Catalogs differ by the library chosen in region, and playback access is not guaranteed.
keywordRequired- 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.
langOptional- Sets title display language for the album action using compact codes: zhcn, zhtw, enus, jajp, arsa, eses, idid, kokr, msmy, thth, or vivn. This parameter modifies localized metadata labels without requesting video subtitles or altering content library regions.Allowed values:
arsaenusesesididjajpkokrmsmyththvivnzhcnzhtw languageOptional- Accepts a compatibility language code for title localization in the album action: zh_cn (default), zh_tw, en_us, id_id, ms_my, th_th, vi_vn, ko_kr, ja_jp, es_es, or ar_sa. When both this parameter and lang are supplied, lang takes precedence; do not mix code formats across the two parameters.Allowed values:
ar_saen_uses_esid_idja_jpko_krms_myth_thvi_vnzh_cnzh_tw regionOptional- Selects the content library region for the album action: intl (default), vn, th, id, my, tw, ph, sg, kr, or jp. Any other value returns 422. This parameter changes the regional media catalog rather than the interface language.Allowed values:
idintljpkrmyphsgthtwvniQIYI International: Regional Copyright Restrictions and Active Library — iQIYI International help FAQs on copyright restrictions explain that regional licensing may prevent content playback and external search results may not reflect the active library. Therefore, album region options and retrieved metadata do not constitute a playback entitlement guarantee, let alone a method to bypass regional restrictions. · Checked
How to use the iQIYI API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result, or poll the returned job ID when the action runs asynchronously.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"iqiyi","action":"search","params":{"keyword":"<keyword>"}}'
iQIYI API questions
What can I retrieve with the iQIYI API?
Set platform to iqiyi. The current catalog lists search, video details, and album. These action names identify different iQIYI objects or views; they are not interchangeable search modes.
Which input starts a iQIYI `search` request?
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. Send it as keyword inside params.
Which fields can iQIYI `search` return?
Its declared schema includes title, text, category, and category_id. A declared field can still be absent from an individual record, and every other action has its own field list.
Does every iQIYI action return immediately?
Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.