# YouTube Scraper (`zeropointstudio/youtube-scraper`) Actor All-in-one YouTube scraper: search, channels, playlists, video URLs, and transcripts in a single run. Powered by TranscriptAPI. - **URL**: https://apify.com/zeropointstudio/youtube-scraper.md - **Developed by:** [Andrej Ε imunaj](https://apify.com/zeropointstudio) (community) - **Categories:** Videos, Social media, AI - **Stats:** 2 total users, 1 monthly users, 33.3% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 search requests 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 ## $5/1K Requests β€” YouTube Scraper: Search, Channels, Playlists & Transcripts in One Run > **Scrape YouTube at scale: search results, full channels, entire playlists, direct video URLs, and transcripts β€” all from a single actor. Pay per API call ($0.005), not per result. No YouTube API key, no actor-start fee, errors are free.** | ⚑ **Sub-500 ms typical** | πŸ“Š **15 M+ requests / month** | πŸ›‘οΈ **Doesn't break when YouTube changes things** | πŸ”Œ **Powered by [TranscriptAPI.com](https://transcriptapi.com)** | |---|---|---|---| A production-grade, multi-mode YouTube scraper for content research, AI/LLM training datasets, RAG pipelines, brand monitoring, SEO, market analysis, and any workflow that needs YouTube data + transcripts as clean structured JSON. --- ### πŸš€ Why this YouTube scraper? - πŸŽ›οΈ **All-in-one** β€” search, channel uploads, playlists, direct video URLs, **and** transcripts in one actor. Mix any combination of inputs in a single run. - πŸ’Έ **Per-API-call pricing** β€” pay $0.005 per backend request, not per result. A single search returns up to 20 results for one charge. A channel page returns up to 100 videos for one charge. Compare that to per-item billing elsewhere. - ⚑ **Sub-500 ms typical** β€” backed by [TranscriptAPI.com](https://transcriptapi.com) with **median 49 ms** latency, plus a small Apify networking hop. - πŸ“Š **15 M+ requests / month** β€” battle-tested in real production traffic, not a side project. - πŸ›‘οΈ **Doesn't break when YouTube changes things** β€” we ship through every YouTube backend change without dropping requests. - πŸ’Έ **No actor-start fee** β€” we absorb the run cost. - πŸ†“ **Errors are free** β€” failed transcripts, bad URLs, and unreachable channels never bill. - πŸ”‘ **No YouTube API key required** β€” bring a URL or a search query, we bring the data. - πŸ“¦ **Bulk-friendly** β€” paste 1 query or 1,000 URLs. Results land in an Apify Dataset, ready for JSON, CSV, Excel, or your warehouse. - 🧹 **Clean structured output** β€” unified per-item schema across every input mode, so downstream parsing stays simple. - πŸ“ **Transcripts as a first-class feature** β€” JSON segments, plain text, **SRT**, or **WebVTT**. Toggle on/off per run. - πŸ”Œ **Plug-and-play** β€” runnable from Python, Node.js, REST API, n8n, Make, Zapier, MCP, LangChain, LlamaIndex, or any webhook. --- ### πŸ’° Pricing | Event | Price | |---|---| | `search` | **$0.005** *(per search request β€” returns up to ~20 results per call; paginates if you ask for more)* | | `videos-page` | **$0.005** *(per page when listing videos from a channel or playlist β€” returns up to ~100 videos per call)* | | `transcript-fetched` | **$0.005** *(per successfully retrieved transcript)* | | Actor start | **Free** *(we absorb it)* | | Errors / failed videos | **Free** | > **How much does a typical run cost?** A search for 100 videos = 5Γ— `search` events β‰ˆ $0.025. Pulling 300 videos from one channel = 3Γ— `videos-page` events β‰ˆ $0.015. Adding transcripts to all 300 = +$1.50. Discovery without transcripts is intentionally cheap. > Per-API-call pricing. No subscription, no monthly minimum, no hidden fees. Failed requests never bill. --- ### ⚑ Quick Start 1. Click **Try for free** at the top of this page. 2. Drop YouTube search terms into `searchQueries`, paste channel / playlist / video URLs into `startUrls`, or both. 3. Set `downloadSubtitles: true` if you also want transcripts. 4. Run. Results land in the actor's default Dataset β€” export to JSON, CSV, Excel, XML, or HTML. ```json { "searchQueries": ["ai productivity tips", "vibe coding"], "startUrls": [ "https://www.youtube.com/@TED", "https://www.youtube.com/playlist?list=PLOU2XLYxmsILqUKy5sN-2NjjkUtX_kxnu", "https://www.youtube.com/watch?v=dQw4w9WgXcQ" ], "searchType": "video", "maxResults": 50, "downloadSubtitles": true, "subtitlesFormat": "json", "includeTimestamps": true } ```` *** ### πŸ“₯ Input | Field | Type | Default | Description | |---|---|---|---| | `searchQueries` | `string[]` | `[]` | Free-text YouTube searches. Each query is fetched separately and capped by `maxResults`. | | `startUrls` | `string[]` | `[]` | Mix of video URLs, channel URLs (`/channel/UC…`, `/@handle`, `/c/…`, `/user/…`), or playlist URLs (`?list=…`). Auto-detected. | | `searchType` | `"video"` | `"channel"` | `"video"` | What `searchQueries` should return. | | `maxResults` | `integer` | `20` | Per-search-query, per-channel, per-playlist cap. | | `downloadSubtitles` | `boolean` | `false` | When `true`, fetches a transcript for every video discovered and merges it onto the same item. | | `subtitlesFormat` | `"json"` | `"text"` | `"srt"` | `"vtt"` | `"json"` | Transcript output format. | | `includeTimestamps` | `boolean` | `true` | Per-segment timestamps on `json` / `text` transcripts. | | `subtitlesLanguage` | `string` | `"en"` | Caption language preference. | | `includeVideoMetadata` | `boolean` | `true` | Include title / channel / thumbnail on transcript items. | | `saveSubsToKVS` | `boolean` | `false` | Also write each transcript to the default Key-Value Store as `transcript-`. | At least one of `searchQueries` or `startUrls` must be provided. *** ### πŸ“€ Output β€” unified per-item shape Each result is one row in the default Dataset. The `source` field tells you where it came from: `search`, `channel`, `channelLatest`, `playlist`, or `directUrl`. **Video result (from search):** ```json { "source": "search", "input": "claude code tutorial", "order": 0, "type": "video", "videoId": "ujHXnlSVheI", "title": "Claude Code Tutorial: Beginner to Advanced in 20 Minutes", "url": "https://www.youtube.com/watch?v=ujHXnlSVheI", "channelId": "UC3i3qKQ5aR_guegQj5bhOMw", "channelTitle": "Zinho Automates", "channelHandle": "@zinhoautomates", "channelUrl": "https://www.youtube.com/channel/UC3i3qKQ5aR_guegQj5bhOMw", "lengthText": "19:24", "viewCountText": "48,427 views", "publishedTimeText": "5 days ago", "hasCaptions": true, "thumbnails": [{ "url": "https://i.ytimg.com/...", "width": 1280, "height": 720 }] } ``` **Video result with transcript attached (`downloadSubtitles: true`):** ```json { "source": "channel", "input": "https://www.youtube.com/@TED", "order": 0, "type": "video", "videoId": "aDGaUWkioqk", "title": "...", "channelTitle": "TED", "channelUrl": "https://www.youtube.com/channel/UCAuUUnT6oDeKwE6v1NGQxug", "lengthText": "1:32", "transcript": [ { "text": "What does a warming planet mean for the foods you love?", "start": 0.12, "duration": 3.4 }, { "text": "...", "start": 3.6, "duration": 2.9 } ], "transcriptLanguage": "en" } ``` **Channel result (`searchType: "channel"`):** ```json { "source": "search", "input": "TED", "order": 0, "type": "channel", "channelId": "UCAuUUnT6oDeKwE6v1NGQxug", "title": "TED", "handle": "@TED", "url": "https://www.youtube.com/@TED", "description": "The TED Talks channel features the best talks and performances from the TED Conference...", "subscriberCount": "27.4M subscribers", "verified": true, "rssUrl": "https://www.youtube.com/feeds/videos.xml?channel_id=UCAuUUnT6oDeKwE6v1NGQxug", "thumbnails": [{ "url": "...", "width": 88, "height": 88 }] } ``` **Transcript failure attached to its video (free of charge):** ```json { "source": "channel", "input": "https://www.youtube.com/@SomeChannel", "order": 4, "type": "video", "videoId": "BADID000000", "title": "...", "transcript_error": { "status": 404, "detail": "No transcript available" } } ``` **Discovery-layer failures** (bad URL, unreachable channel, dead playlist) land in a separate **`errors` dataset** β€” never billed. *** ### 🎯 Use Cases - **AI / LLM training data** β€” bulk-collect transcripts from any niche. - **RAG knowledge bases** β€” index educational channels, lectures, podcasts. - **Content research & SEO** β€” extract topics, keywords, and themes from competitor channels. - **Brand monitoring** β€” pipe transcripts into sentiment / NLP analysis. - **Market & competitive analysis** β€” track entire channels or topics over time. - **Podcast & lecture transcription** β€” turn long-form video libraries into searchable text. - **Repurpose video into content** β€” blog posts, newsletters, X/LinkedIn threads, Shorts captions, summaries. - **Academic research** β€” corpus building for linguistic, media, or political analysis. - **Accessibility** β€” generate plain-text alternatives for video content. *** ### 🌐 Supported Input Formats | Mode | Examples | |---|---| | Video URL | `https://www.youtube.com/watch?v=dQw4w9WgXcQ`
`https://youtu.be/dQw4w9WgXcQ`
`https://www.youtube.com/shorts/dQw4w9WgXcQ`
`https://www.youtube.com/embed/dQw4w9WgXcQ`
`dQw4w9WgXcQ` | | Channel URL | `https://www.youtube.com/channel/UCAuUUnT6oDeKwE6v1NGQxug`
`https://www.youtube.com/@TED`
`https://www.youtube.com/c/TED`
`https://www.youtube.com/user/TEDtalksDirector` | | Playlist URL | `https://www.youtube.com/playlist?list=PL…`
Any URL containing `?list=…`
Bare playlist IDs starting with `PL`, `UU`, `LL`, `FL`, `OL`, `RD` | | Search query | Any free-text string in `searchQueries` | *** ### πŸ”Œ Integrations Run from anywhere via Apify's native integrations: - 🐍 **Python** β€” `apify-client` SDK - 🟒 **Node.js / JavaScript** β€” `apify-client` SDK - πŸ”— **REST API** β€” POST to `/v2/acts/.../runs` and read the Dataset - 🧩 **n8n** β€” official Apify nodes - βš™οΈ **Make (Integromat)** β€” official Apify modules - ⚑ **Zapier** β€” official Apify Zap actions - πŸͺ **Webhooks** β€” fire on run finish, success, or failure - πŸ€– **MCP / Claude Desktop / Cursor** β€” expose this actor as a tool to your AI agents via the Apify MCP server - 🧱 **LangChain / LlamaIndex** β€” drop the Dataset directly into a RAG pipeline *** ### ❓ FAQ **Can I mix search queries with channel and playlist URLs in one run?** Yes β€” that's the whole point. Drop any combination into `searchQueries` and `startUrls`; we auto-detect each URL and dispatch it correctly. **How does pricing work?** Three pay-per-event meters, all priced at **$0.005**: `search` (per search request β€” returns up to ~20 results per call), `videos-page` (per page when listing videos from a channel or playlist β€” up to ~100 videos per call), and `transcript-fetched` (per successful transcript). Failed requests and bad URLs are **free**. No actor-start fee, no subscription, no monthly minimum. See the [Pricing](#-pricing) section for typical run costs. **Do I need a YouTube API key?** No. Bring URLs or search terms; we handle everything. **How fast is it?** Median upstream latency 49 ms (TranscriptAPI.com), so end-to-end you typically see results in well under 500 ms per call. Long channels and playlists are paginated automatically. **Which transcript formats are supported?** JSON (timed segments), plain text, **SRT**, and **WebVTT**. Pick via `subtitlesFormat`. **What if a video has no captions?** The transcript fetch attaches a `transcript_error` field to the same item β€” the discovery data is still delivered, and the failed transcript is **not billed**. **Can I scrape only the latest N videos from a channel?** Yes. Set `maxResults` to your cap. When `maxResults ≀ 15`, we use a richer endpoint that gives exact publish dates and full descriptions. **Can I run an unattended schedule?** Yes β€” combine this actor with Apify's built-in schedules and webhooks. Many users poll new uploads daily. **Is this legal?** This actor only reads metadata and captions that YouTube makes public to any visitor. It does not bypass age gates, scrape signed-in surfaces, or collect personal user data. Use the output in compliance with copyright law, YouTube ToS for your jurisdiction, GDPR / CCPA, and any licensing your downstream product requires. **Where do results go?** Default Apify Dataset. Discovery failures go to a separate `errors` named dataset. Both export to JSON, CSV, Excel, XML, HTML, or RSS. **What if I need higher volume / parallelism?** Run the actor multiple times in parallel β€” Apify schedules and bills each run independently. Reach out via the Issues tab for specific scale needs. *** ### πŸ›‘οΈ Legal & Ethical Scraping This actor only accesses metadata and captions that YouTube makes public to any visitor of a video, channel, or playlist page. It does **not**: - bypass age restrictions, private uploads, or unlisted-link gates, - collect personally identifiable user data, - scrape comments, watch history, or any signed-in surface. You are responsible for using the output in compliance with copyright law, YouTube's Terms of Service for your jurisdiction, GDPR / CCPA, and any platform-specific licensing your downstream product requires. *** ### πŸ› Support - 🐞 **Issues / feature requests** β€” use the **Issues** tab at the top of this page. - πŸ“¬ **Response time** β€” within 1 business day. - πŸ’¬ **Need a custom contract?** Reach out via the Issues tab. # Actor input Schema ## `searchQueries` (type: `array`): Free-text YouTube searches. Each query is fetched separately and capped by 'maxResults'. Use 'searchType' to pick whether each query returns videos or channels. ## `startUrls` (type: `array`): Paste any mix of video URLs (watch, youtu.be, shorts, embed, bare 11-char ID), channel URLs (/channel/UC…, /@handle, /c/…, /user/…), or playlist URLs (?list=PL…). We auto-detect each. ## `searchType` (type: `string`): What 'searchQueries' should return. 'video' = video results. 'channel' = channel results. ## `maxResults` (type: `integer`): Per-search-query, per-channel, and per-playlist cap. 20 is a safe default; raise for bulk runs. ## `downloadSubtitles` (type: `boolean`): When true, fetches a transcript for every video discovered (search, channel, playlist, or direct URL) and merges it onto the same item. Each successful transcript is billed at the 'transcript-fetched' rate. ## `subtitlesFormat` (type: `string`): Output format for transcripts. JSON = list of timed segments. Text = single concatenated string. SRT / VTT = standard subtitle file formats. ## `includeTimestamps` (type: `boolean`): When 'subtitlesFormat' is 'json' or 'text', include per-segment timestamps. Always on for SRT and VTT. ## `subtitlesLanguage` (type: `string`): Caption language preference. Most videos return English by default; transcripts come back in the video's primary published caption language. ## `includeVideoMetadata` (type: `boolean`): When fetching transcripts, also include video title, channel, and thumbnail. ## `saveSubsToKVS` (type: `boolean`): When true, each transcript is also written to the default Key-Value Store as 'transcript-' (raw payload). Useful for piping transcripts to downstream actors or storing them separately from the dataset. ## Actor input object example ```json { "searchQueries": [ "claude code tutorial" ], "startUrls": [ "https://www.youtube.com/@TED", "https://www.youtube.com/watch?v=dQw4w9WgXcQ" ], "searchType": "video", "maxResults": 20, "downloadSubtitles": false, "subtitlesFormat": "json", "includeTimestamps": true, "subtitlesLanguage": "en", "includeVideoMetadata": true, "saveSubsToKVS": false } ``` # Actor output Schema ## `results` (type: `string`): Default dataset β€” one item per video or channel result. ## `errors` (type: `string`): Named dataset for discovery-layer failures. Empty when there were none. Never billed. # 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 = { "searchQueries": [ "claude code tutorial" ], "startUrls": [ "https://www.youtube.com/@TED", "https://www.youtube.com/watch?v=dQw4w9WgXcQ" ] }; // Run the Actor and wait for it to finish const run = await client.actor("zeropointstudio/youtube-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 = { "searchQueries": ["claude code tutorial"], "startUrls": [ "https://www.youtube.com/@TED", "https://www.youtube.com/watch?v=dQw4w9WgXcQ", ], } # Run the Actor and wait for it to finish run = client.actor("zeropointstudio/youtube-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 '{ "searchQueries": [ "claude code tutorial" ], "startUrls": [ "https://www.youtube.com/@TED", "https://www.youtube.com/watch?v=dQw4w9WgXcQ" ] }' | apify call zeropointstudio/youtube-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=zeropointstudio/youtube-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "YouTube Scraper", "description": "All-in-one YouTube scraper: search, channels, playlists, video URLs, and transcripts in a single run. Powered by TranscriptAPI.", "version": "0.1", "x-build-id": "waC3GTSrx6gJimqzV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zeropointstudio~youtube-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zeropointstudio-youtube-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/zeropointstudio~youtube-scraper/runs": { "post": { "operationId": "runs-sync-zeropointstudio-youtube-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/zeropointstudio~youtube-scraper/run-sync": { "post": { "operationId": "run-sync-zeropointstudio-youtube-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", "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Free-text YouTube searches. Each query is fetched separately and capped by 'maxResults'. Use 'searchType' to pick whether each query returns videos or channels.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Paste any mix of video URLs (watch, youtu.be, shorts, embed, bare 11-char ID), channel URLs (/channel/UC…, /@handle, /c/…, /user/…), or playlist URLs (?list=PL…). We auto-detect each.", "default": [], "items": { "type": "string" } }, "searchType": { "title": "Search type", "enum": [ "video", "channel" ], "type": "string", "description": "What 'searchQueries' should return. 'video' = video results. 'channel' = channel results.", "default": "video" }, "maxResults": { "title": "Max results (per source)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Per-search-query, per-channel, and per-playlist cap. 20 is a safe default; raise for bulk runs.", "default": 20 }, "downloadSubtitles": { "title": "Download transcripts", "type": "boolean", "description": "When true, fetches a transcript for every video discovered (search, channel, playlist, or direct URL) and merges it onto the same item. Each successful transcript is billed at the 'transcript-fetched' rate.", "default": false }, "subtitlesFormat": { "title": "Transcript format", "enum": [ "json", "text", "srt", "vtt" ], "type": "string", "description": "Output format for transcripts. JSON = list of timed segments. Text = single concatenated string. SRT / VTT = standard subtitle file formats.", "default": "json" }, "includeTimestamps": { "title": "Include timestamps", "type": "boolean", "description": "When 'subtitlesFormat' is 'json' or 'text', include per-segment timestamps. Always on for SRT and VTT.", "default": true }, "subtitlesLanguage": { "title": "Transcript language", "type": "string", "description": "Caption language preference. Most videos return English by default; transcripts come back in the video's primary published caption language.", "default": "en" }, "includeVideoMetadata": { "title": "Include video metadata on transcript items", "type": "boolean", "description": "When fetching transcripts, also include video title, channel, and thumbnail.", "default": true }, "saveSubsToKVS": { "title": "Save transcripts to Key-Value Store", "type": "boolean", "description": "When true, each transcript is also written to the default Key-Value Store as 'transcript-' (raw payload). Useful for piping transcripts to downstream actors or storing them separately from the dataset.", "default": false } } }, "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 } } } } } } } } } } ```