{ "openapi": "3.0.1", "info": { "title": "YouTube Search Scraper - Keyword to Videos & Shorts", "description": "Search YouTube by keyword and get videos and Shorts as rows: title, channel, URL, views, publish date, duration, search term. Sort by relevance or views, or filter by upload date. No login. $1 per 1,000 results; no results and blocked searches are free.", "version": "0.1", "x-build-id": "559KOo10xXnx76egd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tidytools~youtube-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tidytools-youtube-search-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/tidytools~youtube-search-scraper/runs": { "post": { "operationId": "runs-sync-tidytools-youtube-search-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/tidytools~youtube-search-scraper/run-sync": { "post": { "operationId": "run-sync-tidytools-youtube-search-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": { "keywords": { "title": "Search keywords", "type": "array", "description": "What you would type in YouTube's search box: one search per line, in any language (n8n tutorial, 教學 n8n). A pasted youtube.com/results link also works. Each result video or Short is one row. Up to 200 characters per search.", "items": { "type": "string" } }, "maxResultsPerKeyword": { "title": "Results per keyword", "minimum": 1, "maximum": 500, "type": "integer", "description": "Stop each keyword after this many rows (at most 500). The whole run also stops at \"Max videos per run\".", "default": 20 }, "searchSort": { "title": "Sort by", "enum": [ "relevance", "views" ], "type": "string", "description": "The order YouTube returns the results in. Not used with an upload date below: YouTube does not combine them.", "default": "relevance" }, "searchUploadDate": { "title": "Upload date", "enum": [ "any", "hour", "today", "week", "month", "year" ], "type": "string", "description": "Only results uploaded in about this period (ages on YouTube are rounded); much older videos YouTube lists anyway are skipped and free. YouTube no longer offers a newest-first order, so this is how to get recent videos.", "default": "any" }, "searchType": { "title": "Results to return", "enum": [ "all", "videos", "shorts" ], "type": "string", "description": "Which results to return. Channels, playlists and ads in the results are never returned.", "default": "all" }, "videoDetails": { "title": "Full video details", "type": "boolean", "description": "Off: each row comes from the results page ($1 per 1,000). On: each video's page is read too, adding exact views, likes, exact publish date and time, category, tags, hashtags, chapters, full description, caption languages and live status ($2 per 1,000, charged instead).", "default": false }, "publishedAfter": { "title": "Only videos published after (optional)", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}.*$|^\\d+\\s*(day|week|month|year)s?$", "type": "string", "description": "A date (2026-09-01) or a period (7 days, 2 weeks, 3 months). The results page shows only an age such as \"2 weeks ago\", so the cut-off is approximate unless full details are on. Older videos are skipped and free." }, "onlyNewVideos": { "title": "Only videos not returned before (monitoring)", "type": "boolean", "description": "For scheduled runs: return (and charge) only results that earlier runs with the same monitor name did not return. Best with Upload date: This week.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Separate monitors keep separate memories (letters, digits and dashes). Only used with monitoring on.", "default": "default" }, "maxResults": { "title": "Max videos per run", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The run stops after this many rows, whatever the number of keywords. A cost cap on top of Apify's maximum charge per run.", "default": 1000 }, "httpVia": { "title": "Plain HTTP requests from", "enum": [ "auto", "direct", "backend" ], "type": "string", "description": "Every request uses our own user agent, with no cookies, login or browser. If YouTube refuses one network (consent page, bot check, HTTP 429), Auto retries the first result page from our servers. Further result pages come from Apify's network only.", "default": "auto" }, "proxyConfiguration": { "title": "Proxy (optional)", "type": "object", "description": "Only used for requests sent from Apify's network. Apify proxy usage is billed to your Apify account." }, "maxConcurrency": { "title": "Pages in parallel", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many YouTube pages are read at the same time.", "default": 5 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }