{ "openapi": "3.0.1", "info": { "title": "YouTube Search Scraper — Results, Ranks & Filters (No API Key)", "description": "Scrape YouTube search results for any keyword or search URL: videos, Shorts, channels and playlists with rank, views, publish date, duration, channel and snippet. Same filters as YouTube (type, upload date, duration, sort, features), any region. No API key, no login. From US$0.45 per 1,000 results.", "version": "0.1", "x-build-id": "Nlvp3vJOltzskALb8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fabrikit~youtube-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fabrikit-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/fabrikit~youtube-search-scraper/runs": { "post": { "operationId": "runs-sync-fabrikit-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/fabrikit~youtube-search-scraper/run-sync": { "post": { "operationId": "run-sync-fabrikit-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": { "searchQueries": { "title": "Search keywords", "type": "array", "description": "One search per entry, exactly as you would type it on YouTube, e.g. \"espresso machine review\", \"recetas veganas\", \"#booktok\". Quotes, minus signs and other YouTube search operators work too.", "items": { "type": "string" } }, "searchUrls": { "title": "YouTube search URLs", "type": "array", "description": "Search-results pages copied from your browser, like https://www.youtube.com/results?search_query=nasa+artemis&sp=CAISBAgCEAE%253D. Filters chosen on youtube.com (the sp part) are kept; a URL without filters uses the filters below.", "items": { "type": "string" } }, "resultType": { "title": "Result type", "enum": [ "all", "video", "short", "channel", "playlist", "live" ], "type": "string", "description": "Everything YouTube lists (videos, Shorts, channels, playlists) or just one type. \"Live\" means live streams only.", "default": "all" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date", "views", "rating" ], "type": "string", "description": "Order of the results: relevance (YouTube's default), upload date (newest first), view count or rating.", "default": "relevance" }, "uploadDate": { "title": "Upload date", "enum": [ "any", "hour", "today", "week", "month", "year" ], "type": "string", "description": "Only results uploaded in this period.", "default": "any" }, "duration": { "title": "Duration", "enum": [ "any", "short", "medium", "long" ], "type": "string", "description": "Video length: under 4 minutes, 4 to 20 minutes, or over 20 minutes.", "default": "any" }, "features": { "title": "Features", "type": "array", "description": "Extra YouTube filters; a result must match all of them. Live = live streams, HD/4K/HDR = picture quality, subtitles = closed captions, creativeCommons = CC-licensed videos, 360 / VR180 / 3D = immersive formats.", "items": { "type": "string", "enum": [ "live", "hd", "4k", "hdr", "subtitles", "creativeCommons", "360", "vr180", "3d" ], "enumTitles": [ "Live", "HD", "4K", "HDR", "Subtitles / CC", "Creative Commons", "360°", "VR180", "3D" ] }, "default": [] }, "maxResultsPerQuery": { "title": "Max results per search", "minimum": 1, "maximum": 100000, "type": "integer", "description": "How many rows to keep for each keyword or URL (YouTube serves about 20 videos per page, plus Shorts shelves, and usually stops after a few hundred results).", "default": 100 }, "maxItems": { "title": "Max results (total)", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many rows across all searches. You pay only for the rows that are saved.", "default": 100 }, "region": { "title": "Region", "type": "string", "description": "Two-letter country code YouTube uses to rank and localise the results (US, GB, DE, MX, BR, IN...). It also sets the country of the residential fallback proxy.", "default": "US" }, "language": { "title": "Interface language", "type": "string", "description": "YouTube interface language sent with the requests (en, es, pt, de...). Keep \"en\" unless you need shelf titles in another language: view counts and relative dates are parsed from English text.", "default": "en" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy is enough in normal runs. If YouTube blocks it twice in a row (HTTP 403/429 or a consent page), the Actor switches to RESIDENTIAL proxy by itself for the rest of the run.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }