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.

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.

Name	Type	Attributes	Description
`channel`	string	optional	Channel: all, tv, web, or cinema. Defaults to all.
`platform`	string	optional	Filter by channel or platform keyword, such as iQIYI.
`limit`	integer	optional	Return only the top N items per channel.
`period`	string	optional	Ranking period: realtime, day, week, or month. Defaults to realtime.
`date`	string	optional	Historical snapshot date in YYYY-MM-DD format. Used with day/week/month.

Response

200 / OK

Returns movie/TV ranking data.

JSON

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.

Quick start

Pick your language to see usage examples

Auth mode:

cURL command

curl 'https://uapis.cn/api/v1/misc/movie-rating-rank'

Frequently asked questions

Are there any special restrictions for the Movie/TV Rating Rank API?

Movie/TV Rating Rank follows our standard usage policy. Refer to the endpoint reference above for the exact rate limits and parameter requirements. Reach out if you have unusual needs.

Are the APIs on UAPI free to use?

UAPI gives every visitor free credits so you can call any endpoint right away. Visitor credits have a usage cap, and if you need more you can for additional credits.

Do I need to register an account to use UAPI?

No registration is required for visitor credit calls. If you need more credits or want to manage your call history, you can register a free account. Signed-in users get more free credits and can review usage details in the console.

Which languages and use cases does UAPI support?

Our APIs follow standard HTTP and RESTful design, so any language that can send network requests works — including JavaScript (Node.js, Vue, React), Python, Java, PHP, Go, C#, and more. They fit web apps, mobile backends, mini-program cloud functions, automation scripts, and similar scenarios.

PreviousWeather History

NextCategory overview