Torrent Downloader

🧲 Torrent downloader for magnet links and .torrent URLs

Torrent Downloader downloads files from magnet links and direct HTTP/HTTPS .torrent URLs, saves completed files to Apify storage, and returns one clean dataset row per saved file. Each row includes the submitted target, torrent name, info hash, file name, file path, file size, and a downloadUrl you can use to retrieve the file from the run's key-value store.

Use this torrent downloader when you already have torrent targets and need a repeatable Apify workflow for downloading files, exporting a manifest, or connecting the result to the Apify API, schedules, webhooks, or integrations. Start with the prefilled WebTorrent Sintel sample torrent, keep the default size caps, and inspect the output before running larger targets.

The Actor accepts public magnet links and public HTTP/HTTPS .torrent file URLs. It does not ask for cookies, a login, an API key, private tracker credentials, or user-provided proxy settings.

✅ What this Torrent Downloader does

• Accepts magnet links.
• Accepts direct HTTP and HTTPS .torrent file URLs.
• Processes multiple torrent targets in one run.
• Saves completed files to Apify key-value storage.
• Emits one dataset row per successfully saved file.
• Includes torrent provenance: submitted target, torrent name, and info hash when available.
• Includes file details: file name, file path inside the torrent, file size, and download URL.
• Lets you set a maximum size per torrent and a maximum total saved size for the run.
• Skips unsupported, unavailable, too-large, or incomplete targets without creating misleading result rows.
• Charges only for files that are successfully saved and emitted to the dataset.

This Actor is focused on downloading from known torrent targets. It does not search torrent sites, scrape torrent indexes, bypass private trackers, seed after download, or discover torrents for you.

📦 Data you can export

Each output row represents one saved torrent file.

Field	Description
target	Magnet link or HTTP/HTTPS .torrent URL submitted in the input.
torrentName	Torrent display name when available.
infoHash	Torrent info hash when available.
fileName	Saved file name.
filePath	File path inside the torrent when available.
fileSizeBytes	File size in bytes when known.
downloadUrl	Apify storage URL for retrieving the saved file.

You can open the dataset in Apify, export it as JSON, CSV, Excel, XML, RSS, or HTML, call it through the Apify API, schedule repeat runs, or connect it to webhooks and integrations. The downloaded files are stored separately in the run's key-value store and linked from each row through downloadUrl.

🚀 How to run

1. Open the Actor input.
2. Paste one or more magnet links or HTTP/HTTPS .torrent URLs in Torrent targets.
3. Keep Maximum size per torrent at 250 MB for a small first run, or raise it when you expect larger torrents.
4. Keep Maximum total size for this run at 500 MB, or lower it when testing.
5. Start the Actor and open the dataset.
6. Use each row's downloadUrl to retrieve the saved file.

For a first test, keep the prefilled Sintel torrent URL. It is a public sample torrent from WebTorrent and includes small subtitle files that are useful for checking the output shape.

🔧 Input

Field	Required	Description
targets	Yes	Magnet links or direct HTTP/HTTPS .torrent file URLs.
maxTorrentSizeMb	No	Skips a torrent when its declared total size is above this cap. Default is 250.
maxRunSizeMb	No	Stops accepting more files when saved downloads reach this run cap. Default is 500.

Example input:

{
  "targets": [
    "https://webtorrent.io/torrents/sintel.torrent",
    "magnet:?xt=urn:btih:08ada5a7a6183aae1e09d831df6748d566095a10&dn=Sintel"
  ],
  "maxTorrentSizeMb": 250,
  "maxRunSizeMb": 500
}

📄 Output example

{
  "target": "https://webtorrent.io/torrents/sintel.torrent",
  "torrentName": "Sintel",
  "infoHash": "08ada5a7a6183aae1e09d831df6748d566095a10",
  "fileName": "Sintel.en.srt",
  "filePath": "Sintel/Sintel.en.srt",
  "fileSizeBytes": 1514,
  "downloadUrl": "https://api.apify.com/v2/key-value-stores/default/records/torrent-files__08ada5a7a6183aae1e09d831df6748d566095a10__0002-Sintel__Sintel.en.srt"
}

torrentName, infoHash, filePath, and fileSizeBytes can be null when the torrent metadata or saved file does not expose the value reliably.

💳 Pricing

This Actor uses pay-per-event pricing. You are charged $0.0045 for each torrent file successfully saved to Apify storage and emitted to the dataset.

Skipped targets, invalid inputs, unavailable torrents, too-large torrents, and files that cannot be saved do not create output rows and are not charged as downloaded files. Use the size caps to keep storage and run cost bounded before processing larger torrents.

⚠️ Limits and responsible use

• Use this Actor only for content you own, have permission to process, or are otherwise allowed to download in your jurisdiction and under the source site's terms.
• Torrent availability depends on peers, trackers, metadata, and the submitted target. Some torrents may be slow or unavailable at run time.
• The Actor does not seed after downloading.
• The Actor does not search torrent websites or discover torrent files.
• Private trackers, login-only torrents, invitation-only trackers, cookies, and user credentials are not supported.
• Download URLs point to files saved in Apify storage for that run.
• Very large torrents can use significant storage and compute. Keep the size caps low until you know the target size.

❓ FAQ

🧲 Can I use magnet links?

Yes. Paste a magnet link in Torrent targets. The Actor waits for torrent metadata, applies the size caps, then saves files that can be downloaded within the run limits.

📄 Can I use .torrent file URLs?

Yes. Paste a direct HTTP or HTTPS .torrent URL. The URL should point to the .torrent file itself, not a search page, listing page, or website download button.

🔐 Do I need cookies, a login, or an API key?

No. The Actor is built for public torrent targets and does not ask for user credentials.

🌱 Does this Actor seed files?

No. The Actor downloads and saves completed files. It does not expose a seeding option because Apify Actors are best suited to bounded runs, not long-running torrent seeding.

🧩 Why did my torrent produce no rows?

The Actor saves rows only for files that are successfully downloaded and stored. A target can produce no rows when it is invalid, unsupported, larger than your cap, missing metadata, unavailable, or not reachable during the run.

📝 Changelog

• 0.1: Initial release.

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Other actors

• YouTube Music Downloader ↗ - Save audio files from direct YouTube Music and YouTube URLs.
• TikTok Video Downloader ↗ - Download public TikTok video or audio files to Apify storage.
• Pinterest Video Downloader ↗ - Extract Pinterest video and image media from public pin targets.
• Streamable Video Downloader ↗ - Get direct Streamable MP4 links, thumbnails, and source metadata.
• RSS Feed Reader ↗ - Parse public RSS, Atom, RDF, and JSON Feed URLs into dataset rows.

Made with ❤️ by Maxime Dupré