# TXXX Downloader (`maximedupre/txxx-downloader`) Actor Download public TXXX video data from URLs or numeric IDs. Export direct source-hosted media links, titles, durations, thumbnails, tags, source URLs, and expiry hints. - **URL**: https://apify.com/maximedupre/txxx-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 resolved videos 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 ### ๐Ÿ“ฅ TXXX downloader for public video URLs and IDs TXXX Downloader extracts direct source-hosted media links and metadata from public [TXXX](https://txxx.com/) video pages. Paste one or more TXXX watch-page URLs or numeric video IDs and get a clean Apify dataset with video IDs, source URLs, titles, descriptions, durations, thumbnails, tags, media URL expiry times when available, and direct media links. Use this TXXX video downloader when you already have public video targets and need repeatable exports for content review, cataloging, media operations, research, archiving workflows, or an API pipeline. The Actor works with public, reachable TXXX videos only. You do not need TXXX cookies, a TXXX account, a browser extension, email OTP, local playback, or a source API key. For a small first run, keep the prefilled sample targets and start the Actor. Once the output shape fits your workflow, paste your own list of public TXXX video URLs or IDs, run a larger batch, schedule the Actor, or call it through the Apify API. ### โœ… What this Actor does - Accepts public TXXX watch-page URLs and numeric video IDs. - Deduplicates repeated targets by source video ID. - Saves one dataset row per successfully resolved public video. - Returns source-hosted media links exposed for each video. - Adds title, description, duration, thumbnail URL, tags, and categories when TXXX exposes them. - Parses media URL expiry timestamps when the signed source URL exposes one. - Skips invalid, duplicate, private, removed, blocked, unresolved, or no-media targets without saving paid failure rows. This Actor is focused on known public TXXX videos. It does not search TXXX, crawl categories, process profiles, bypass private access, download files into Apify storage, create ZIP archives, transcode media, or install a browser extension. ### ๐Ÿ“ฆ Data you can export Each output row represents one public TXXX video where at least one direct source-hosted media link was found. Core fields include: - `videoId` - stable TXXX video ID for dedupe and reruns. - `sourceUrl` - source-confirmed TXXX watch-page URL. - `title` - source video title, when available. - `description` - source video description, when available. - `durationSeconds` - video duration in seconds, when available. - `thumbnailUrl` - source thumbnail or poster image URL, when available. - `tags` - source-backed tags and categories. - `availableFormats` - direct media formats with `quality`, `width`, `height`, `contentType`, `mediaUrl`, and `expiresAt`. Direct media links can be signed and time-limited. Use `availableFormats[].expiresAt` to decide when to refresh results. The Actor does not invent missing quality labels, dimensions, or metadata; nullable fields stay empty when TXXX does not expose them. You can open the dataset in Apify, export it as JSON, CSV, Excel, XML, RSS, or HTML, call it through the Apify API, schedule recurring runs, or connect results to webhooks and integrations. ### ๐Ÿš€ How to run 1. Open the Actor input. 2. Add one or more public TXXX video URLs or numeric IDs in **TXXX videos**. 3. Start the Actor. 4. Open the dataset. 5. Use `availableFormats[].mediaUrl` for the direct source-hosted media links. The Actor pushes successful rows during the run, so you can inspect early results before a larger batch finishes. ### ๐Ÿงพ Input | Field | What to enter | | --------- | ------------------------------------------------------------- | | `targets` | One or more public TXXX watch-page URLs or numeric video IDs. | Input example: ```json { "targets": [ "https://txxx.com/videos/123456/example-video/", "123456" ] } ```` The public input accepts up to 100 targets per run. Submit fewer targets when you want a smaller test. ### ๐Ÿ“ค Output example ```json { "videoId": "123456", "sourceUrl": "https://txxx.com/videos/123456/example-video/", "title": "Example video title", "description": null, "durationSeconds": 742, "thumbnailUrl": "https://tn.txxx.example/contents/videos_screenshots/123000/123456/360x240/1.jpg", "tags": ["HD", "example"], "availableFormats": [ { "quality": "249kbps", "width": null, "height": null, "contentType": "video/mp4", "mediaUrl": "https://cdn.txxx.example/videos/123456/example.mp4", "expiresAt": "2026-06-25T16:24:41.000Z" } ] } ``` Failed targets are reported in logs and status messages, not as dataset rows. This keeps exports focused on successfully resolved videos. ### ๐Ÿ’ณ Pricing This Actor uses pay-per-event pricing. You are charged one `Resolved video` event only for each public TXXX video saved to the dataset with at least one direct media link. Failed, invalid, duplicate, private, removed, blocked, unresolved, or no-media targets do not create paid video events. ### โš ๏ธ Limits and access This Actor works with public TXXX videos that can be reached without logging in. It does not use your TXXX account, cookies, browser session, browser extension, or source API keys. Some media URLs can expire after they are fetched. If a direct link stops working later, rerun the Actor for the same source URL or video ID to get fresh source links. Use the Actor only for content you have the right to access, process, or download. The Actor returns source-hosted links; it does not copy videos into Apify storage. ### โ“ FAQ #### ๐Ÿ’พ Does this TXXX downloader save MP4 files? No. The Actor returns direct source-hosted media links and metadata in the dataset. It does not mirror files, create ZIP archives, or store video copies. #### ๐Ÿ” Does it need TXXX cookies or an account? No. It is built for public, reachable TXXX videos and does not ask for cookies, account sessions, source API keys, or extension accounts. #### ๐ŸŽš๏ธ Can I choose a preferred quality? The Actor returns all source-exposed variants it can validate. Choose the media link you want from `availableFormats` in the dataset. #### ๐Ÿšง Why are some targets skipped? Targets can be skipped when they are invalid, duplicate, private, removed, blocked by the source, unresolved, or have no source-exposed media link. Skipped targets are reported in logs instead of being saved as failure rows. #### ๐Ÿ”Œ Can I use the results through an API? Yes. The output is an Apify dataset, so you can fetch it through the Apify API, export it in common formats, schedule runs, or connect it to downstream workflows. ### ๐Ÿ“ Changelog - 0.1: Initial release. ### ๐Ÿ†˜ Support For issues, questions, or feature requests, [file a ticket](https://console.apify.com/actors/maximedupre~txxx-downloader/issues) and I'll fix or implement it in less than 24h ๐Ÿซก ### ๐Ÿ”— Other actors - [XVideos Downloader โ†—](https://apify.com/maximedupre/xvideos-downloader) - Resolve public XVideos watch-page URLs into direct MP4/HLS links and metadata. - [Upornia Downloader โ†—](https://apify.com/maximedupre/upornia-downloader) - Extract direct MP4 links, metadata, tags, and expiry hints from public Upornia video URLs. - [PornTrex Downloader โ†—](https://apify.com/maximedupre/porntrex-downloader) - Export direct source-hosted MP4 links and metadata from public PornTrex watch pages. - [Motherless Downloader โ†—](https://apify.com/maximedupre/motherless-downloader) - Resolve public Motherless video URLs or IDs into direct MP4 links and metadata. - [SpankBang Downloader โ†—](https://apify.com/maximedupre/spankbang-downloader) - Extract direct media links, quality variants, thumbnails, tags, and expiry hints from public SpankBang URLs. **Made with โค๏ธ by Maxime Duprรฉ** # Actor input Schema ## `targets` (type: `array`): Add one public TXXX video URL or numeric video ID per row. ## Actor input object example ```json { "targets": [ "https://txxx.com/videos/21661387/horny-adult-video-gags-crazy/", "https://txxx.com/videos/21662103/", "https://txxx.com/videos/21662567/", "https://txxx.com/videos/21665641/", "https://txxx.com/videos/21666549/" ] } ``` # Actor output Schema ## `results` (type: `string`): Open the dataset with one successfully resolved public TXXX video per row. # 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 = { "targets": [ "https://txxx.com/videos/21661387/horny-adult-video-gags-crazy/", "https://txxx.com/videos/21662103/", "https://txxx.com/videos/21662567/", "https://txxx.com/videos/21665641/", "https://txxx.com/videos/21666549/" ] }; // Run the Actor and wait for it to finish const run = await client.actor("maximedupre/txxx-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 = { "targets": [ "https://txxx.com/videos/21661387/horny-adult-video-gags-crazy/", "https://txxx.com/videos/21662103/", "https://txxx.com/videos/21662567/", "https://txxx.com/videos/21665641/", "https://txxx.com/videos/21666549/", ] } # Run the Actor and wait for it to finish run = client.actor("maximedupre/txxx-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 '{ "targets": [ "https://txxx.com/videos/21661387/horny-adult-video-gags-crazy/", "https://txxx.com/videos/21662103/", "https://txxx.com/videos/21662567/", "https://txxx.com/videos/21665641/", "https://txxx.com/videos/21666549/" ] }' | apify call maximedupre/txxx-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=maximedupre/txxx-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TXXX Downloader", "description": "Download public TXXX video data from URLs or numeric IDs. Export direct source-hosted media links, titles, durations, thumbnails, tags, source URLs, and expiry hints.", "version": "0.1", "x-build-id": "x9aGE7TT1hnd4DGdS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~txxx-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-txxx-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~txxx-downloader/runs": { "post": { "operationId": "runs-sync-maximedupre-txxx-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~txxx-downloader/run-sync": { "post": { "operationId": "run-sync-maximedupre-txxx-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": [ "targets" ], "properties": { "targets": { "title": "TXXX videos", "minItems": 1, "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Add one public TXXX video URL or numeric video ID per row.", "items": { "type": "string", "minLength": 1 } } } }, "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 } } } } } } } } } } ```