iQIYI API

iQIYI International (iq.com) is a major streaming platform with drama, movie, anime, and variety content. This API provides full access to all content with HLS streaming, multi-channel catalog browsing, and 16 language support.

Get Started Endpoints

▶

Full Access

All episodes unlocked

⚡

Smart Caching

Fast & efficient responses

🌐

16 Languages

Global subtitle coverage

API Key

Authentication

All iQIYI endpoints require the X-API-Key header except /health and /api/sources.

Rate Limits

Plan	Requests / min
Free	10
Monthly	5,000
Lifetime	Unlimited

Example Request

curl -H "X-API-Key: YOUR_KEY" \
{{BASE}}/api/iqiyi/trending

Supported Languages

Endpoints

GET /api/iqiyi/languages API Key

Returns list of 16 supported languages with codes and names.

Example

curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/iqiyi/languages"

GET /api/iqiyi/categories API Key

Returns available content channels (drama, kdrama, movie, anime, variety) and catalog filter options.

Example

curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/iqiyi/categories"

GET /api/iqiyi/trending API Key

Returns trending/ranking content across all channels. Background-warmed every 10 minutes for instant response.

Parameter	Type	Description
langoptional	string	Language code (default: `en`)

Example

curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/iqiyi/trending?lang=en"

lang

GET /api/iqiyi/foryou API Key

Returns personalized content recommendations.

Parameter	Type	Description
langoptional	string	Language code (default: `en`)

Example

curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/iqiyi/foryou?lang=id"

lang

GET /api/iqiyi/drama API Key

Drama channel — returns trending dramas or paginated catalog when page is provided. Also available as /kdrama, /movie, /variety.

Parameter	Type	Description
pageoptional	integer	Page number for catalog mode (omit for trending)
regionoptional	string	Region filter
sortoptional	string	Sort order
genreoptional	string	Genre filter
yearoptional	string	Year filter
suboptional	string	Subtitle filter
langoptional	string	Language code (default: `en`)

Example

curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/iqiyi/drama?page=1&lang=en"

page

region

genre

lang

GET /api/iqiyi/anime API Key

Anime channel — trending anime or paginated catalog with filters.

Parameter	Type	Description
pageoptional	integer	Page number for catalog mode
regionoptional	string	Region filter
sortoptional	string	Sort order
genreoptional	string	Genre filter
langoptional	string	Language code (default: `en`)

Example

curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/iqiyi/anime?page=1&lang=en"

page

genre

lang

GET /api/iqiyi/search?q={query} API Key

Search for dramas, movies, and anime across iQIYI catalog via Mobile API.

Parameter	Type	Description
qrequired	string	Search query
langoptional	string	Language code (default: `en`)

Example

curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/iqiyi/search?q=love&lang=en"

q (query)

lang

GET /api/iqiyi/browse API Key

Browse filtered content via Mobile API. Use /tags endpoint to get available filter values.

Parameter	Type	Description
cidoptional	string	Channel ID (default: `4`)
pageoptional	string	Page number (default: `1`)
categoryoptional	string	Category filter
captionoptional	string	Caption/subtitle filter
sortoptional	string	Sort order (default: `11`)
langoptional	string	Language code (default: `en`)

Example

curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/iqiyi/browse?cid=4&page=1&lang=en"

cid

page

category

sort

lang

GET /api/iqiyi/tags API Key

Returns available filter tags (genres, regions, sort options) for the browse endpoint.

Parameter	Type	Description
cidoptional	string	Channel ID (default: `4`)
langoptional	string	Language code (default: `en`)

Example

curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/iqiyi/tags?cid=4&lang=en"

cid

lang

GET /api/iqiyi/detail?id={id} API Key

Get detailed drama/movie metadata including episode list.

Parameter	Type	Description
idrequired	string	Drama slug or ID from search/trending
albumIdoptional	string	Album ID (auto-resolved if omitted)
langoptional	string	Language code (default: `en`)

Example

curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/iqiyi/detail?id=my-boss-is-a-psycho-1flw8l5o0p4&lang=en"

albumId

lang

GET /api/iqiyi/allepisode?id={id} API Key

Returns complete formatted episode list for a drama.

Parameter	Type	Description
idrequired	string	Drama slug or ID
albumIdoptional	string	Album ID (auto-resolved if omitted)
langoptional	string	Language code (default: `en`)

Example

curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/iqiyi/allepisode?id=my-boss-is-a-psycho-1flw8l5o0p4&lang=en"

albumId

lang

GET /api/iqiyi/episode?id={id}&ep={ep} API Key

Get HLS m3u8 stream URL and subtitles for a specific episode. All content is accessible including premium episodes.

Parameter	Type	Description
idrequired	string	Drama slug or ID
epoptional	integer	Episode number (default: `1`, use `0` for movies)
albumIdoptional	string	Album ID (auto-resolved if omitted)
langoptional	string	Language code (default: `en`)

