{ "openapi": "3.0.1", "info": { "title": "YouTube Video Search Scraper", "description": "Search YouTube by keyword and export the results: title, channel, exact views, length, upload age, snippet and link, in YouTube's own ranking order. From $0.22 per 1,000 videos. Filter by upload date, length or 4K - YouTube applies them before it answers, so a filtered video is never charged.", "version": "0.0", "x-build-id": "mynKGRWIfM24Hkr6e" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lightmoon~youtube-video-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lightmoon-youtube-video-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/lightmoon~youtube-video-search-scraper/runs": { "post": { "operationId": "runs-sync-lightmoon-youtube-video-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/lightmoon~youtube-video-search-scraper/run-sync": { "post": { "operationId": "run-sync-lightmoon-youtube-video-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", "required": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search phrases", "type": "array", "description": "One per line, exactly as you would type them into YouTube's search box. Each phrase is searched separately and every row says which phrase it came from and where it ranked.", "items": { "type": "string" } }, "maxResults": { "title": "Maximum videos in total", "minimum": 1, "maximum": 5000, "type": "integer", "description": "A ceiling for the whole run, across every phrase. Videos dropped by a filter are never charged.", "default": 200 }, "maxResultsPerQuery": { "title": "Maximum per phrase", "minimum": 1, "maximum": 5000, "type": "integer", "description": "So one broad phrase cannot eat the whole run. YouTube serves about twenty videos per page.", "default": 100 }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date", "views", "rating" ], "type": "string", "description": "YouTube's own sort, applied by YouTube before it answers - not a re-sort of the page we got.", "default": "relevance" }, "uploadedWithin": { "title": "Uploaded within", "enum": [ "any", "hour", "today", "week", "month", "year" ], "type": "string", "description": "Narrows the answer at YouTube's end. Measured: the phrase python tutorial goes from 2.4 million results to 2 480 with Today.", "default": "any" }, "duration": { "title": "Video length", "enum": [ "any", "short", "medium", "long" ], "type": "string", "description": "Under 4 minutes, 4 to 20, or over 20 - YouTube's own three windows. The run re-reads the answer and reports whether the filter actually bit.", "default": "any" }, "features": { "title": "Must have", "type": "array", "description": "Extra conditions YouTube itself can filter on.", "items": { "type": "string", "enum": [ "hd", "4k", "subtitles", "creativeCommons", "live", "360", "hdr" ], "enumTitles": [ "HD", "4K", "Subtitles/CC", "Creative Commons", "Live now", "360°", "HDR" ] }, "default": [] }, "minViews": { "title": "Minimum views", "minimum": 0, "type": "integer", "description": "Drop videos under this many views before the row is stored, so a quiet video is never charged. A video whose count YouTube only rounds is kept.", "default": 0 }, "skipLiveStreams": { "title": "Skip live streams", "type": "boolean", "description": "YouTube mixes live streams into an ordinary answer. They have no length and no final view count.", "default": false }, "language": { "title": "Language", "type": "string", "description": "Two-letter code sent to YouTube as `hl`, e.g. en, de, es.", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Two-letter code sent as `gl`. YouTube ranks its answer differently per country, so this changes the result.", "default": "US" } } }, "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 } } } } } } } } } }