# iQIYI Scraper (`natanielsantos/iqiyi-scraper`) Actor Easily scrape video data from iQIYI(爱奇艺) search results and profiles, like title, album, image, interaction data, uploader data and more. - **URL**: https://apify.com/natanielsantos/iqiyi-scraper.md - **Developed by:** [Nataniel Santos](https://apify.com/natanielsantos) (community) - **Categories:** Videos, Social media, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### What does iQIYI Scraper do? iQIYI Scraper is an Apify Actor designed to extract detailed information about videos from the iQIYI platform. It can scrape video details using either direct video URLs or search terms, allowing users to gather comprehensive data on a wide range of videos available on iQIYI. ### ✨ Features - 🔎 Scrape by search terms, profiles and videos URLs - ⚡ Fast and reliable scraping - 🧑‍💻 Perfect for non-technical users - 🔒 No need for authentication - 🔄 Automatically handles retries for failed requests - 📦 Outputs data in JSON format for easy integration with other tools ### 🎯 Who Is This For? - Content creators and marketers looking to analyze iQIYI video content - Researchers studying trends and patterns in online video content - Developers needing structured data from iQIYI for their applications - Anyone interested in gathering insights from iQIYI's vast video library ### ⬇️ Input Options - 🔗 `urls` - List of URLs to scrape. It can be a list of video URLs, profile URLs or album URLs from iQiyi. or - 🔍 `searchTerms` - Search terms to query on iQiyi. The Actor will search for each term and scrape results until it reaches the maxItems limit. - 🗂️ `sortBy` (optional) - Sorting order for search results. `relevance` sorts by relevance to the search term, `latest` sorts by publish date with newest first, and `popular` sorts by popularity with most popular first. - 🔖 `category` (optional) - Category to filter search results by. See the [Input specification](https://apify.com/natanielsantos/iqiyi-scraper/input-schema) to see the complete list of categories. - 📅 `publishDate` (optional) - Filter search results by publish date. `all_time` includes all results, `last_24_hours` includes videos published in the last 24 hours, `last_7_days` includes videos published in the last week, `last_30_days` includes videos published in the last month. - 🌐 `site` (optional) - Filter search results by video hosting site. `all` includes results from all supported sites, while selecting a specific site will only include results from that site. See the [Input specification](https://apify.com/natanielsantos/iqiyi-scraper/input-schema) to see the complete list of supported sites. - 🎥 `quality` (optional) - Filter search results by video quality. `all` includes all results regardless of quality. The other options are `hd`, `ultra_hd`, `720p` and `1080p`. - ⚙️ `maxItems` (optional) - Maximum number of items to scrape for each search term or profile. Set 0 to scrape all available items. Default is 100. - 🧑‍💻 `scrapeAdditionalInfo` (optional) - Whether to scrape additional information such as uploader data (uploader name, uploader avatar, uploader follower count, etc.) and interaction data (like count, sub count, comment count, etc.). Enabling this option may reduce the run time. #### 💡 Input Examples ###### Scrape by URLs ```json { "urls": [ "http://www.iqiyi.com/v_12vxqf0wkkw.html", "http://www.iqiyi.com/v_19rrn9x5s8.html" ] } ```` ###### Scrape by Search Terms (50 items per search term) ```json { "searchTerms": [ "风与潮", "隐秘的角落" ], "sortBy": "latest", "category": "tv_series", "publishDate": "last_30_days", "site": "iqiyi", "quality": "hd", "maxItems": 50, "scrapeAdditionalInfo": true } ``` ###### Scrape a profile by URL ```json { "urls": [ "https://www.iqiyi.com/creator/1417086489" ], "scrapeAdditionalInfo": true, "maxItems": 20 } ``` ### 📤 Output Format The format of the output is a JSON object with the following fields: - `imageUrl`: URL of the video's thumbnail image - `id`: Unique identifier for the video - `url`: URL of the video on iQiyi - `videoTitle`: Title of the video - `albumPageUrl`: URL of the album page the video belongs to (if applicable) - `albumTitle`: Title of the album the video belongs to (if applicable) - `albumId`: Unique identifier for the album the video belongs to (if applicable) - `categoryId`: Unique identifier for the video's category - `categoryName`: Name of the video's category - `description`: Description of the video - `heatCount`: Heat count of the video, which is a measure of its popularity - `publishTime`: Publish time of the video in Unix timestamp format - `publishTimeString`: Publish time of the video in human-readable format - `horizontalImageUrl`: URL of the video's horizontal thumbnail image - `firtFrameImageUrl`: URL of the video's first frame image - `rating`: Rating of the video (if available) - `ratingCount`: Number of ratings the video has received (if available) - `totalItemsInAlbum`: Total number of items in the album the video belongs to (if applicable) - `actors`: List of actors in the video (if available) - `uploaderName`: Name of the video's uploader (if scrapeAdditionalInfo is true) - `uploaderAvatar`: URL of the uploader's avatar image (if scrapeAdditionalInfo is true) - `uploaderId`: Unique identifier for the uploader (if scrapeAdditionalInfo is true) - `likeCount`: Number of likes the video has received (if scrapeAdditionalInfo is true) - `subCount`: Number of subscribers the video has (if scrapeAdditionalInfo is true) - `commentCount`: Number of comments the video has received (if scrapeAdditionalInfo is true) - `uploaderVideoCount`: Total number of videos uploaded by the uploader (if scrapeAdditionalInfo is true) - `uploaderFollowerCount`: Total number of followers the uploader has (if scrapeAdditionalInfo is true) - `uploaderLocation`: Location of the uploader (if scrapeAdditionalInfo is true) - `uploaderOrgName`: Organization name of the uploader (if scrapeAdditionalInfo is true) ### 🗂️ Output Example ```json { "imageUrl": "https://pic2.iqiyipic.com/image/20260325/90/51/a_100788930_m_601_579_772.jpg", "id": "5924496141864900", "url": "https://www.iqiyi.com/v_1niil20qs2w.html", "videoTitle": "原来是变色龙在避雨啊", "albumPageUrl": "https://www.iqiyi.com/a_28fdjsrsru5.html", "albumTitle": "小小赛动漫菌y的2026年合集2", "albumId": "8287676726358401", "categoryId": 27, "categoryName": "原创", "description": null, "heatCount": 1458, "publishTime": 1777451760, "publishTimeString": "2026-04-29 08:36", "horizontalImageUrl": "https://pic2.iqiyipic.com/image/20260325/90/51/a_100788930_m_601_480_270.jpg", "firtFrameImageUrl": "https://m.iqiyipic.com/u8/image/20260415/cd/4c/pv_5924496141864900_d_616_720_1280.jpg", "rating": null, "ratingCount": null, "totalItemsInAlbum": 99, "actors": [], "uploaderName": "小小赛动漫菌y", // if scrapeAdditionalInfo is true "uploaderAvatar": "https://img7.iqiyipic.com/passport/20250826/98/70/passport_1704326987_175618326953486_130_130.jpg", // if scrapeAdditionalInfo is true "uploaderId": "1704326987", // if scrapeAdditionalInfo is true "likeCount": 577, // if scrapeAdditionalInfo is true "subCount": 410, // if scrapeAdditionalInfo is true "commentCount": 1, // if scrapeAdditionalInfo is true "uploaderVideoCount": 1015, // if scrapeAdditionalInfo is true "uploaderFollowerCount": 8305, // if scrapeAdditionalInfo is true "uploaderLocation": "贵州", // if scrapeAdditionalInfo is true "uploaderOrgName": "贵阳远岚网络科技有限公司" // if scrapeAdditionalInfo is true } ``` ### 💲How much will scraping iQIYI cost you? The pricing changes according to your Apify plan. - Free: **$7.00**/1,000 posts (Apify gives you $5.00 free credits every month, so you can scrape up to 714 videos) - Starter: **$5.00**/1,000 posts - Scale: **$4.00**/1,000 posts - Business: **$4.00**/1,000 posts Additional cost if you choose to scrape additional info (uploader data and interaction data): - **$1.00**/1,000 posts ### 🧩 Integrations and iQIYI Scraper iQIYI Scraper can be connected with almost any cloud service or web app thanks to [integrations on the Apify platform](https://apify.com/integrations). You can integrate with Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive, [and more](https://docs.apify.com/integrations). Or you can use [webhooks](https://docs.apify.com/integrations/webhooks) to carry out an action whenever an event occurs, e.g. get a notification whenever iQIYI Scraper successfully finishes a run. ### 🔌Using iQIYI Scraper with the Apify API The Apify API gives you programmatic access to the Apify platform. The API is organized around RESTful HTTP endpoints that enable you to manage, schedule, and run Apify actors. The API also lets you access any datasets, monitor actor performance, fetch results, create and update versions, and more. To access the API using Node.js, use the apify-client NPM package. To access the API using Python, use the apify-client PyPI package. Check out the [Apify API reference](https://docs.apify.com/api/v2) docs for full details or click on the [API tab](https://apify.com/natanielsantos/iqiyi-scraper/api) for code examples. ### 💬 Giving feedback We’re always working on improving the performance of our Actors. So if you’ve got any technical feedback for iQIYI scraper or simply found a bug, please create an issue on the Actor’s [Issues tab](https://apify.com/natanielsantos/iqiyi-scraper/issues/open) in Apify Console. 📧 Email: nathan.santos159@hotmail.com # Actor input Schema ## `urls` (type: `array`): List of URLs to scrape. It can be a list of video URLs, profile URLs or album URLs from iQiyi. ## `searchTerms` (type: `array`): Search terms to query on iQiyi. The Actor will search for each term and scrape results until it reaches the maxItems limit. ## `sortBy` (type: `string`): Sorting order for search results. 'Relevance' sorts by relevance to the search term, 'Latest' sorts by publish date with newest first, and 'Popular' sorts by popularity with most popular first. ## `category` (type: `string`): Category to filter search results by. If 'All' is selected, no category filter will be applied. ## `publishDate` (type: `string`): Filter search results by publish date. 'All Time' includes all results, 'Last 24 Hours' includes videos published in the last 24 hours, 'Last 7 Days' includes videos published in the last week, 'Last 30 Days' includes videos published in the last month. ## `site` (type: `string`): Filter search results by video hosting site. 'All Sites' includes results from all supported sites, while selecting a specific site will only include results from that site. ## `quality` (type: `string`): Filter search results by video quality. 'All Qualities' includes all results regardless of quality, while selecting a specific quality will only include videos that match that quality. ## `maxItems` (type: `integer`): Maximum number of items to scrape for each search term. Set 0 to scrape all available items. ## `scrapeAdditionalInfo` (type: `boolean`): Whether to scrape additional information such as uploader data (uploader name, uploader avatar, uploader follower count, etc.) and interaction data (like count, sub count, comment count, etc.). Enabling this option may reduce the run time. ## Actor input object example ```json { "urls": [ "http://www.iqiyi.com/v_12vxqf0wkkw.html" ], "searchTerms": [ "风与潮" ], "sortBy": "relevance", "category": "all", "publishDate": "all", "site": "all", "quality": "all", "maxItems": 100, "scrapeAdditionalInfo": false } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "urls": [ "http://www.iqiyi.com/v_12vxqf0wkkw.html" ] }; // Run the Actor and wait for it to finish const run = await client.actor("natanielsantos/iqiyi-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "urls": ["http://www.iqiyi.com/v_12vxqf0wkkw.html"] } # Run the Actor and wait for it to finish run = client.actor("natanielsantos/iqiyi-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "urls": [ "http://www.iqiyi.com/v_12vxqf0wkkw.html" ] }' | apify call natanielsantos/iqiyi-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=natanielsantos/iqiyi-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "iQIYI Scraper", "description": "Easily scrape video data from iQIYI(爱奇艺) search results and profiles, like title, album, image, interaction data, uploader data and more.", "version": "0.0", "x-build-id": "CYZXcM9fSFjHIjdLY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/natanielsantos~iqiyi-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-natanielsantos-iqiyi-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/natanielsantos~iqiyi-scraper/runs": { "post": { "operationId": "runs-sync-natanielsantos-iqiyi-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/natanielsantos~iqiyi-scraper/run-sync": { "post": { "operationId": "run-sync-natanielsantos-iqiyi-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "urls": { "title": "Profile URLs or Video/Album URLs", "type": "array", "description": "List of URLs to scrape. It can be a list of video URLs, profile URLs or album URLs from iQiyi.", "items": { "type": "string" } }, "searchTerms": { "title": "🔍 Search Terms", "type": "array", "description": "Search terms to query on iQiyi. The Actor will search for each term and scrape results until it reaches the maxItems limit.", "items": { "type": "string" } }, "sortBy": { "title": "Sort By", "enum": [ "relevance", "latest", "popular" ], "type": "string", "description": "Sorting order for search results. 'Relevance' sorts by relevance to the search term, 'Latest' sorts by publish date with newest first, and 'Popular' sorts by popularity with most popular first.", "default": "relevance" }, "category": { "title": "Category", "enum": [ "all", "movie", "tv_series", "documentary", "animation", "music", "variety_shows", "entertainment", "game", "travel", "trailers", "fashion", "short_films", "sports", "life", "advertisement", "comedy", "finance", "news_and_info", "car", "originals", "military", "mother_and_baby", "technology", "talk_shows", "health", "beauty", "square_dance", "trending" ], "type": "string", "description": "Category to filter search results by. If 'All' is selected, no category filter will be applied.", "default": "all" }, "publishDate": { "title": "Publish Date", "enum": [ "all", "last_24_hours", "last_7_days", "last_30_days" ], "type": "string", "description": "Filter search results by publish date. 'All Time' includes all results, 'Last 24 Hours' includes videos published in the last 24 hours, 'Last 7 Days' includes videos published in the last week, 'Last 30 Days' includes videos published in the last month.", "default": "all" }, "site": { "title": "Site", "enum": [ "all", "iqiyi", "tencent_video", "sohu", "youku", "tudou", "acfun", "bilibili", "ifeng", "cntv", "m1905" ], "type": "string", "description": "Filter search results by video hosting site. 'All Sites' includes results from all supported sites, while selecting a specific site will only include results from that site.", "default": "all" }, "quality": { "title": "Quality", "enum": [ "all", "hd", "ultra_hd", "720p", "1080p" ], "type": "string", "description": "Filter search results by video quality. 'All Qualities' includes all results regardless of quality, while selecting a specific quality will only include videos that match that quality.", "default": "all" }, "maxItems": { "title": "Max Items (per search term or profile)", "type": "integer", "description": "Maximum number of items to scrape for each search term. Set 0 to scrape all available items.", "default": 100 }, "scrapeAdditionalInfo": { "title": "Scrape Additional Info (Uploader data and interaction data", "type": "boolean", "description": "Whether to scrape additional information such as uploader data (uploader name, uploader avatar, uploader follower count, etc.) and interaction data (like count, sub count, comment count, etc.). Enabling this option may reduce the run time.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```