{ "openapi": "3.0.1", "info": { "title": "YouTube Shopping Scraper - Merch Shelf, Store & Tagged Products", "description": "Extract the products creators promote on YouTube: channel stores, merch shelves under videos, timestamped product tags and Shorts. Get real titles, prices, merchants, product links, ASINs and affiliate networks with the creator and video for every card.", "version": "0.1", "x-build-id": "qfm8aCjx85zFz7Hr4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s-r~youtube-shopping-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s-r-youtube-shopping-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/s-r~youtube-shopping-scraper/runs": { "post": { "operationId": "runs-sync-s-r-youtube-shopping-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/s-r~youtube-shopping-scraper/run-sync": { "post": { "operationId": "run-sync-s-r-youtube-shopping-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": [ "queries" ], "properties": { "queries": { "title": "YouTube inputs", "type": "array", "description": "YouTube channel handles or URLs, channel IDs, video URLs or IDs, Shorts URLs, or search phrases. Each entry is processed separately. Bare 11-letter words in lowercase or with a single initial capital are searched; use a video URL for an ambiguous ID.", "items": { "type": "string" } }, "max_products_per_input": { "title": "Max products per input", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum product occurrences per input, across all requested surfaces.", "default": 100 }, "max_videos_per_channel": { "title": "Max videos per channel", "minimum": 0, "maximum": 200, "type": "integer", "description": "Maximum recent videos per channel tab (Videos and, when enabled, Shorts). Set 0 to collect only Store cards.", "default": 30 }, "max_videos_per_search": { "title": "Max videos per search", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum videos with a shopping badge to open for each search phrase.", "default": 20 }, "include_store_tab": { "title": "Include store tab", "type": "boolean", "description": "Collect channel Store cards, including merchant collaborations.", "default": true }, "include_product_shelf": { "title": "Include product shelf", "type": "boolean", "description": "Collect merchandise cards displayed below videos.", "default": true }, "include_tagged_products": { "title": "Include tagged products", "type": "boolean", "description": "Collect product tags and list panels, including all available start/end time windows.", "default": true }, "include_shorts": { "title": "Include shorts", "type": "boolean", "description": "Collect Shorts products and visit the Shorts tab of channels.", "default": true }, "include_description_links": { "title": "Include description links", "type": "boolean", "description": "Include external description links as low-confidence link_only rows. Such links may be sponsors or websites rather than product pages; no title or price is inferred.", "default": false }, "geo": { "title": "Geo", "type": "string", "description": "Two-letter country code controlling the product market. US has the best displayed price coverage.", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "Language code echoed in the output. YouTube is requested in English for consistent source text and date/price parsing.", "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 } } } } } } } } } }