Example

curl -H "X-API-Key: YOUR_KEY" "{{BASE}}/api/iqiyi/episode?id=my-boss-is-a-psycho-1flw8l5o0p4&ep=1&lang=en"

albumId

lang

CORS Proxy Setup

iQIYI CDN (data.video.iqiyi.com) enforces CORS restrictions and Referer checks. TS segments cannot be fetched directly from the browser. Use a CORS proxy below to play HLS streams.

Referer: https://www.iq.com/ User-Agent: Browser CORS: Access-Control-Allow-Origin: *

NGINX Reverse Proxy (Recommended)

Set up nginx as a CORS proxy for iQIYI CDN. Deploy on your server or localhost.

nginx.conf

server {
    listen 8888;
    server_name localhost;

    location /iqiyi-proxy/ {
        # Rewrite: /iqiyi-proxy/https://data.video...ts → proxy to actual URL
        if ($request_uri ~* "^/iqiyi-proxy/(.+)$") {
            set $target_url $1;
        }

        proxy_pass $target_url;
        proxy_set_header Host $proxy_host;
        proxy_set_header Referer "https://www.iq.com/";
        proxy_set_header User-Agent "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36";
        proxy_hide_header Access-Control-Allow-Origin;
        add_header Access-Control-Allow-Origin "*" always;
        add_header Access-Control-Allow-Methods "GET, OPTIONS" always;
        add_header Cache-Control "public, max-age=86400";

        # Handle preflight
        if ($request_method = OPTIONS) {
            add_header Access-Control-Allow-Origin "*";
            add_header Access-Control-Allow-Methods "GET, OPTIONS";
            add_header Content-Length 0;
            return 204;
        }
    }
}

NODE Node.js Express Proxy

Lightweight proxy using Node.js. Ideal for development or when nginx is not available.

proxy.js

const express = require('express');
const fetch = require('node-fetch');
const app = express();

app.use((req, res, next) => {
  res.header('Access-Control-Allow-Origin', '*');
  res.header('Access-Control-Allow-Methods', 'GET, OPTIONS');
  if (req.method === 'OPTIONS') return res.sendStatus(204);
  next();
});

// GET /proxy?url=https://data.video.iqiyi.com/...
app.get('/proxy', async (req, res) => {
  const url = req.query.url;
  if (!url) return res.status(400).send('url required');
  try {
    const resp = await fetch(url, {
      headers: {
        'Referer': 'https://www.iq.com/',
        'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36'
      }
    });
    res.set('Content-Type', resp.headers.get('content-type'));
    res.set('Cache-Control', 'public, max-age=86400');
    resp.body.pipe(res);
  } catch (e) { res.status(502).send(e.message); }
});

app.listen(8888, () => console.log('CORS proxy on :8888'));

How to Use

Call /api/iqiyi/episode to get the hlsUrl (m3u8 content)
Parse the m3u8 content — extract all TS segment URLs
Replace each TS URL with the proxy URL:
https://data.video.iqiyi.com/...ts → http://localhost:8888/proxy?url=https://data.video.iqiyi.com/...ts
Play the rewritten m3u8 using HLS.js or any video player

JS HLS.js Player Example

HLS.js integration example with CORS proxy URL rewriting.

player.html

<script src="https://cdn.jsdelivr.net/npm/hls.js@latest"></script>
<video id="video" controls></video>
<script>
const PROXY = 'http://localhost:8888/proxy?url=';
const API = 'https://priv-api.anichin.bio';
const KEY = 'YOUR_API_KEY';

async function play(dramaId, ep) {
  const res = await fetch(
    `${API}/api/iqiyi/episode?id=${dramaId}&ep=${ep}&lang=en`,
    { headers: { 'X-API-Key': KEY } }
  );
  const data = await res.json();
  let m3u8 = data.hlsUrl;

  // Rewrite TS segment URLs through CORS proxy
  m3u8 = m3u8.replace(
    /https?:\/\/[^\s]+\.ts[^\s]*/g,
    url => PROXY + encodeURIComponent(url)
  );

  // Create blob URL from rewritten m3u8
  const blob = new Blob([m3u8], { type: 'application/vnd.apple.mpegurl' });
  const blobUrl = URL.createObjectURL(blob);

  const video = document.getElementById('video');
  if (Hls.isSupported()) {
    const hls = new Hls();
    hls.loadSource(blobUrl);
    hls.attachMedia(video);
    hls.on(Hls.Events.MANIFEST_PARSED, () => video.play());
  } else {
    video.src = blobUrl;
  }
}

play('my-boss-is-a-psycho-1flw8l5o0p4', 1);
</script>

iQIYI — Api-Dracin Multi-Source Drama Streaming API