{ "openapi": "3.0.1", "info": { "title": "YouTube Community Posts Scraper", "description": "Collect public YouTube Community posts from channel handles, URLs, or IDs without customer-supplied YouTube credentials or API keys. Look up post details and comments by ID or URL, then get post text, links, channel context, dates, types, media, and engagement in structured dataset rows.", "version": "0.0", "x-build-id": "muJpU6cCSJxPptSJg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~youtube-community-posts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-youtube-community-posts", "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/maximedupre~youtube-community-posts/runs": { "post": { "operationId": "runs-sync-maximedupre-youtube-community-posts", "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/maximedupre~youtube-community-posts/run-sync": { "post": { "operationId": "run-sync-maximedupre-youtube-community-posts", "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": [ "resultType" ], "properties": { "resultType": { "title": "Result type", "enum": [ "communityPosts", "postDetails", "comments" ], "type": "string", "description": "Choose the kind of result to return." }, "channels": { "title": "Channel handles, URLs, or IDs", "minItems": 1, "type": "array", "description": "Enter one or more YouTube channel handles, channel URLs, or channel IDs. This field is used for Community posts and is ignored for Post details and Comments.", "items": { "type": "string" } }, "postTypes": { "title": "Post types", "type": "array", "description": "Optional. Return only Community posts with the selected types. Leave this empty to return all available types.", "items": { "type": "string", "enum": [ "text", "image", "video", "poll" ], "enumTitles": [ "Text", "Image", "Video", "Poll" ] } }, "keyword": { "title": "Text keyword", "type": "string", "description": "Optional. Return Community posts whose text contains this keyword." }, "dateFrom": { "title": "Published from", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional. Include Community posts from this approximate publication date onward. Use a calendar date in YYYY-MM-DD form." }, "dateTo": { "title": "Published until", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional. Include Community posts through this approximate publication date. Use a calendar date in YYYY-MM-DD form." }, "maxPosts": { "title": "Maximum posts per channel", "minimum": 1, "type": "integer", "description": "Optional stop for Community posts from each channel. Leave it empty to collect all available posts until the current public feed is exhausted." }, "maxComments": { "title": "Maximum comments per post", "minimum": 1, "type": "integer", "description": "Optional stop for Comments from each post. Leave it empty to collect all available comments until the current public thread is exhausted." }, "postReferences": { "title": "Post IDs or URLs", "minItems": 1, "type": "array", "description": "Enter one or more YouTube Community post IDs or full post URLs. This field is used for Post details and Comments and is ignored for Community posts.", "items": { "type": "string" } }, "countryCode": { "title": "Country context", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Optional two-letter country code for localized source labels, such as US." }, "languageCode": { "title": "Language context", "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z]{2,4})?$", "type": "string", "description": "Optional language code for localized source labels, such as en or en-US." }, "includeLanguage": { "title": "Add detected language", "type": "boolean", "description": "When enabled, add the detected language when detection succeeds for Community posts and Post details. This option may add usage charges.", "default": false }, "storeImages": { "title": "Store post images", "type": "boolean", "description": "When enabled, store retrieved post images and return access references when storage succeeds for Community posts and Post details. This option may add usage charges.", "default": false } } }, "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 } } } } } } } } } }