# Torrent Scraper (`ondro/torrent-scraper`) Actor Scrape information about torrents from popular torrent sites. Download the data in JSON, CSV, and Excel. - **URL**: https://apify.com/ondro/torrent-scraper.md - **Developed by:** [Ondrej KlinovskΓ½](https://apify.com/ondro) (community) - **Categories:** Other, Open source - **Stats:** 235 total users, 9 monthly users, 100.0% runs succeeded, 6 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Torrent Scraper This scraper collects information about torrents from popular torrent sites. It was inspired by [cli-torrent-dl](https://github.com/X0R0X/cli-torrent-dl). Torrents from the sites are sorted by the number of seeds. Torrent sites used by the scraper: - [gtdb.to](https://www.gtdb.to) - [nyaa.si](https://nyaa.si) - [limetorrents.to](https://www.limetorrents.to) - [tpb.party](https://tpb.party) - [solidtorrents.to](https://solidtorrents.to) ### Input parameters | Parameter | Required | Description | | - | - | - | | query | Yes | torrent name you search for | | torrentSites | No | you can select which site you want to scrape | | pageLimit | No | how many pages to scrape (at most), default to 1 if `minSeedsForNextPage` is not set | | minSeedsForNextPage | No | minimum seeds each torrent needs to have in order to scrape next page | #### Input example With this input, actor will scrape at most 3 pages on each site. If, for example, the last torrent on a second page has less than 10 seeds, the scraper will not scrape the next page. ```json { "query": "ubuntu", "torrentSites": [ "thePirateBay", "gloTorrents", "limeTorrents", "solidTorrents" ], "pageLimit": 3, "minSeedsForNextPage": 10 } ```` ### Output Output is stored in a dataset, where each item contains information like `title`, `size`, `seeds` etc., but most importantly `downloadUrl` and `magnetUrl`. `downloadUrl` is a link where you can download the torrent file from. On the other hand, you don't need to download anything when using `magnetUrl`, all you need to do is to open it in your favorite torrent client. You can download the dataset extracted by Torrent Scraper in various formats such as JSON, HTML, CSV, or Excel. #### Output example (JSON) ```json { "title": "debian-12.0.0-amd64-netinst.iso", "webUrl": "https://solidtorrents.to/torrents/debian-12-0-0-amd64-netinst-iso-0d977/6486d0ab60e0fda62643a9eb/", "size": "774 MB", "seeds": 97, "leeches": 175, "magnetUrl": "magnet:?xt=urn:btih:B851474B74F65CD19F981C723590E3E520242B97&tr=udp%3A%2F%2Ftracker.bitsearch.to%3A1337%2Fannounce&tr=udp%3A%2F%2Ftracker2.dler.com%3A80%2Fannounce&tr=udp%3A%2F%2Ftracker.breizh.pm%3A6969%2Fannounce&tr=udp%3A%2F%2Fwww.torrent.eu.org%3A451%2Fannounce&tr=udp%3A%2F%2Ftracker.torrent.eu.org%3A451%2Fannounce&dn=%5BBitsearch.to%5D+debian-12.0.0-amd64-netinst.iso", "downloadUrl": "https://itorrents.org/torrent/B851474B74F65CD19F981C723590E3E520242B97.torrent?title=[Bitsearch.to]debian-12.0.0-amd64-netinst.iso", "origin": "https://solidtorrents.to" } ``` # Actor input Schema ## `query` (type: `string`): Query for torrent search ## `torrentSites` (type: `array`): Select what sites you want to scrape. If none selected, then all sites will be used ## `pageLimit` (type: `integer`): How many pages should be scraped on each torrent site ## `minSeedsForNextPage` (type: `integer`): Scraper will not scrape next page if the last torrent on current page has less seeds than this value ## `proxyConfiguration` (type: `object`): Select proxies to be used by the scraper. ## Actor input object example ```json { "query": "debian", "torrentSites": [ "gloTorrents", "thePirateBay", "limeTorrents", "nyaa", "solidTorrents" ], "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": "debian", "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("ondro/torrent-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": "debian", "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("ondro/torrent-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": "debian", "proxyConfiguration": { "useApifyProxy": true } }' | apify call ondro/torrent-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=ondro/torrent-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Torrent Scraper", "description": "Scrape information about torrents from popular torrent sites. Download the data in JSON, CSV, and Excel.", "version": "0.0", "x-build-id": "wdsFW9CsNs2v73o2w" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ondro~torrent-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ondro-torrent-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/ondro~torrent-scraper/runs": { "post": { "operationId": "runs-sync-ondro-torrent-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/ondro~torrent-scraper/run-sync": { "post": { "operationId": "run-sync-ondro-torrent-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": [ "query" ], "properties": { "query": { "title": "Query", "type": "string", "description": "Query for torrent search" }, "torrentSites": { "title": "Torrent Sites", "type": "array", "description": "Select what sites you want to scrape. If none selected, then all sites will be used", "items": { "type": "string", "enum": [ "gloTorrents", "thePirateBay", "limeTorrents", "nyaa", "solidTorrents" ], "enumTitles": [ "Glo Torrents", "The Pirate Bay", "Lime Torrents", "Nyaa Torrents", "Solid Torrents" ] }, "default": [ "gloTorrents", "thePirateBay", "limeTorrents", "nyaa", "solidTorrents" ] }, "pageLimit": { "title": "Page limit", "minimum": 1, "type": "integer", "description": "How many pages should be scraped on each torrent site" }, "minSeedsForNextPage": { "title": "Minimum seeds for next page", "minimum": 1, "type": "integer", "description": "Scraper will not scrape next page if the last torrent on current page has less seeds than this value" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by the scraper." } } }, "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 } } } } } } } } } } ```