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.

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.