{ "openapi": "3.0.1", "info": { "title": "Google Short Videos Scraper – Shorts, Reels & TikTok Results", "description": "Scrape Google’s Short videos tab as data: every short video Google lists for a search across YouTube Shorts, TikTok, Instagram Reels, Facebook, X, LinkedIn and Reddit — link, title, creator, duration, thumbnail, description and date. Filter by platform and time. No API key, no browser. Unofficial.", "version": "0.1", "x-build-id": "XjNJlAMgNE169Tdab" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simple.actor~google-short-videos/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simple.actor-google-short-videos", "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/simple.actor~google-short-videos/runs": { "post": { "operationId": "runs-sync-simple.actor-google-short-videos", "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/simple.actor~google-short-videos/run-sync": { "post": { "operationId": "run-sync-simple.actor-google-short-videos", "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": { "queries": { "title": "Search terms (one per line)", "type": "array", "description": "What to search for, one search per line. Google's operators work: \"exact phrase\" in quotes, a minus sign to exclude a word. You can also paste a link copied from Google's Short videos tab — its search terms and filters are used as they are, and the filters below apply only to links that carry none.", "items": { "type": "string" } }, "maxItems": { "title": "Videos per search", "minimum": 1, "maximum": 400, "type": "integer", "description": "How many videos to return per search. Google lists twelve per request, so the default of 12 is one request and 120 is about ten. Google's Short videos tab runs out somewhere around 350–450 videos for most searches, and reading stops there on its own — asking for more returns everything Google has.", "default": 12 }, "platform": { "title": "Platform", "enum": [ "any", "youtube", "tiktok", "instagram", "facebook", "x", "linkedin", "reddit" ], "type": "string", "description": "Only videos from one platform, as Google's Tools menu offers under Source. Leave on \"All platforms\" for the mix Google shows. One platform at a time — Google ignores the filter when asked for two.", "default": "any" }, "timeRange": { "title": "Time", "enum": [ "any", "hour", "day", "week", "month", "year" ], "type": "string", "description": "Only videos Google found within this period — the way to get what is new on a topic.", "default": "any" }, "highQuality": { "title": "High quality only", "type": "boolean", "description": "Google's \"High quality\" filter from the Tools menu. In testing it narrowed results to YouTube.", "default": false }, "closedCaptions": { "title": "Closed captioned only", "type": "boolean", "description": "Google's \"Closed captioned\" filter from the Tools menu — videos Google knows to carry captions.", "default": false }, "safeSearch": { "title": "SafeSearch", "type": "boolean", "description": "Turn on to have Google filter explicit videos out, as its SafeSearch setting does.", "default": false }, "country": { "title": "Country (two-letter code)", "type": "string", "description": "The country Google searches from, as a two-letter code: US, GB, DE, IN… Videos from local creators rank higher. Defaults to US.", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "The language of Google's interface and of the videos it prefers: en, de, fr, es, pt-BR, ja… Defaults to en. Set it together with the country for a local search. Dates come back as Google writes them in this language, and are parsed into publishedAt for English and numeric forms.", "default": "en" } } }, "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 } } } } } } } } } }