{ "openapi": "3.0.1", "info": { "title": "YouTube Subtitle Search Crawler 🔍", "description": "A powerful YouTube subtitle search crawler that helps you discover videos by searching through their subtitles. Filter results by views, likes, duration, and more to find exactly what you're looking for.", "version": "0.0", "x-build-id": "KvuW0gPz94hBSHbQF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/easyapi~youtube-subtitle-search-crawler/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-easyapi-youtube-subtitle-search-crawler", "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/easyapi~youtube-subtitle-search-crawler/runs": { "post": { "operationId": "runs-sync-easyapi-youtube-subtitle-search-crawler", "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/easyapi~youtube-subtitle-search-crawler/run-sync": { "post": { "operationId": "run-sync-easyapi-youtube-subtitle-search-crawler", "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": [ "queryTerm" ], "properties": { "queryTerm": { "title": "Search Term", "type": "string", "description": "Text to search in video subtitles", "default": "openai chatgpt" }, "maxItems": { "title": "Maximum Results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of results to collect", "default": 100 }, "videoTitle": { "title": "Video Title Filter", "type": "string", "description": "Filter by video title" }, "subtitleType": { "title": "Subtitle Type", "enum": [ "manual", "auto" ], "type": "string", "description": "Type of subtitles to search", "default": "manual" }, "language": { "title": "Subtitle Language", "enum": [ "en", "fr", "it", "id", "pt", "ko", "ru", "es", "vi", "fil", "nl", "de", "th", "ro" ], "type": "string", "description": "Filter by subtitle language", "default": "en" }, "country": { "title": "Video Country", "enum": [ "217", "1", "153", "22", "148", "19", "218", "95", "201", "227", "14", "84", "247" ], "type": "string", "description": "Filter by video country", "default": "217" }, "category": { "title": "Video Category", "enum": [ "3", "33", "8", "35", "46", "18", "9", "6", "2", "19", "30", "14", "12", "7", "0", "39", "32" ], "type": "string", "description": "Filter by video category", "default": "3" }, "viewsRange": { "title": "Views Range", "type": "array", "description": "Min and max view count", "default": [ 0, 100000000 ] }, "likesRange": { "title": "Likes Range", "type": "array", "description": "Min and max like count", "default": [ 0, 1000000 ] }, "durationRange": { "title": "Duration Range", "type": "array", "description": "Min and max duration in seconds", "default": [ 0, 36000 ] }, "dateRange": { "title": "Date Range", "type": "array", "description": "Upload date range [start_date, end_date]", "default": [ "2020-01-01", "2024-12-31" ] } } }, "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 } } } } } } } } } }