{ "openapi": "3.0.1", "info": { "title": "YouTube Sponsorship Finder - Brand Deals & Codes", "description": "Find which brands sponsor which YouTube creators. Reads each video's description and spoken captions and returns the sponsor, the tracked campaign link, the discount code and the timestamp of the read. Point it at a channel to see who pays them, or at a brand to map its whole creator roster.", "version": "0.1", "x-build-id": "OcKRBCxyoBSo7oAyX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gganbukim~youtube-sponsorship-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gganbukim-youtube-sponsorship-finder", "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/gganbukim~youtube-sponsorship-finder/runs": { "post": { "operationId": "runs-sync-gganbukim-youtube-sponsorship-finder", "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/gganbukim~youtube-sponsorship-finder/run-sync": { "post": { "operationId": "run-sync-gganbukim-youtube-sponsorship-finder", "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": [ "videoUrls" ], "properties": { "videoUrls": { "title": "Channels, videos or playlists", "type": "array", "description": "@handles, channel URLs, playlist URLs, or individual watch URLs. A channel is expanded into its videos automatically — that is the usual way to run this.", "items": { "type": "string" } }, "maxVideos": { "title": "Max videos", "minimum": 1, "type": "integer", "description": "Cap on videos scanned, counting those pulled out of channels and playlists. Each video costs two cheap requests and only yields a row if a deal is found.", "default": 100 }, "brandContains": { "title": "Only these brands", "type": "array", "description": "Case-insensitive fragments matched against the sponsor's domain — \"brilliant\", \"ground.news\". Leave empty for every brand. This is how you map one brand's whole creator roster. Filtered rows are not billed.", "items": { "type": "string" } }, "trackedLinksOnly": { "title": "Tracked campaign links only", "type": "boolean", "description": "Keep only deals where the sponsor gave the creator a URL with their own name in it (brilliant.org/veritasium). That path is the campaign id, and its presence is the strongest proof a deal exists.", "default": false }, "readAloudOnly": { "title": "Read aloud only", "type": "boolean", "description": "Keep only deals that were also spoken in the video, so every row carries a timestamp. Drops description-only affiliate placements.", "default": false }, "languages": { "title": "Caption languages", "type": "array", "description": "Priority order for the caption track used to find spoken reads. The description is read regardless of language.", "default": [ "en" ], "items": { "type": "string" } }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Videos processed in parallel.", "default": 8 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave the default. The actor starts on cheap datacenter proxies and escalates to residential only if YouTube actually throttles it.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }