# Find iQIYI Anime Rankings

**Use case:** 

Get the current iQIYI anime channel hot list for anime viewers building watch lists or publishers researching popular titles. Results include title, rank, score, content rating, and poster URL. Change maxItems to choose how many titles to return.

## Input

```json
{
  "mode": "rankings",
  "albumIds": [
    "genius-girlfriend-2026-28fzrln6il1",
    "fated-hearts-2025-d6iyehcx4p",
    "a-better-jianghu-2026-1qi696xihh0"
  ],
  "searchQueries": [
    "love"
  ],
  "searchQuery": "love",
  "region": "intl",
  "language": "en_us",
  "includeDetails": true,
  "includeEpisodes": true,
  "rankingType": "channelAnime",
  "channelId": "2",
  "maxItems": 20
}
```

## Output

```json
{
  "title": {
    "label": "Title"
  },
  "name": {
    "label": "Name"
  },
  "albumId": {
    "label": "Album id"
  },
  "releaseYear": {
    "label": "Release year"
  },
  "year": {
    "label": "Year"
  },
  "score": {
    "label": "Score"
  },
  "totalEpisodes": {
    "label": "Total episodes"
  },
  "episodeCount": {
    "label": "Episode count"
  },
  "channelId": {
    "label": "Channel id"
  },
  "rank": {
    "label": "Rank"
  },
  "rankingType": {
    "label": "Ranking type"
  },
  "iqiyiUrl": {
    "label": "Iqiyi url"
  },
  "albumUrl": {
    "label": "Album url"
  }
}
```

## How it works

### 1. Sign up on Apify or log in

The iQIYI Album Profile & Channel Ranking Scraper Actor is ready to run with the inputs already set for "Find iQIYI Anime Rankings". [Sign up or log in](https://console.apify.com/create-task-from-example/QJjy5F3zUX2Y6BNsW) and you'll land in Apify Console with a copy of this exact task.

### 2. Start the "Find iQIYI Anime Rankings" task

The iQIYI Album Profile & Channel Ranking Scraper Actor will start running based on the input automatically. You can also change all the input fields, like mode, album ids or urls (mode=byid), and more, to match your specific use case.

### 3. Receive the "Find iQIYI Anime Rankings" output

Monitor the progress in real time. You will be notified as soon as your dataset is complete and ready for review. Each result includes data such as title, name, album id, and more.

### 4. Integrate into your workflow

The final output is delivered in JSON, CSV, or Excel format, ready to be plugged into your workflow. You can also [run the "Find iQIYI Anime Rankings" task via API](https://apify.com/dataspryva/iqiyi-album-profile-and-channel-ranking-scraper.md).

## FAQ

### What iQIYI anime recommendations does this task return?

The iQIYI anime rankings task returns titles from the current anime channel hot list, with rank, score, content rating, year, and poster URL when available.

### How many iQIYI anime titles can one run return?

With this setup, the iQIYI anime rankings task has a maximum of 20 results. The task allows a maximum of 1000 results when you change the limit.

### How do I change how many iQIYI anime titles I get?

When you copy the iQIYI anime rankings task into your account, change the maximum number of items before running it; the allowed range is 1 to 1000.

### Can I export iQIYI anime rankings to CSV or Excel?

The iQIYI anime rankings task stores results in a dataset that you can download as CSV, Excel, JSON, XML, RSS, or an HTML table.

### How much does it cost to get 20 iQIYI anime results?

At a maximum of 20 results, the result charge for the iQIYI anime rankings task is at most $0.02 on the Free plan. Actor start and Apify platform compute charges also apply.

### Does this iQIYI anime task need a login or API key?

The iQIYI anime rankings task reads the public catalogue without an account, login, cookie, or API key.

### Can I run iQIYI anime rankings on a schedule or through an API?

You can run the iQIYI anime rankings task on an Apify schedule, through the Apify API, or from integrations such as Zapier, Make, and n8n.

## About this Actor

This example demonstrates how to use [iQIYI Album Profile & Channel Ranking Scraper](https://apify.com/dataspryva/iqiyi-album-profile-and-channel-ranking-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/dataspryva/iqiyi-album-profile-and-channel-ranking-scraper.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/dataspryva/iqiyi-album-profile-and-channel-ranking-scraper.md

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).