{ "openapi": "3.0.1", "info": { "title": "YouTube Community Posts & Comments Scraper", "description": "Extract community posts from any channel using the Apify YouTube Community Posts Scraper. Collect text, images, polls, timestamps, and engagement metrics. Ideal for audience research, sentiment analysis, and trend tracking. Fast, accurate, and simple to automate at scale.", "version": "0.1", "x-build-id": "FOgfwl5ImC1ZLFyJ4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~youtube-community-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-youtube-community-posts-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/api-empire~youtube-community-posts-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-youtube-community-posts-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/api-empire~youtube-community-posts-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-youtube-community-posts-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": [ "channelUrls" ], "properties": { "channelUrls": { "title": "🔗 Channel URLs", "type": "array", "description": "One or more YouTube channel URLs. Both formats work: youtube.com/@Handle or youtube.com/channel/UC…. One per line (a comma-separated string is also accepted). The channel's Community/Posts tab is read for each URL.", "items": { "type": "string" } }, "maxPosts": { "title": "📊 Max posts per channel", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of community posts to collect per channel (1–10,000). Comments (if enabled) are fetched in addition to this and do NOT count against it — only parent posts are counted.", "default": 10 }, "includeComments": { "title": "💬 Fetch comments on each post", "type": "boolean", "description": "Turn on to fetch comments for every scraped community post. Each comment becomes a child row linked to its post via parentId.", "default": false }, "maxCommentsPerPost": { "title": "🔢 Max comments per post", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many comments to fetch per post when comment fetching is on (1–200). Applied per post; the top-level post count is unaffected.", "default": 10 }, "sortCommentsBy": { "title": "↕️ Comment sort order", "enum": [ "mostRecent", "mostPopular" ], "type": "string", "description": "Order in which comments are fetched: newest first, or the most-liked/top comments first.", "default": "mostRecent" }, "detectPostLanguage": { "title": "🌐 Detect post language", "type": "boolean", "description": "Run offline language detection on each post's (and comment's) text and add a detectedLanguage ISO code (e.g. en, es, fr). Empty or emoji-only text yields null.", "default": false }, "proxy": { "title": "🛡️ Proxy", "type": "object", "description": "Optional. Runs directly by default. Enable Apify Proxy or set a custom URL for higher volume. On a block the actor auto-escalates custom → datacenter → residential → direct." } } }, "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 } } } } } } } } } }