EveryData platform API
iQIYI API
Documented iQIYI objects include search results, video pages, and international catalog albums with episodes and cast. The 3 actions (`search`, `video`, and `album`) keep iQIYI selectors and outputs separate.
On iQIYI, `search` queries public results via `keyword`, while `video` fetches a single public video via `url`. Neither action accepts undeclared filters.
- Endpoint
- POST /api/v1/social
- Capabilities
- 3
- Per 1,000
- $1.389
Available capabilities
Compare the iQIYI actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search public results on iQIYI. Accepts these parameters: | keyword | category, publish_date, published, 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 · 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 |
videoVideo details Retrieve a public video from iQIYI. Accepts these parameters: | url | category, sort | Sync delivery | — | $1.39 per 1,000 requests | 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 |
albumAlbum Retrieve a public album from iQIYI. Accepts these parameters: | 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 · rating · rating_scale · content_rating · episode_count · episode_available_count · image_url · episodes · cast · platform · order · name · role |
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.
What do the iQIYI search parameters mean?
Search public results on iQIYI. Accepts these parameters: keyword, publish_date, sort, category, and published. Returns these fields: author_name, text, category, and album_url.
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 CountiQIYI'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 yields precedence to published when both are present.
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.
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?
Retrieve a public video from iQIYI. Accepts these parameters: category, sort, and url. Returns these fields: album_episode_count, category_id, heat_count, and wide_image_url.
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.
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 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 album parameters mean?
Retrieve a public album from iQIYI. Accepts these parameters: keyword, region, language, and lang. Returns these fields: subtitle, is_series, episode_available_count, and episodes.
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- Provides compatibility input for title localization in the album action, accepting 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 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. Unrecognized values fall back to intl. This parameter changes the regional media catalog rather than the interface language.Allowed values:
idintljpkrmyphsgthtwvniQIYI International: Regional Copyright Restrictions and Active LibraryiQIYI 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 selected action is asynchronous.
- 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 source record, and every other action has its own field list.
Does every iQIYI action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.