{ "openapi": "3.0.1", "info": { "title": "Odysee Channel Lookup: Followers, Claims, Recent Videos", "description": "Lookup Odysee channels: follower count, total claims, support stake, contact email, tags, and recent video uploads. Supports monitoring for new uploads.", "version": "1.0", "x-build-id": "qQUlyfz0Wp28TdTvu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/accountable_eel~odysee-channel-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-accountable_eel-odysee-channel-lookup", "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/accountable_eel~odysee-channel-lookup/runs": { "post": { "operationId": "runs-sync-accountable_eel-odysee-channel-lookup", "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/accountable_eel~odysee-channel-lookup/run-sync": { "post": { "operationId": "run-sync-accountable_eel-odysee-channel-lookup", "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": { "channels": { "title": "Odysee channels to look up", "type": "array", "description": "Enter channel handles or URLs (one per line). Accepts @channel, https://odysee.com/@channel, or lbry://@channel. Accepted formats: @Odysee, https://odysee.com/@Odysee, lbry://@Odysee. You're only charged for the ones we actually find — a miss costs nothing.", "items": { "type": "string" } }, "testRun": { "title": "Try it first — only process the first 5", "type": "boolean", "description": "Turn this on to test your input on a small sample before running the full list. Turn it off to process everything.", "default": false }, "onlyFound": { "title": "Hide rows with no result", "type": "boolean", "description": "Only keep rows where something was actually found. Misses are always free, whether or not you show them here.", "default": false }, "includeKeywords": { "title": "Only keep rows containing", "type": "array", "description": "Optional. Only keep results that mention at least one of these words (e.g. a job title, a city, a product name). Leave empty to keep everything.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Skip rows containing", "type": "array", "description": "Optional. Drop any result that mentions one of these words. Leave empty to skip nothing.", "items": { "type": "string" } }, "maxResults": { "title": "Stop after this many results", "minimum": 1, "type": "integer", "description": "Optional. Stop the run once this many results have been found — useful for a quick, cheap sample. Leave blank for no limit." }, "onlyNewSinceLastRun": { "title": "Only return videos that are new since the last run (monitoring)", "type": "boolean", "description": "Turns this actor into an upload monitor. A video counts as new when its Odysee claim ID has not been returned for that channel by a previous run of the same watchlist. Already-seen uploads are dropped from the list, so your Slack or n8n step only ever sees fresh videos. Its stats row always comes back (with an empty upload list when nothing was posted), and a run with nothing new for a channel is not charged. The first run has nothing to compare against, so it returns every recent upload and remembers it. Only the uploads inside 'How many recent uploads to include' are compared, so keep that at 10 or more for channels that post several times a day.", "default": false }, "deltaName": { "title": "Watchlist name (optional)", "type": "string", "description": "Leave empty and we derive one from your channel list, so two schedules watching different channels keep separate memories. Editing the list then starts a fresh watchlist that re-announces each channel's recent uploads once; type your own name to keep one memory across list edits.", "default": "" }, "columns": { "title": "Which columns do you want?", "type": "array", "description": "Choose which pieces of information to include in each result row. All are included by default.", "items": { "type": "string", "enum": [ "channelId", "handle", "title", "description", "followerCount", "claimsInChannel", "supportAmount", "tags", "websiteUrl", "email", "avatarUrl", "coverUrl", "joinedDate", "canonicalUrl", "odyseeUrl", "recentVideos", "newVideoCount", "videoId", "videoTitle", "videoDescription", "videoReleaseTime", "videoDuration", "videoThumbnailUrl", "videoUrl", "isNew", "firstSeenAt" ], "enumTitles": [ "Channel ID", "Handle", "Channel name", "Description", "Followers", "Total claims", "Total support (LBC)", "Tags", "Website URL", "Email", "Avatar image", "Cover image", "Joined date", "Canonical URL", "Odysee URL", "Recent uploads (full list)", "New uploads since last run", "Video ID", "Video title", "Video description", "Video release date", "Video duration (seconds)", "Video thumbnail", "Video URL", "Is this video new?", "First seen on a run" ] }, "default": [ "channelId", "handle", "title", "description", "followerCount", "claimsInChannel", "supportAmount", "tags", "websiteUrl", "email", "avatarUrl", "coverUrl", "joinedDate", "canonicalUrl", "odyseeUrl", "recentVideos", "newVideoCount", "videoId", "videoTitle", "videoDescription", "videoReleaseTime", "videoDuration", "videoThumbnailUrl", "videoUrl", "isNew", "firstSeenAt" ] }, "expandRows": { "title": "One row per video (instead of one row per channel)", "type": "boolean", "description": "When on, each video found gets its own row instead of being grouped under its channel. You're still only charged once per channel, no matter how many rows it produces.", "default": false }, "includeRecentVideos": { "title": "How many recent uploads to include (0-30)", "type": "integer", "description": "Each channel's row includes its N most recent uploads (claim ID, title, description, release date, duration, thumbnail). Set to 0 to skip the extra request entirely and get channel stats only.", "default": 10 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel requests. Keep conservative — this target has no browser fallback, so getting blocked costs more than slow-and-steady.", "default": 5 } } }, "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 } } } } } } } } } }