# Netflix Search Scraper (`alien_force/netflix-search-scraper`) Actor This actor scrapes Netflix titles (movies, series) using advanced filters like search query, actor, genre, release year, and availability. It fetches rich data, including images, cast, IMDb metrics, and episode details for series, all while ensuring fast, reliable results with proxy support. - **URL**: https://apify.com/alien\_force/netflix-search-scraper.md - **Developed by:** [Alien Force](https://apify.com/alien_force) (community) - **Categories:** Videos, SEO tools - **Stats:** 57 total users, 1 monthly users, 100.0% runs succeeded, 4 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing $30.00/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 ## Netflix Search Scraper ### Introduction Welcome to the **Netflix Scraper Actor**! Whether you're an avid Netflix user, a developer building a media app, or a data enthusiast looking to dig into Netflix's treasure trove of movies and series, this actor is for you. With powerful querying capabilities, this actor allows you to easily retrieve Netflix movie and series titles based on various search criteria. You can filter by genre, actor, release years, availability, and more. It's everything you need to get Netflix data in a flash! ### Key Features - **Search Netflix Titles by Query:** Get movies and series based on a search term. - **Actor-based Search:** Find titles associated with a specific actor (including supporting roles or production credits, not just lead actors). - **Advanced Filtering Options:** Filter by start year, end year, genre, availability ("Expiring" or "New last 24 hours"), and other criteria. - **Sort Results:** Sort your data by relevance, date, rating and more. - **Rich Data:** Retrieve Netflix movie/series images, countries, episodes (for series), cast details, and IMDb metrics. - **Optimized Performance:** Scrape data with efficient proxies to ensure fast and reliable results. ### Why Use This Actor? This actor is perfect for anyone looking to build a Netflix-inspired experience or gather insights into Netflix's catalog for analysis, content creation, or development purposes. Whether you're scraping data for your app, building an analytics dashboard, or just curious about Netflix’s ever-changing content library, this actor provides easy access to key Netflix data points. With powerful search and filtering features, you can tailor the data to your exact needs. From the latest movies to classic series, you can grab the content you need, quickly and efficiently. Plus, the added IMDb metrics and cast details mean you get rich, actionable data with minimal effort. ### Input Schema Here’s what you need to know about the inputs: ```json { "query": "Salt", // Search query (e.g., movie/series name or keyword) "actor_query": "Angelina Jolie", // Search for titles by a specific actor "genre_query": "", // Filter by genre "type": "Movie", // Type of content: "Movie" or "Series" "start_year": 2025, // Start year of release for filtering "end_year": 2007, // End year of release for filtering "filter_by": "Expiring", // Filter by availability ("Expiring", "New last 24 hours") "order_by": "Date", // Sort results by ["Relevance", "Date", "DateAsc", "Rating", "RatingAsc", "Title", "VideoType", "FilmYear", "FilmYearAsc", "Runtime"] "limit": 100, // Limit the number of results "proxyConfiguration": { "useApifyProxy": true // Use Apify's proxy for faster scraping } } ``` ### Output Schema ```json { "netflixid": 82013962, "title": "Temptation", "matlabel": "Recommended for ages 16 and up", "matlevel": "80", "avgrating": 3.7760384, "predrating": 3.8, "synopsis": "When ambitious young journalist Inez lands a story profiling an enigmatic soccer star, she enters a seductive world of luxury, lies and danger.", "vtype": "series", "img": "https://occ-0-1433-1432.1.nflxso.net/dnm/api/v6/mAcAr9TxZIVbINe88xb3Teg5_OA/AAAABaCiiF-3YvMFBfa3GeJoYzFqKZ_zgn_Ig9yRi9IWa7xqp2pGUdO_F-rVtDA3LTS3zjnhteGWhVRTUxLmH4R7YtVFuDRhj4eqohTT3xyAOQSbmZnVll3MPUiR1zcRJX0v4tbhebKYrYTbE5YEPPNP7qMWyxSyqICR0S_mhHSIBtw.jpg?r=db1", "lgimg": "https://occ-0-1433-1432.1.nflxso.net/dnm/api/v6/mAcAr9TxZIVbINe88xb3Teg5_OA/AAAABeF2HyCKs0BmI6etpFMd2k8jJGBoDf4uVNeZOlTwyNFXD_B4bgCWliJZFaQH6zprIZ0abhzAk7Wf7qF4PB5vcLGwcJfgHJL1XAZhnZzWhKMdt7BaXiMxEK5tizQAylDGdAN18eQQ6MVI0GXjI_qcFr3afyH24D7gdvGbnxIewUMviw.jpg?r=db1", "nfid": 82013962, "runtime": 6016, "nfdate": "2025-05-19", "curdate": "2025-05-20", "year": 2025, "imdbposter": "https://m.media-amazon.com/images/M/MV5BMmNhODIyNTctZDhmZC00YmNiLTg3ODMtMzUzOTE5MzQ5MjIyXkEyXkFqcGdeQXVyNjc0MzMzNjA@._V1_SX300.jpg", "imdbgenre": "Drama Film-Noir Thriller", "imdbrated": "Approved", "imdbruntime": "98 min", "imdbawards": "0", "imdbcountry": "United States", "imdblanguage": "English", "imdbrating": 6.5, "imdbid": "tt0039015", "imdbplot": "In a flashback late-Victorian beauty Ruby a divorcee with a shady past calculatingly marries rich Egyptologist Nigel who installs her at his Cairo estate while he digs for mummies. Bored Ruby undertakes to recover a friend's letters from Baroudi. But when she meets the blackmailer mutual attraction leads to an affair. As Ruby gets in deeper she finds Baroudi is even more unscrupulous than she dreamed.", "imdbmetascore": "0", "imdbvotes": 394, "imdblocalimage": 1, // nullable "top250": 0, // nullable "top250tv": 0, // nullable "images": { "bo166x236": [ { "url": "https://occ-0-1433-1432.1.nflxso.net/dnm/api/v6/mAcAr9TxZIVbINe88xb3Teg5_OA/AAAABaCiiF-3YvMFBfa3GeJoYzFqKZ_zgn_Ig9yRi9IWa7xqp2pGUdO_F-rVtDA3LTS3zjnhteGWhVRTUxLmH4R7YtVFuDRhj4eqohTT3xyAOQSbmZnVll3MPUiR1zcRJX0v4tbhebKYrYTbE5YEPPNP7qMWyxSyqICR0S_mhHSIBtw.jpg?r=db1", "width": 166 } ], "bo342x192": [ { "url": "https://occ-0-1433-1432.1.nflxso.net/dnm/api/v6/Qs00mKCpRvrkl3HZAN5KwEL1kpE/AAAABZRiUWRJ9tzSEIfEcNwb03hvpbfW452ONX69JZ8AMnLzJg-pCYOXpj3qgyTb9QTrKKZuEoVAFa3j-BrrWEbUHU_AHOiFoMvU4OicmE34Csdue4YzSibJ-LN45haaAZPkm7-fEdEuhicQbEwxdIg0QLy-GQ7lq3PSFEOR2UJifOZ5.jpg?r=884", "width": 342 } ], "bo342x684": [ { "url": "https://occ-0-1433-1432.1.nflxso.net/dnm/api/v6/mAcAr9TxZIVbINe88xb3Teg5_OA/AAAABeF2HyCKs0BmI6etpFMd2k8jJGBoDf4uVNeZOlTwyNFXD_B4bgCWliJZFaQH6zprIZ0abhzAk7Wf7qF4PB5vcLGwcJfgHJL1XAZhnZzWhKMdt7BaXiMxEK5tizQAylDGdAN18eQQ6MVI0GXjI_qcFr3afyH24D7gdvGbnxIewUMviw.jpg?r=db1", "width": 342 } ], "bg": [ { "url": "https://occ-0-1433-1432.1.nflxso.net/dnm/api/v6/E8vDc_W8CLv7-yMQu8KMEC7Rrr8/AAAABWufLU0FjsOx216lcuS5cdCqGIkrPL9Rb9LYfBOvFlTiTBzOBbZ8Njj0PPEHqym9jVqHehG1eJrk0gkQZw6dnAyJkPawfRnY2NFj.jpg?r=ada", "width": 477 }, { "url": "https://occ-0-1433-1432.1.nflxso.net/dnm/api/v6/6AYY37jfdO6hpXcMjf9Yu5cnmO0/AAAABVusFivc21pxm7pkhZiFwD752ig-ol4VQWyosHwbFH09Qh4bJVaPPLH_z4qpLm-4ifHSYeUeiYZcRZQfDFlzAbChyammGSS8MOHX.jpg?r=a1a", "width": 720 } ], "bo665x375": [ { "url": "https://occ-0-1433-1432.1.nflxso.net/dnm/api/v6/Qs00mKCpRvrkl3HZAN5KwEL1kpE/AAAABazcp4ZSaJGMwNSS9a-V21SsFA4cUQM892penmbcYaSwUY-4srYzNBV5NvWN433wgjfPwFVHP8FZ9q8AAMkBUX_w-5ZIvB5sFQO_jooad-4OAftXb4WrCaDo22cnJOlKKhKoFvM0idCltUc4EOblQevOzln0OCtNt_1slct5579TMw.jpg?r=884", "width": 665 } ], "bo1280x448": [ { "url": "https://occ-0-1433-1432.1.nflxso.net/dnm/api/v6/Qs00mKCpRvrkl3HZAN5KwEL1kpE/AAAABZd8XQSx413iR8rpYz5UjAb99y10ypAy3h3jEp0yJm4WP5iOZcMFRjEK4LbU7vDWMJHRo3wO_8netBlZXvKJaTBGgTzV7h4SNAWlDYTTyNoQlTA0tXVF_u1q2pxt9q5NiTc5fzT12-HHVbdplkRyaKw9zkqdP-cBEujAopZhhV-6cg.jpg?r=884", "width": 1280 } ] }, "genres": [ { "nfid": 11714, "genre": "TV Dramas" }, { "nfid": 89811, "genre": "TV Thrillers" } ], "people": [ { "type": "Actor", "arr": [ { "fullname": "Andrea Preti" }, { "fullname": "Ewa Ekwa" } ] }, { "type": "Director", "arr": [ { "fullname": "Maria Sadowska" } ] } ], "countries": [ { "cc": "PL", "id": 392, "country": "Poland ", "seasdet": "S1(3)", "expiredate": null, "newdate": "2025-05-19", "audio": "Polish [Original]", "subtitle": "English,Polish", "hd": "1", "uhd": "0", "3d": null } ], "episodes": [ { "season": 1, "episodes": [ { "epid": 82013964, "seasid": 82013963, "epnum": 1, "seasnum": 1, "synopsis": "", "title": "Episode 1", "img": "https://occ-0-1433-1432.1.nflxso.net/dnm/api/v6/9pS1daC2n6UGc3dUogvWIPMR_OU/AAAABWvF1FgzUiCQjmdIu0lvn1i2W0NEZP20y5iZqdoNdKOlYhziumcuXQr4xdWw3daTQFBgpHHO-E4Qb6aixl6va3mbm7QNM-wIWTekXKu_joA8cC6ZjHvI3NS2.jpg?r=b7f" } ] } ] } ``` # Actor input Schema ## `query` (type: `string`): Provide a query keyword to search for Netflix Titles (Movies, Series) ## `actor_query` (type: `string`): Provide the name of an actor, actress, director, or producer to search for Netflix titles associated with them. ## `genre_query` (type: `string`): Provide a genre to search for Netflix titles associated with that genre. ## `type` (type: `string`): Select Content Type ## `start_year` (type: `integer`): Enter the starting year (integer) to filter results from this year onward ## `end_year` (type: `integer`): Enter the ending year (integer) to filter results up to this year ## `filter_by` (type: `string`): Filter results by expiring titles or those newly added in the last 24 hours. ## `order_by` (type: `string`): Select how to order the results. ## `limit` (type: `integer`): Limit number of results ## `proxyConfiguration` (type: `object`): Configure proxies to be used by the crawler. ## Actor input object example ```json { "query": "Harry Potter", "limit": 10, "proxyConfiguration": { "useApifyProxy": true } } ``` # 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 = { "query": "Harry Potter" }; // Run the Actor and wait for it to finish const run = await client.actor("alien_force/netflix-search-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 = { "query": "Harry Potter" } # Run the Actor and wait for it to finish run = client.actor("alien_force/netflix-search-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 '{ "query": "Harry Potter" }' | apify call alien_force/netflix-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=alien_force/netflix-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/acts/SNpqDJRf4P2ryDrdi/builds/StXp3hVifPLx3qRV1/openapi.json