{ "openapi": "3.0.1", "info": { "title": "YouTube Video Scraper by Hashtag (Creator Discovery)", "description": "Discover YouTube content by hashtags with the YouTube Video Scraper by Hashtag. Extract video URLs, titles, descriptions, views, likes, and upload dates. Perfect for trend tracking, content research, and hashtag analysis. Fast, accurate, and scalable for bulk scraping.", "version": "0.1", "x-build-id": "TfTi9lid3d3GhQkUd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~youtube-video-scraper-by-hashtag/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-youtube-video-scraper-by-hashtag", "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/scrapier~youtube-video-scraper-by-hashtag/runs": { "post": { "operationId": "runs-sync-scrapier-youtube-video-scraper-by-hashtag", "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/scrapier~youtube-video-scraper-by-hashtag/run-sync": { "post": { "operationId": "run-sync-scrapier-youtube-video-scraper-by-hashtag", "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": { "creatorSearchTerms": { "title": "🔎 Search terms (hashtag, keyword or @handle)", "type": "array", "description": "One or more search terms, e.g. #chatgpt, chatgpt, @mkbhd. Every returned video is resolved back to the channel that published it.", "items": { "type": "string" } }, "hashtags": { "title": "🧩 Legacy 'hashtags' field (backward compatible)", "type": "array", "description": "Compatibility input for anyone already calling the original hashtag scraper. When this field is filled it takes priority over the search-terms field above. Leave it empty otherwise.", "items": { "type": "string" } }, "maxResults": { "title": "🎞️ Videos to scan per search term", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many videos to pull for each search term before creator filtering. YouTube exhausts a single term at roughly 300 videos (measured 301 on #chatgpt), so values above that return everything available and stop.", "default": 10 }, "scrapeShortsOnly": { "title": "📱 Shorts only", "type": "boolean", "description": "Restrict the search to YouTube Shorts. Shorts rows are published by YouTube without an owner, so creator fields are empty for them.", "default": false }, "oneVideoPerChannel": { "title": "👤 One video per creator (creator shortlist mode)", "type": "boolean", "description": "Keep only the highest-viewed video of each channel, deduplicated across every search term in the run. Turns N clips into N creators.", "default": false }, "verifiedChannelsOnly": { "title": "✅ Verified creators only", "type": "boolean", "description": "Keep only videos whose channel carries YouTube's verified badge. Measured on roughly half of search rows, so expect this to cut a result set substantially.", "default": false }, "maxCreators": { "title": "🔢 Stop after this many creators", "minimum": 1, "type": "integer", "description": "Optional cap on distinct channels. Creators are ranked by how many videos they placed in the run, then by total views. Leave empty for no cap." }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Optional Apify proxy. When enabled, the proxy is attached to every YouTube request the run makes." } } }, "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 } } } } } } } } } }