# Kinolights Scraper — Korean OTT Trend Rankings (`kdatafactory/kinolights-scraper`) Actor Scrape Kinolights (키노라이츠), Korea's 'Rotten Tomatoes' for streaming — the live TOP 100 ranking of what Koreans watch on Netflix, Disney+, Wavve, TVING, Coupang Play & Watcha. One record per title: rank, title, OTT platforms, score, year, genre, poster. Clean JSON, no PII. - **URL**: https://apify.com/kdatafactory/kinolights-scraper.md - **Developed by:** [Seok June Park](https://apify.com/kdatafactory) (community) - **Categories:** E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.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. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Kinolights Scraper — Korean OTT Trend Rankings 🎬 Scrape the live **streaming trend rankings** from [Kinolights (키노라이츠)](https://m.kinolights.com/ranking) — **Korea's "Rotten Tomatoes"** for film & TV — as clean, structured JSON. Kinolights aggregates what's trending across **Netflix, Disney+, Wavve, TVING, Coupang Play & Watcha** in Korea and ranks it into a daily **TOP 100**. Get rank, title, the OTT platforms each title streams on, the Kinolights score, release year, genre, and poster for every ranked title in one run. The fastest way to see **what Korea is actually watching right now** — one call, one clean dataset — for K-content trackers, streaming strategy, and media analysts. > **Try it free.** Apify's free plan includes $5 of monthly platform credit — at **$2.00 / 1,000 results** that's far more than you'll need for a daily TOP-100 pull, no credit card required. Set your input, click Start, and export JSON/CSV/Excel. --- ### What it does This actor reads ranking data straight from Kinolights' own public GraphQL API (the same endpoint the website calls as you browse the ranking page), so results are fast and complete — no fragile full-page scraping, no headless browser. You can pull: - **The overall trend ranking** (`kino`) — the cross-platform TOP 100 the site shows by default, or - **A single service's ranking** — Netflix, Disney+, Wavve, TVING, Coupang Play, or Watcha, or - **The box-office (in-theaters) ranking**, or the **combined subscription** ranking. Every run returns one record per ranked title, in rank order, with the OTT services it streams on and its Kinolights score. > **Why Kinolights?** Korea has one of the world's most active OTT markets, split across a half-dozen competing platforms. Kinolights is the leading Korean aggregator that scores and ranks titles across *all* of them at once — the closest thing Korea has to a single "what's hot in streaming" leaderboard. This actor turns that leaderboard into a structured dataset you can track over time, join to your catalogue, and pipe into your own tools. --- ### Input | Field | Type | Description | |-------|------|-------------| | `rankingType` | string | Which ranking to collect: `kino` (overall trend — default), `boxoffice` (in theaters), `subscription` (all subscription OTTs combined), `netflix`, `tving`, `coupangplay`, `wavve`, `disneyplus`, or `watcha`. | | `maxItems` | integer | Max ranked titles to collect. Default `100`. Kinolights publishes a **TOP 100**, so 100 is the effective maximum. | | `proxyConfiguration` | object | Proxy settings (see below). Defaults to a direct connection. | #### Input example ```json { "rankingType": "kino", "maxItems": 100 } ```` ```json { "rankingType": "netflix", "maxItems": 50 } ``` *** ### Output Each ranked title is one dataset record, returned in rank order. `rank` is the position in the Kinolights ranking; `score` is the Kinolights aggregate index score (0–100, higher = better received — the "fresh"-style rating); `ott_services` lists the Korean OTT platforms the title streams on at scrape time; `genre` is Kinolights' genre tags. ```json { "source": "kinolights", "ranking_type": "kino", "rank": 1, "content_id": "153086", "title": "김부장", "title_en": "Agent Kim Reactivated", "content_type": "드라마", "ott_services": ["넷플릭스"], "score": 76.62, "score_type": "GREEN", "release_year": 2026, "genre": ["범죄", "서사/드라마", "액션", "어드벤처"], "is_in_theaters": false, "rank_delta": 0, "is_new": false, "url": "https://m.kinolights.com/title/153086", "image_url": "https://file.kinolights.com/original/content_poster/202606/19/d3c7cb43-35aa-4477-a569-e7d23a879baa.jpeg", "scraped_at": "2026-07-14T14:42:28+09:00" } ``` A full 40-item sample from a real run is in [`samples/sample-output.json`](samples/sample-output.json). | Field | Meaning | |-------|---------| | `source` | Always `"kinolights"`. | | `ranking_type` | The ranking you requested (`kino`, `netflix`, …). | | `rank` | Position in the ranking (1 = top). | | `content_id` | Kinolights content id. | | `title` | Title (Korean, as Kinolights labels it). | | `title_en` | English title when Kinolights has one, else `null`. | | `content_type` | 영화 (film), 드라마 (drama/series), 애니메이션 (anime), 예능 (variety), etc. | | `ott_services` | Array of Korean OTT platform names the title streams on (e.g. `넷플릭스`, `티빙`, `디즈니+`). Empty `[]` when it isn't on any tracked OTT (e.g. in theaters only). | | `score` | Kinolights aggregate index score, 0–100. `null` when not yet scored. | | `score_type` | Kinolights rating band: `GREEN` / `YELLOW` / `RED`, else `null`. | | `release_year` | Release year (4-digit), else `null`. | | `genre` | Array of Kinolights genre tags, else `null`. | | `is_in_theaters` | `true` if currently in theaters. | | `rank_delta` | Change vs. the previous ranking snapshot (`+`/`-`/`0`). | | `is_new` | `true` if newly entered the ranking. | | `url` | Kinolights detail page for the title. | | `image_url` | Poster image URL. | | `scraped_at` | ISO-8601 timestamp (KST, UTC+9). | The core fields — `rank`, `title`, `release_year`, `content_type`, `url`, `image_url` — populated on **40/40** records in the live test. `genre` (39/40), `score` (35/40), `title_en` (36/40) and `ott_services` (26/40) are best-effort and depend on what Kinolights exposes for each title (see Known limitations). *** ### Use cases - **K-content & K-drama trackers** — snapshot the TOP 100 daily to follow what's trending across Korean streaming, chart risers/fallers with `rank_delta`, and catch new entries with `is_new`. - **Streaming strategy & competitive intel** — compare per-service rankings (Netflix vs TVING vs Coupang Play) to see which platform owns Korea's zeitgeist this week, and which titles are exclusive vs multi-platform via `ott_services`. - **Media & entertainment analysts** — join Kinolights `score` and `rank` to your own catalogue for reception and popularity signals on Korean and global titles in the Korean market. - **AI agents & datasets** — feed a clean, ranked "what Korea is watching" feed into dashboards, recommendation models, or LLM agents. *** ### ❓ FAQ **Is it legal to scrape this data?** This actor collects only public, non-personal ranking data — the same trend ranking any visitor sees on kinolights.com without logging in. No user accounts, reviews, or personal data are collected. You are responsible for how you use the data; see the legality note below. **What does it cost in practice?** $2.00 per 1,000 results (launch pricing) + a few cents of platform usage. A daily TOP-100 pull is 100 results ≈ **$0.20/day**. Apify's free $5 monthly credit covers far more than a daily ranking snapshot needs. **Do I need to configure proxies?** No — the default settings work out of the box. Kinolights serves its ranking API without a bot wall, so the actor runs fine on a **direct connection**. If you ever see blocks, you can optionally enable Apify Proxy — see the proxy note below. **How fresh is the data?** Every run hits the live Kinolights ranking at run time. Schedule the actor for recurring snapshots (e.g. a daily TOP-100 pull) to build a time series and track `rank_delta` day over day. **Why are some fields null / empty?** Kinolights doesn't expose every field for every title. `score`/`score_type` are `null` until a title has enough ratings; `ott_services` is empty for titles only in theaters (or not on a tracked OTT); `title_en` and `genre` are populated when Kinolights has them. `rank` and `title` are always present. *** ### 🤖 Use with AI agents (MCP) Call this Actor as a tool from Claude or any MCP-compatible AI agent — no glue code. Point your MCP client at Apify's server, scoped to this Actor: ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com?tools=kdatafactory/kinolights-scraper", "headers": { "Authorization": "Bearer " } } } } ``` Your agent can then pull Korea's live OTT trend rankings on demand — no scraping code in your app. Grab a free token from [Apify → Integrations](https://console.apify.com/settings/integrations). ### 🇰🇷 More Korean data actors This actor is part of a suite of Korean-platform scrapers by the same maintainer: - **[naver-webtoon-scraper](https://apify.com/kdatafactory/naver-webtoon-scraper) — ranked webtoons from Naver, Korea's biggest webtoon platform.** Pair it with this actor to track Korean storytelling IP across both screen and comics. - **[korea-trend-feed](https://apify.com/kdatafactory/korea-trend-feed) — real-time trending keywords and topics across Korean platforms.** Run it alongside this actor to connect what's trending in culture with what's trending on streaming. Browse all: [apify.com/kdatafactory](https://apify.com/kdatafactory) *** ### Rate limiting & legality - The actor collects **only public, non-authenticated data**. It never logs in and never touches private endpoints. - **No personal data** is collected — only movie/show titles, rankings, scores, and poster art. No user accounts, reviews, or comments. - Requests are gentle: a single ranking call per run, so there's negligible load on Kinolights' servers. - You are responsible for using the data in line with Kinolights' terms of service and applicable law. #### Known limitations (honesty note) - **`score` / `score_type`** are `null` for titles Kinolights hasn't scored yet (≈88% populated in the live test). They're not billed as guaranteed fields. - **`ott_services`** reflects only the OTT platforms Kinolights tracks, at scrape time. It's empty `[]` for titles that are in theaters only or not on a tracked service (≈65% of titles carried at least one OTT in the live test). It is a best-effort snapshot, not a guarantee of streaming availability. - **`title_en`** and **`genre`** are populated when Kinolights has them (≈90% and ≈98% in the live test) and `null`/`empty` otherwise. Titles and genres are Korean strings; only `title_en` is translated, and only when Kinolights provides it. - **Depth is capped at 100.** Kinolights publishes a TOP 100 ranking, so a run returns at most 100 titles per ranking type — by design, not a scraper limit. - **`rank_delta` / `is_new`** come straight from Kinolights' own snapshot diffing; they reflect the site's cadence, not your run schedule. *** *If this actor saves you time, a rating on the [Store page](https://apify.com/kdatafactory/kinolights-scraper) helps a solo maintainer a lot. Found an issue? Open it in the Issues tab — I respond fast.* # Actor input Schema ## `rankingType` (type: `string`): Which Kinolights ranking to collect. 'kino' is the overall cross-platform trend ranking (the site default). 'boxoffice' is the in-theaters ranking. 'subscription' is the combined ranking across the six major subscription OTTs. The remaining options are per-service rankings. ## `maxItems` (type: `integer`): Maximum number of ranked titles to collect. Kinolights publishes a TOP 100, so the effective maximum is 100. ## `proxyConfiguration` (type: `object`): Proxy settings. Kinolights serves its ranking API without a bot wall, so the actor runs fine on a direct connection (default). If you ever see blocks, enable Apify Proxy here. ## Actor input object example ```json { "rankingType": "kino", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": false } } ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("kdatafactory/kinolights-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 = {} # Run the Actor and wait for it to finish run = client.actor("kdatafactory/kinolights-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 '{}' | apify call kdatafactory/kinolights-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=kdatafactory/kinolights-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Kinolights Scraper — Korean OTT Trend Rankings", "description": "Scrape Kinolights (키노라이츠), Korea's 'Rotten Tomatoes' for streaming — the live TOP 100 ranking of what Koreans watch on Netflix, Disney+, Wavve, TVING, Coupang Play & Watcha. One record per title: rank, title, OTT platforms, score, year, genre, poster. Clean JSON, no PII.", "version": "0.1", "x-build-id": "MTJbHLzYSB3IIDN76" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kdatafactory~kinolights-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kdatafactory-kinolights-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/kdatafactory~kinolights-scraper/runs": { "post": { "operationId": "runs-sync-kdatafactory-kinolights-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/kdatafactory~kinolights-scraper/run-sync": { "post": { "operationId": "run-sync-kdatafactory-kinolights-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": { "rankingType": { "title": "Ranking type", "enum": [ "kino", "boxoffice", "subscription", "netflix", "tving", "coupangplay", "wavve", "disneyplus", "watcha" ], "type": "string", "description": "Which Kinolights ranking to collect. 'kino' is the overall cross-platform trend ranking (the site default). 'boxoffice' is the in-theaters ranking. 'subscription' is the combined ranking across the six major subscription OTTs. The remaining options are per-service rankings.", "default": "kino" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of ranked titles to collect. Kinolights publishes a TOP 100, so the effective maximum is 100.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Kinolights serves its ranking API without a bot wall, so the actor runs fine on a direct connection (default). If you ever see blocks, enable Apify Proxy here.", "default": { "useApifyProxy": 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 } } } } } } } } } } ```