iQIYI Album Profile & Channel Ranking Scraper

iQIYI (iq.com) is the international home of Chinese, Korean, Thai and other Asian dramas, movies, anime and variety shows. This actor reads the public catalogue without an account and returns album profiles with released episode lists, the current hot lists for four channels, eight ranking boards, a weekly top 10, full title search results across regional catalogues, and the autocomplete suggestions from iQIYI's own search box.

What this actor does

• Album profiles: look up a title by slug, album URL, play URL or numeric album ID and get its score, release year, age rating, genres, licensed regions, cast with roles, directors and every currently released episode with a direct play link.
• Full title search: search the international catalogue, or one of eight regional catalogues, in seven metadata languages. Results include episodes, cast and optional album-level score/description enrichment.
• Rankings: pull the hot list for Drama, Movie, Anime or Variety (up to 30 titles each), the eight global charts (hot, anticipated, rising, must-watch and four curated picks), or the weekly top 10 with view counts.
• Legacy modes: the original search-box suggestions and channel-ranking modes still work for saved tasks.
• Clean records: empty fields are omitted, image URLs are normalized, dates are ISO, scores are numeric, and IDs are kept as iQIYI publishes them.

Output per mode

byId — album profile

• albumId, qipuId — slug and internal content ID
• title, subtitle, alterTitle — title variants
• description — synopsis
• releaseYear, releaseStatus, type, isSeries — release and content type
• score, scoreVotes, contentRating — user score, vote count and age rating
• totalEpisodes, releasedEpisodeCount, episodes[] — planned count, released count, and episode rows (order, name, episodeId, url, publishDate, durationSeconds, plus subtitle when published)
• durationMinutes — runtime for a movie, or the first released episode's runtime
• channelId — 1 Movie, 2 TV series, 4 Anime, 6 Variety show
• TypeDsj, SubjectMatter, Language, Place, Adaptation — tag groups
• genres, tags — flattened genre and tag lists
• starring, cast[], creator, directors[] — cast and directors; cast rows include name, role, character and profileUrl when published
• posterUrl, bannerUrl — portrait and landscape artwork
• availableRegions — countries where the title is licensed
• audioLanguages — published audio tracks
• isPremium, isFinished, isExclusive, isQiyiProduced — availability flags
• playUrl, iqiyiUrl, sourceUrl — direct play and album links
• recordType: "album", scrapedAt

rankings — channel and global rankings

• rankingType — top10, hot, anticipated, rising, mustWatch, dramaPicks, moviePicks, animePicks, varietyPicks, channelDrama, channelMovie, channelAnime, channelVariety
• rank — 1-based position
• title, qipuId, albumId, channelId
• score, contentRating, year, tags[]
• updateText, episodeCount, description
• weeklyViews — top-10 only
• posterUrl, thumbnailUrl, albumUrl, playUrl
• isPremium, recordType: "ranking", scrapedAt

searchTitles — full search results

• query, rank, title, albumId, qipuId
• type, channelId, isSeries, year, publishDate
• score, contentRating, description, tags[] — present when details are included
• episodeCount, releasedEpisodeCount, episodes[]
• cast[], directors[]
• posterUrl, thumbnailUrl, albumUrl, playUrl
• isPremium, recordType: "searchResult", scrapedAt

search — suggestions (legacy)

• suggestion, sourceUrl, recordType: "suggestion", scrapedAt

trending — channel ranking (legacy)

Keeps the original fields name, qipuId, albumId, publishDate, posterUrl, iqiyiUrl, sourceUrl, recordType, scrapedAt, and includes rank, rating, contentRating, year, tags, updateText and episodeCount where available. playCount is omitted because intl iq.com does not publish cumulative play counts.

Input

