# FlixPatrol Streaming Charts Scraper (`crawlerbros/flixpatrol-streaming-charts-scraper`) Actor Scrape FlixPatrol's public Top 10 streaming charts by platform (Netflix, Disney+, HBO Max, Prime Video, Apple TV+, and 75+ more), country, content type, and date. No login required. - **URL**: https://apify.com/crawlerbros/flixpatrol-streaming-charts-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Videos, Automation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## FlixPatrol Streaming Charts Scraper Scrape [FlixPatrol](https://flixpatrol.com)'s public Top 10 streaming charts — the most-watched movies and TV shows on Netflix, Disney+, HBO Max, Prime Video, Apple TV+, and 75+ other streaming platforms, broken down by country and date. No login required. ### What this actor does - **81 streaming platforms** — Netflix, Disney+, HBO Max, Amazon Prime Video, Apple TV+, Paramount+, Peacock, and dozens of regional/local services (SBS, ZEE5, Hotstar, Crunchyroll, Rakuten TV, and more) - **94 markets** — every country FlixPatrol tracks, plus the aggregate "World (Global)" chart - **Movies and TV shows** — each platform+country combination has a separate Top 10 for each - **Historical charts** — fetch today's chart or any specific past date - **Empty fields are omitted** — a record only contains data FlixPatrol actually published for that entry (e.g. `posterUrl` is omitted, never faked, when FlixPatrol has no poster art for a title yet) ### Output per chart entry - `rank` — position in the Top 10 (1–10) - `title` — movie or TV show title - `platform` — streaming service (e.g. `Netflix`, `HBO Max`) - `country` — market (e.g. `United States`, `World (Global)`) - `contentType` — `movie` or `tv` - `chartDate` — the date this chart reflects (`YYYY-MM-DD`) - `points` — FlixPatrol's popularity score for that entry, on charts that publish one (e.g. the `World (Global)` aggregate chart) - `daysInChart` — number of days the title has spent in the Top 10 so far, on charts that publish this instead of a points score (e.g. most individual-country charts) - `isPlatformOriginal` — `true` when FlixPatrol marks the title as a platform original - `sourceUrl` — FlixPatrol's title detail page - `posterUrl` — poster image, when FlixPatrol has real artwork on file and the chart layout includes per-row thumbnails - `recordType: "chartEntry"`, `scrapedAt` ### Input | Field | Type | Default | Description | |---|---|---|---| | `platform` | string (select) | `netflix` | One of 81 streaming platforms | | `country` | string (select) | `world` | One of 94 markets (`world` = global aggregate chart) | | `contentType` | string (select) | `both` | `both` / `movies` / `tv` | | `date` | string | `today` | `today` or an exact `YYYY-MM-DD` historical date | | `maxItems` | integer | `20` | Hard cap on emitted records (1–20; each chart naturally maxes at 10 per content type) | | `proxyConfiguration` | object | AUTO | Only used as an automatic fallback if FlixPatrol blocks a direct request | #### Example: today's global Netflix Top 10 ```json { "platform": "netflix", "country": "world", "contentType": "both" } ```` #### Example: Disney+ movies in the United States ```json { "platform": "disney", "country": "united-states", "contentType": "movies" } ``` #### Example: HBO Max TV shows in Germany on a specific date ```json { "platform": "hbo-max", "country": "germany", "contentType": "tv", "date": "2026-06-01" } ``` ### Use cases - **Content strategy** — track which titles are trending on competitor platforms, by market - **Licensing & acquisitions** — spot breakout titles before negotiating international rights - **Marketing intelligence** — benchmark a title's chart performance across platforms and countries over time - **Media research** — build historical Top 10 datasets for academic or journalistic analysis - **Release tracking** — monitor a new release's chart trajectory day by day ### FAQ **What is the data source?** The actor scrapes the public Top 10 chart pages at `flixpatrol.com`, an independent streaming analytics site. It is not affiliated with Netflix, Disney, HBO, or any other streaming platform. FlixPatrol aggregates official platform data (e.g. Netflix's own published Top 10 lists) alongside its own tracking for platforms that don't publish official rankings. **Why do some platform/country combinations return no results?** Not every platform is tracked in every market — FlixPatrol only publishes a Top 10 for platform/country pairs it actively monitors. The actor reports this clearly via the run's status message rather than fabricating data. **Why did my `date` request fail?** FlixPatrol only serves historical charts for free within roughly the last 7 days. Older dates require a FlixPatrol paid plan; the actor detects this and reports a clear "requires a paid plan" status message rather than returning empty or fabricated data. Use `date: "today"` or a date within the last week. **Why is `posterUrl` missing on some records?** FlixPatrol doesn't always have poster artwork on file for every title (especially very new or regional releases). The actor never substitutes a generic placeholder image — it omits `posterUrl` entirely rather than reporting a fake one. **Can I get more than 10 results per platform/country/date?** No — FlixPatrol's Top 10 charts are, by design, exactly 10 entries per content type (20 total for `both`). FlixPatrol's own "full details" extended rankings are a paid feature not covered by this actor. **How far back does historical data go?** FlixPatrol has daily charts for most major platforms going back several years. Availability varies by platform — smaller/regional services may have shorter history. **Does this actor need a login, cookies, or proxy?** No. FlixPatrol's Top 10 charts are fully public. A proxy is only used automatically as a fallback if the source starts blocking direct requests. **Does this cover all of FlixPatrol's data, not just Top 10 charts?** This actor is scoped to FlixPatrol's Top 10 streaming charts (platform × country × content type × date), which is the axis FlixPatrol tracks with full platform/country coverage and no daily rate limits. FlixPatrol also publishes several separate, differently-structured products that are out of scope here: `/popular/` (Wikipedia/social popularity rankings, not tied to a specific platform), `/budget/` (production budget estimates), `/persons/` (actor/director popularity), and `/calendar/` (best-of/upcoming lists by year). These use different page templates and data models from the Top 10 chart pages this actor parses. # Actor input Schema ## `platform` (type: `string`): The streaming platform's Top 10 chart to fetch. ## `country` (type: `string`): The market to fetch the chart for. `World (Global)` is FlixPatrol's aggregate global chart. ## `contentType` (type: `string`): Which chart(s) to fetch. Each chart is a Top 10, so `Both` returns up to 20 records. ## `date` (type: `string`): `today` for the current chart, or an exact date in `YYYY-MM-DD` format for a recent historical chart. FlixPatrol only serves the last ~7 days for free; older dates require a FlixPatrol paid plan and will return a clear error. ## `maxItems` (type: `integer`): Hard cap on emitted chart entries. Each Top 10 chart naturally maxes at 10 rows per content type (20 for `Both`). ## `proxyConfiguration` (type: `object`): Not needed in normal operation (flixpatrol.com is publicly reachable with a browser User-Agent). Used automatically as a fallback only if the source starts blocking direct requests. ## Actor input object example ```json { "platform": "netflix", "country": "world", "contentType": "both", "date": "today", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `chartEntries` (type: `string`): Dataset containing all scraped FlixPatrol Top 10 chart entries. # 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 = { "platform": "netflix", "country": "world", "contentType": "both", "date": "today", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/flixpatrol-streaming-charts-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 = { "platform": "netflix", "country": "world", "contentType": "both", "date": "today", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/flixpatrol-streaming-charts-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 '{ "platform": "netflix", "country": "world", "contentType": "both", "date": "today", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true } }' | apify call crawlerbros/flixpatrol-streaming-charts-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/flixpatrol-streaming-charts-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "FlixPatrol Streaming Charts Scraper", "description": "Scrape FlixPatrol's public Top 10 streaming charts by platform (Netflix, Disney+, HBO Max, Prime Video, Apple TV+, and 75+ more), country, content type, and date. No login required.", "version": "1.0", "x-build-id": "Tff7BD7kgkkWpJE1S" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~flixpatrol-streaming-charts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-flixpatrol-streaming-charts-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/crawlerbros~flixpatrol-streaming-charts-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-flixpatrol-streaming-charts-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/crawlerbros~flixpatrol-streaming-charts-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-flixpatrol-streaming-charts-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", "required": [ "platform", "country" ], "properties": { "platform": { "title": "Platform", "enum": [ "9now", "amazon", "amazon-channels", "amazon-prime", "amc-plus", "antenna", "apple-tv", "bbc", "binge", "canal", "catchplay", "cda", "chili", "claro-video", "coupang-play", "crave", "crunchyroll", "danime", "discovery-plus", "disney", "france-tv", "freevee", "friday", "globoplay", "go3", "google", "hami-video", "hbo", "hbo-max", "hotstar", "hrti", "hulu", "hulu-nippon", "infinity-plus", "itunes", "jiohotstar", "lemino", "lionsgate-plus", "m6plus", "mgm-plus", "mubi", "myvideo", "neon-tv", "netflix", "now", "ocs", "oneplay", "osn", "paramount-plus", "peacock", "player", "pluto-tv", "prima-plus", "raiplay", "rakuten-tv", "rtl-plus", "sbs", "shahid", "shudder", "skyshowtime", "sony-pictures-core", "stan", "starz", "streamz", "telasa", "tf1", "tod", "tubi", "u-next", "universal-plus", "viaplay", "videoland", "vidio", "viki", "vix", "voyo", "vudu", "watchit", "wavve", "wow", "zee5" ], "type": "string", "description": "The streaming platform's Top 10 chart to fetch.", "default": "netflix" }, "country": { "title": "Country", "enum": [ "world", "argentina", "australia", "austria", "bahamas", "bahrain", "bangladesh", "belgium", "bolivia", "brazil", "bulgaria", "canada", "chile", "colombia", "costa-rica", "croatia", "cyprus", "czech-republic", "denmark", "dominican-republic", "ecuador", "egypt", "estonia", "finland", "france", "germany", "greece", "guadeloupe", "guatemala", "honduras", "hong-kong", "hungary", "iceland", "india", "indonesia", "ireland", "israel", "italy", "jamaica", "japan", "jordan", "kenya", "kuwait", "latvia", "lebanon", "lithuania", "luxembourg", "malaysia", "maldives", "malta", "martinique", "mauritius", "mexico", "morocco", "netherlands", "new-caledonia", "new-zealand", "nicaragua", "nigeria", "norway", "oman", "pakistan", "panama", "paraguay", "peru", "philippines", "poland", "portugal", "qatar", "reunion", "romania", "salvador", "saudi-arabia", "serbia", "singapore", "slovakia", "slovenia", "south-africa", "south-korea", "spain", "sri-lanka", "sweden", "switzerland", "taiwan", "thailand", "trinidad-and-tobago", "turkey", "ukraine", "united-arab-emirates", "united-kingdom", "united-states", "uruguay", "venezuela", "vietnam" ], "type": "string", "description": "The market to fetch the chart for. `World (Global)` is FlixPatrol's aggregate global chart.", "default": "world" }, "contentType": { "title": "Content type", "enum": [ "both", "movies", "tv" ], "type": "string", "description": "Which chart(s) to fetch. Each chart is a Top 10, so `Both` returns up to 20 records.", "default": "both" }, "date": { "title": "Chart date", "type": "string", "description": "`today` for the current chart, or an exact date in `YYYY-MM-DD` format for a recent historical chart. FlixPatrol only serves the last ~7 days for free; older dates require a FlixPatrol paid plan and will return a clear error.", "default": "today" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 20, "type": "integer", "description": "Hard cap on emitted chart entries. Each Top 10 chart naturally maxes at 10 rows per content type (20 for `Both`).", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not needed in normal operation (flixpatrol.com is publicly reachable with a browser User-Agent). Used automatically as a fallback only if the source starts blocking direct requests.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```