Misc

Movie/TV Rating Rank

0calls
1 credits / call

Want to build a movie/TV chart page or do content-planning analysis? This endpoint provides rating, viewership, and popularity rankings. It supports realtime rankings as well as daily, weekly, and monthly historical snapshots.

GET
uapis.cn
/api/v1/misc/movie-rating-rank
Query parameters
5
channel
string

Channel: all, tv, web, or cinema. Defaults to all.

platform
string

Filter by channel or platform keyword, such as iQIYI.

limit
integer

Return only the top N items per channel.

period
string

Ranking period: realtime, day, week, or month. Defaults to realtime.

date
string

Historical snapshot date in YYYY-MM-DD format. Used with day/week/month.

Overview

Use channel to switch between all-web, TV, web-platform, and cinema rankings. Use period + date to query day/week/month history. Useful for entertainment pages, dashboards, media planning, and content operations.

Query parameters

channel
stringoptional

Channel: all, tv, web, or cinema. Defaults to all.

platform
stringoptional

Filter by channel or platform keyword, such as iQIYI.

limit
integeroptional

Return only the top N items per channel.

period
stringoptional

Ranking period: realtime, day, week, or month. Defaults to realtime.

date
stringoptional

Historical snapshot date in YYYY-MM-DD format. Used with day/week/month.

Response

200 / OK

Returns movie/TV ranking data.

JSON
{
  "period": "realtime",
  "date": "2026-06-08",
  "channels": [
    {
      "channel": "web",
      "platform": "iQIYI",
      "items": [
        {
          "rank": 1,
          "title": "Example Drama",
          "score": 9.2,
          "hot_value": 9821
        }
      ]
    }
  ]
}

400 / Bad Request

Invalid parameters, such as period not being realtime/day/week/month.

404 / Not Found

No historical snapshot exists for the requested date or period.

503 / Service Unavailable

Service temporarily unavailable. Please try again later.