Field	Type	Default	Description
mode	string	byId	byId, searchTitles, rankings, search (legacy suggestions), trending (legacy channel ranking)
albumIds	array	[]	Album slugs, album URLs, play URLs or numeric IDs (mode=byId)
searchQueries	array	["love"]	Keywords or iq.com search URLs (mode=searchTitles)
searchQuery	string	love	Suggestion text (mode=search)
region	string	intl	intl, vn, th, id, my, ph, sg, kr, jp (mode=searchTitles)
language	string	en_us	en_us, zh_cn, zh_tw, th_th, vi_vn, id_id, ms_my (mode=searchTitles)
includeDetails	boolean	true	Add score, description, genres, age rating and cast roles to search rows
includeEpisodes	boolean	true	Include released episode lists
rankingType	string	top10	One of the 13 ranking types (mode=rankings)
channelId	string	2	0 Top, 1 Movie, 2 Series, 4 Anime, 6 Variety (mode=trending)
maxItems	integer	25	Hard cap on emitted records (1–1000)

Example: three album profiles

{
  "mode": "byId",
  "albumIds": [
    "genius-girlfriend-2026-28fzrln6il1",
    "fated-hearts-2025-d6iyehcx4p",
    "a-better-jianghu-2026-1qi696xihh0"
  ],
  "includeEpisodes": true,
  "maxItems": 3
}

Example: full search in a regional catalogue

{
  "mode": "searchTitles",
  "searchQueries": ["love", "revenge"],
  "region": "th",
  "language": "th_th",
  "includeDetails": true,
  "includeEpisodes": true,
  "maxItems": 30
}

Example: drama channel hot list

{
  "mode": "rankings",
  "rankingType": "channelDrama",
  "maxItems": 30
}

Example: weekly top 10

{
  "mode": "rankings",
  "rankingType": "top10",
  "maxItems": 10
}

Example: legacy suggestions

{
  "mode": "search",
  "searchQuery": "love",
  "maxItems": 10
}

Use cases

• Build a catalogue of iQIYI dramas, movies, anime and variety shows with scores, genres and cast.
• Track which titles are on a channel hot list, a global chart or the weekly top 10 over time.
• Enrich a recommendation database with released episodes, cast roles and play links.
• Research regional catalogue differences across nine iQIYI markets.
• Monitor a genre or franchise with scheduled searches and deduplicated results.
• Check a title's licensed regions and premium status before planning a release.

FAQ

Is this affiliated with iQIYI?

No. This is an independent actor that reads public iQ.com pages and catalogue data. It is not endorsed by or connected to iQIYI.

Do I need an iQIYI account or subscription?

No. No login, cookie or API key is required.

Why are some fields missing from a record?

iQIYI does not publish every field for every title. Anime and some variety shows often have no cast list, unreleased shows have no episodes yet, and some titles have no description. Missing fields are omitted rather than sent as null or empty values.

Why are there fewer episodes than totalEpisodes?

totalEpisodes is the planned episode count. The episodes array contains episodes that are currently released and listed by iQIYI. Ongoing shows can have a planned count above the released count, and some unreleased titles publish no episode list at all, so episodes is omitted even though totalEpisodes is present.

Why is there no play count?

The international iq.com catalogue does not expose a cumulative play count. The weekly top-10 ranking does include weeklyViews, and that is the only view metric included.

Which regions and languages are supported?

Search supports the international catalogue plus Vietnam, Thailand, Indonesia, Malaysia, the Philippines, Singapore, South Korea and Japan. Metadata languages are English, Simplified and Traditional Chinese, Thai, Vietnamese, Indonesian and Malay. Other iQIYI languages and the Taiwan region currently return no search results, so they are not offered.

How many search results can one query return?

It depends on the query. Popular terms can return several hundred unique titles (currently around 400 for broad terms); narrow terms can return only a handful. The actor follows iQIYI's pages until they stop adding new titles and never promises the catalogue's reported total.

Why are there only four channel hot lists?

The international catalogue publishes hot lists for Drama, Movie, Anime and Variety. Kids and documentary channels redirect to the home page and have no equivalent list. The eight global charts and the weekly top 10 cover the rest of the catalogue.

Do I need to configure a proxy?

No. The actor connects directly to iq.com without a proxy; no proxy configuration is needed. Just fill in the input and run it.

How current is the data?

Every run reads iQIYI live, so scores, rankings, episodes and availability reflect what iq.com shows at run time.