# NHentai Downloader (`maximedupre/nhentai-downloader`) Actor Download public NHentai gallery media links from known URLs. Export direct source-hosted media URLs with source IDs, page numbers, titles, thumbnails, and tags. - **URL**: https://apify.com/maximedupre/nhentai-downloader.md - **Developed by:** [Maxime Dupré](https://apify.com/maximedupre) (community) - **Categories:** Social media, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $4.50 / 1,000 saved media items 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.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 ### 📥 NHentai Downloader NHentai Downloader extracts direct source-hosted media links from public NHentai gallery URLs. Give the Actor one or more known gallery links, and it saves clean dataset rows with the source ID, page number, title when available, thumbnail URL, tags, and downloadable media URL details. It is built for workflows that need structured links rather than manually opening each page: exports, scheduled monitoring, data pipelines, internal tools, or API-based handoffs. The Actor does not store hosted copies, create ZIP archives, sign in to an account, or bypass private or unavailable content. It reads public pages and returns the media links the source exposes for successful targets. ### ✅ What You Get Each successful media file is saved as one dataset row. Rows include: - `nhentaiId` - the source gallery ID - `pageNumber` - the page number inside the gallery - `title` - the source gallery title when available - `thumbnailUrl` - the source thumbnail URL when available - `tags` - source tags or categories in source order - `mediaUrls` - direct source-hosted downloadable media URLs with quality, content type, dimensions, and file size when known The Actor validates media links before saving rows, so the dataset focuses on usable direct URLs. If a submitted URL is invalid, removed, unavailable, or does not expose downloadable media, it is handled in the run log without adding a misleading dataset row. ### 🔗 Input Add public NHentai gallery URLs in the `NHentai gallery URLs` field. Use one URL per row, for example: ```text https://nhentai.net/g/10000/ ```` The optional `Preferred quality` field lets you choose the source-exposed media option to prefer when more than one option is available: - `Best available` - `Largest file` - `Smallest file` Many gallery pages expose a single original image URL, so the selected preference is applied only when there are multiple source-visible options to choose from. ### 📊 Output Open the dataset when the run finishes, or read the results through the Apify API. A typical row looks like this: ```json { "nhentaiId": "10000", "pageNumber": 1, "title": "Example gallery title", "thumbnailUrl": "https://t.nhentai.net/galleries/10000/thumb.jpg", "tags": ["tag-one", "tag-two"], "mediaUrls": [ { "url": "https://i.nhentai.net/galleries/10000/1.jpg", "quality": "original", "contentType": "image/jpeg", "width": 1280, "height": 1800, "fileSizeBytes": null } ] } ``` `fileSizeBytes`, dimensions, title, thumbnail, and content type can be `null` when the source does not expose them reliably. The direct media URL remains the primary output. ### 💳 Pricing This Actor uses pay per event pricing. You are charged for each successful media item saved to the dataset. Invalid URLs, unsupported targets, unavailable pages, and pages with no accepted media rows are not counted as saved media items. For the current event price, open the Actor's Pricing tab in Apify Console. ### ⚖️ Responsible Use Use this Actor only for public content you are allowed to access and download. It does not access private accounts, paywalled content, deleted pages, or content that the public source page does not expose. If the source blocks access, removes a gallery, or stops exposing a media file, the Actor reports the issue in the run log and continues with the remaining URLs where possible. ### 🧭 Tips - Start with a small batch to confirm the output shape you want. - Use known gallery URLs instead of search pages or unrelated NHentai pages. - Export the dataset as JSON, CSV, Excel, or connect it to another Apify workflow. - Use the Apify API when you want to trigger runs from your own app or backend. ### 📝 Changelog - 0.1: Initial release. ### 🆘 Support For issues, questions, or feature requests, [file a ticket](https://console.apify.com/actors/maximedupre~nhentai-downloader/issues) and I'll fix or implement it in less than 24h 🫡 ### 🔗 Other actors - [XVideos Downloader ↗](https://apify.com/maximedupre/xvideos-downloader) - Export public XVideos MP4/HLS links, titles, thumbnails, and source metadata. - [Pornhub Downloader ↗](https://apify.com/maximedupre/pornhub-downloader) - Export public Pornhub video metadata, thumbnails, tags, and source-visible HLS links. - [RedGifs Bulk Downloader ↗](https://apify.com/maximedupre/redgifs-bulk-downloader) - Download RedGifs video links, IDs, or search results with direct MP4 links and metadata. - [AShemaleTube Downloader ↗](https://apify.com/maximedupre/ashemaletube-downloader) - Extract public AShemaleTube HLS media links, titles, durations, thumbnails, and tags. - [Facebook Media Downloader ↗](https://apify.com/maximedupre/facebook-media-downloader) - Export public Facebook videos and reels with direct media links, thumbnails, captions, and engagement data. **Made with ❤️ by Maxime Dupré** # Actor input Schema ## `startUrls` (type: `array`): Add one public NHentai gallery URL per row. ## `preferredQuality` (type: `string`): Choose which source-exposed media option to prefer when more than one is available. ## Actor input object example ```json { "startUrls": [ { "url": "https://nhentai.net/g/1/" }, { "url": "https://nhentai.net/g/3/" }, { "url": "https://nhentai.net/g/4/" }, { "url": "https://nhentai.net/g/6153/" }, { "url": "https://nhentai.net/g/1659/" } ], "preferredQuality": "best" } ``` # Actor output Schema ## `results` (type: `string`): Open one row per successful public NHentai gallery media file with direct source-hosted download links. # 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 = { "startUrls": [ { "url": "https://nhentai.net/g/1/" }, { "url": "https://nhentai.net/g/3/" }, { "url": "https://nhentai.net/g/4/" }, { "url": "https://nhentai.net/g/6153/" }, { "url": "https://nhentai.net/g/1659/" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("maximedupre/nhentai-downloader").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 = { "startUrls": [ { "url": "https://nhentai.net/g/1/" }, { "url": "https://nhentai.net/g/3/" }, { "url": "https://nhentai.net/g/4/" }, { "url": "https://nhentai.net/g/6153/" }, { "url": "https://nhentai.net/g/1659/" }, ] } # Run the Actor and wait for it to finish run = client.actor("maximedupre/nhentai-downloader").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 '{ "startUrls": [ { "url": "https://nhentai.net/g/1/" }, { "url": "https://nhentai.net/g/3/" }, { "url": "https://nhentai.net/g/4/" }, { "url": "https://nhentai.net/g/6153/" }, { "url": "https://nhentai.net/g/1659/" } ] }' | apify call maximedupre/nhentai-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=maximedupre/nhentai-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "NHentai Downloader", "description": "Download public NHentai gallery media links from known URLs. Export direct source-hosted media URLs with source IDs, page numbers, titles, thumbnails, and tags.", "version": "0.1", "x-build-id": "Aa6UrsYptso0n7qCI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~nhentai-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-nhentai-downloader", "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/maximedupre~nhentai-downloader/runs": { "post": { "operationId": "runs-sync-maximedupre-nhentai-downloader", "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/maximedupre~nhentai-downloader/run-sync": { "post": { "operationId": "run-sync-maximedupre-nhentai-downloader", "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": [ "startUrls" ], "properties": { "startUrls": { "title": "NHentai gallery URLs", "minItems": 1, "maxItems": 1000, "type": "array", "description": "Add one public NHentai gallery URL per row.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "title": "URL", "type": "string", "description": "Public NHentai gallery URL.", "pattern": "^https?:\\/\\/.+" } } } }, "preferredQuality": { "title": "Preferred quality", "enum": [ "best", "largest", "smallest" ], "type": "string", "description": "Choose which source-exposed media option to prefer when more than one is available.", "default": "best" } } }, "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 } } } } } } } } } } ```