{ "openapi": "3.0.1", "info": { "title": "YouTube Creator Finder | Public Contacts & Metrics", "description": "Research YouTube creators using public channel information, available engagement metrics and sponsorship signals. Export profiles and publicly listed contact details. Contact discovery does not verify email deliverability or sponsorship availability.", "version": "1.0", "x-build-id": "2KC69IjrFKbzBxlTZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/egeusta~youtube-creator-sponsor-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-egeusta-youtube-creator-sponsor-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/egeusta~youtube-creator-sponsor-finder/runs": { "post": { "operationId": "runs-sync-egeusta-youtube-creator-sponsor-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/egeusta~youtube-creator-sponsor-finder/run-sync": { "post": { "operationId": "run-sync-egeusta-youtube-creator-sponsor-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", "properties": { "queries": { "title": "Niche queries", "type": "array", "description": "Niche keywords to search for creators, e.g. \"home espresso\", \"budget travel\".", "default": [ "home espresso", "budget travel", "mechanical keyboards" ], "items": { "type": "string" } }, "channels": { "title": "Seed channels", "type": "array", "description": "Optional direct channel references: UC… channel IDs, @handles, or youtube.com channel URLs.", "default": [], "items": { "type": "string" } }, "regionCode": { "title": "Region code", "type": "string", "description": "Two-letter ISO country code used to bias the search (API mode).", "default": "US" }, "relevanceLanguage": { "title": "Relevance language", "type": "string", "description": "Optional BCP-47 language code (e.g. \"en\") to bias the search." }, "minSubscribers": { "title": "Minimum subscribers", "minimum": 0, "type": "integer", "description": "Creators with a known subscriber count below this are filtered out.", "default": 1000 }, "maxSubscribers": { "title": "Maximum subscribers", "minimum": 1, "type": "integer", "description": "Creators with a known subscriber count above this are filtered out.", "default": 5000000 }, "maxResultsPerQuery": { "title": "Max results per query", "minimum": 1, "maximum": 200, "type": "integer", "description": "Upper bound on channels collected per query.", "default": 25 }, "maxTotalResults": { "title": "Max total results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Global cap on unique creators emitted.", "default": 100 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Per-request timeout.", "default": 30 }, "maxApiPages": { "title": "Max API pages per query", "minimum": 1, "maximum": 25, "type": "integer", "description": "Pagination / quota guard for the search step.", "default": 4 }, "concurrency": { "title": "Detail fetch concurrency", "minimum": 1, "maximum": 12, "type": "integer", "description": "Parallel channel-detail requests.", "default": 4 }, "includeContactInfo": { "title": "Include public contact info", "type": "boolean", "description": "Extract literally present emails, social profiles and links from the channel description / About links. No email guessing.", "default": true }, "minVideosForFrequency": { "title": "Min videos for upload frequency", "minimum": 2, "maximum": 50, "type": "integer", "description": "Minimum analysed recent videos before an upload-frequency estimate is produced.", "default": 5 }, "maxResponseBytes": { "title": "Max response bytes", "minimum": 100000, "maximum": 40000000, "type": "integer", "description": "Hard ceiling on bytes read from a single response.", "default": 5000000 } } }, "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 } } } } } } } } } }