{
  "schemaVersion": "1.0",
  "item": {
    "slug": "tubelab-api",
    "name": "YouTube Outliers & Niche Finder Data by TubeLab",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/antoniojps/tubelab-api",
    "canonicalUrl": "https://clawhub.ai/antoniojps/tubelab-api",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/tubelab-api",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tubelab-api",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "skill.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/tubelab-api"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/tubelab-api",
    "agentPageUrl": "https://openagent3.xyz/skills/tubelab-api/agent",
    "manifestUrl": "https://openagent3.xyz/skills/tubelab-api/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/tubelab-api/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "TubeLab API",
        "body": "YouTube analytics and research API. Discover profitable niches, find viral outlier videos, analyze channels, get transcripts and comments, and run automated scans - all through REST endpoints returning JSON.\n\nBase URL: https://public-api.tubelab.net/v1\nAuth: API key in header\nRate limit: 10 requests/minute per API key\nFormat: JSON request/response\nDocs: https://tubelab.net/docs/api/introduction"
      },
      {
        "title": "Authentication",
        "body": "Every request requires an Authorization header with your API key:\n\nAuthorization: Api-Key $TUBELAB_API_KEY\n\nGet your API key at https://tubelab.net/developers - requires an active subscription."
      },
      {
        "title": "Rate Limits & Credits",
        "body": "Rate limited to 10 requests per minute per API key. Exceeding this returns 429 Too Many Requests.\n\nMost endpoints cost credits. Cached responses (same request within a short window) are free.\n\nEndpointCostGET /search/channels10 creditsGET /search/channels/related10 creditsGET /search/outliers5 creditsGET /search/outliers/related5 creditsGET /channel/videos/{id}freeGET /channel/shorts/{id}freeGET /video/{id}freeGET /video/transcript/{id}freeGET /video/comments/{id}freePOST /scan50–100 creditsGET /scan/{id}free\n\nScan cost depends on mode: Fast = 50 credits, Standard = 100 credits."
      },
      {
        "title": "Search Endpoints",
        "body": "Search for YouTube channels and viral videos (outliers). All search endpoints support pagination, sorting, and 30+ filters."
      },
      {
        "title": "GET /search/channels",
        "body": "Channels\nSearch for channels directly from the YouTube Niche Finder with AI enhanced data and 30+ filters.\nCost: 10 credits per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/search/channels?query=minecraft%20adventures\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nQuery parameters:\n\nNameTypeRequiredDescriptionquerystring[]noSearch queriesseedstring | number | nullnoRandomize search results by passing a random seedfilterBy\"video\" | \"short\"noFilter by statistics of each content kindcontentKind\"video\" | \"short\" | \"long-form\" | \"short-form\"noFilter by type of content created by channel: - video - channel has videos; - short - channel has shorts; - long-form - channel has more...publishedAtFromstringnoFilter by a channel's last parsed video upload date (from a sample of 100 videos) - Expects an ISO date time string.publishedAtTostringnoaverageViewsFromintegernoaverageViewsTointegernomedianViewsFromintegernomedianViewsTointegernolanguagestring[]noISO 639-1 language codesavgViewsToSubscribersRatioFromnumbernoFilter by the outlier score of a channelavgViewsToSubscribersRatioTonumbernosubscribersFromintegernosubscribersTointegernovideosCountFromintegernovideosCountTointegernoviewVariationCoefficientFromnumbernoviewVariationCoefficientTonumbernorevenueMonthlyEstimationFromnumbernorevenueMonthlyEstimationTonumbernorpmEstimationFromnumbernorpmEstimationTonumbernoavgDurationFromintegernoAverage duration of videos in secondsavgDurationTointegernomonetizationAdsensebooleannoFilter by whether the channel has AdSense enabled or notexcludeNichestring[]noExclude niches from search results by keywordsclassificationQuality\"negative\" | \"neutral\" | \"positive\"noAI classification of a channel quality.classificationIsFacelessbooleannoAI  classification wether channel content has faceless potential or notfromintegernoPage to fetchsizeintegernoNumber of items per pagesortBy\"subscribers\" | \"averageViews\" | \"avgViewsToSubscribersRatio\" | \"viewVariationCoefficient\" | \"revenueMonthly\" | \"rpm\" | \"foundAt\" | \"recency\"noSort results by a specific metric:  Beaware when using semantic search (applying a query with the by parameter set to semantic) the sorting...sortOrder\"asc\" | \"desc\"noSorting order of results, where asc is ascending and desc is descending\n\nResponse shape (abbreviated):\n\n{\n  \"pagination\": { \"total\": 100, \"from\": 0, \"size\": 20 },\n  \"hits\": [\n    {\n      \"id\": \"UChn5jutPQB_bRjnG80pzl5w\",\n      \"snippet\": { \"handle\": \"@tubelabhq\", \"title\": \"TubeLab\", \"contentKind\": [\"video\",\"long-form\"] },\n      \"statistics\": { \"subscribers\": 15000, \"averageViews\": 5000, \"avgViewsToSubscribersRatio\": 0.33 },\n      \"language\": { \"code\": \"en\" },\n      \"monetization\": { \"adsense\": true },\n      \"classification\": { \"quality\": \"positive\", \"isFaceless\": false }\n    }\n  ]\n}"
      },
      {
        "title": "GET /search/channels/related",
        "body": "Similar Channels\nSearch for YouTube channels with related content to another channel.\nCost: 10 credits per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/search/channels/related?relatedChannelId=UChn5jutPQB_bRjnG80pzl5w\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nQuery parameters:\n\nNameTypeRequiredDescriptionrelatedChannelIdstring[]yesfilterBy\"video\" | \"short\"noFilter by statistics of each content kindcontentKind\"video\" | \"short\" | \"long-form\" | \"short-form\"noFilter by type of content created by channel: - video - channel has videos; - short - channel has shorts; - long-form - channel has more...publishedAtFromstringnoFilter by a channel's last parsed video upload date (from a sample of 100 videos) - Expects an ISO date time string.publishedAtTostringnoaverageViewsFromintegernoaverageViewsTointegernomedianViewsFromintegernomedianViewsTointegernolanguagestring[]noISO 639-1 language codesavgViewsToSubscribersRatioFromnumbernoFilter by the outlier score of a channelavgViewsToSubscribersRatioTonumbernosubscribersFromintegernosubscribersTointegernovideosCountFromintegernovideosCountTointegernoviewVariationCoefficientFromnumbernoviewVariationCoefficientTonumbernorevenueMonthlyEstimationFromnumbernorevenueMonthlyEstimationTonumbernorpmEstimationFromnumbernorpmEstimationTonumbernoavgDurationFromintegernoAverage duration of videos in secondsavgDurationTointegernomonetizationAdsensebooleannoFilter by whether the channel has AdSense enabled or notexcludeNichestring[]noExclude niches from search results by keywordsclassificationQuality\"negative\" | \"neutral\" | \"positive\"noAI classification of a channel quality.classificationIsFacelessbooleannoAI  classification wether channel content has faceless potential or notfromintegernoPage to fetchsizeintegernoNumber of items per page\n\nResponse shape (abbreviated):\n\n{\n  \"pagination\": { \"total\": 50, \"from\": 0, \"size\": 20 },\n  \"hits\": [\n    {\n      \"id\": \"UCX6OQ3DkcsbYNE6H8uQQuVA\",\n      \"snippet\": { \"handle\": \"@example\", \"title\": \"Example Channel\", \"contentKind\": [\"video\"] },\n      \"statistics\": { \"subscribers\": 25000, \"averageViews\": 8000 },\n      \"language\": { \"code\": \"en\" }\n    }\n  ]\n}"
      },
      {
        "title": "GET /search/outliers",
        "body": "Outliers\nSearch for videos directly from the YouTube Outliers Finder library with AI enhanced data and 30+ filters.\nCost: 5 credits per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?query=minecraft%20adventures&type=video\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nQuery parameters:\n\nNameTypeRequiredDescriptionquerystring[]noSearch queriesseedstring | number | nullnoRandomize search results by passing a random seedsortBy\"views\" | \"zScore\" | \"averageViewsRatio\" | \"publishedAt\" | \"revenue\" | \"rpm\"noSort results by a specific metric:  Beaware when using semantic search (applying a query with the by parameter set to semantic) the sorting...sortOrder\"asc\" | \"desc\"noSorting order of results, where asc is ascending and desc is descendingtype\"video\" | \"short\"noaverageViewsRatioFromnumbernoaverageViewsRatioTonumbernozScoreFromnumbernozScoreTonumbernoviewCountFromintegernoviewCountTointegernolanguagestring[]noISO 639-1 language codesdurationFromintegernodurationTointegernopublishedAtFromstring | stringnopublishedAtTostringnosubscribersCountFromintegernosubscribersCountTointegernochannelAvgViewsFromnumbernochannelAvgViewsTonumbernochannelVideoCountFromintegernochannelVideoCountTointegernochannelIdstringnochannelAvgViewsToSubscribersRatioFromnumbernochannelAvgViewsToSubscribersRatioTonumbernotitlePatternstringnoreferenceIdstringnorpmEstimationFromnumbernorpmEstimationTonumbernorevenueEstimationFromnumbernorevenueEstimationTonumbernochannelMonetizationAdsensebooleannoclassificationQuality\"negative\" | \"neutral\" | \"positive\"noclassificationIsFacelessbooleannoexcludeKeywordstring[]nofromintegernoPage to fetchsizeintegernoNumber of items per pageby\"semantic\" | \"lexical\"noSearch by semantics (meaning of words) or lexical (exact words)\n\nResponse shape (abbreviated):\n\n{\n  \"pagination\": { \"total\": 100, \"from\": 0, \"size\": 20 },\n  \"hits\": [\n    {\n      \"id\": \"SVeXR66hcIg\",\n      \"kind\": \"video\",\n      \"snippet\": { \"channelId\": \"UChn5jutPQB_bRjnG80pzl5w\", \"title\": \"Video Title\", \"channelTitle\": \"Channel Name\", \"publishedAt\": \"2025-01-15T00:00:00Z\" },\n      \"statistics\": { \"viewCount\": 500000, \"zScore\": 4.2, \"averageViewsRatio\": 10.5, \"likeCount\": 15000, \"commentCount\": 1200 },\n      \"classification\": { \"quality\": \"positive\", \"isFaceless\": false }\n    }\n  ]\n}"
      },
      {
        "title": "GET /search/outliers/related",
        "body": "Similar Outliers\nSearch for YouTube outliers with related content to another outlier(s).\nCost: 5 credits per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers/related?title=minecraft%20survival%20tutorial&type=video&by=semantic\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nQuery parameters:\n\nNameTypeRequiredDescriptiontitlestring[]novideoIdstring[]nothumbnailVideoIdstringnoA unique YouTube video identifierrelatedChannelIdstring[]notype\"video\" | \"short\"noaverageViewsRatioFromnumbernoaverageViewsRatioTonumbernozScoreFromnumbernozScoreTonumbernoviewCountFromintegernoviewCountTointegernolanguagestring[]noISO 639-1 language codesdurationFromintegernodurationTointegernopublishedAtFromstring | stringnopublishedAtTostringnosubscribersCountFromintegernosubscribersCountTointegernochannelAvgViewsFromnumbernochannelAvgViewsTonumbernochannelVideoCountFromintegernochannelVideoCountTointegernochannelIdstringnochannelAvgViewsToSubscribersRatioFromnumbernochannelAvgViewsToSubscribersRatioTonumbernotitlePatternstringnoreferenceIdstringnorpmEstimationFromnumbernorpmEstimationTonumbernorevenueEstimationFromnumbernorevenueEstimationTonumbernochannelMonetizationAdsensebooleannoclassificationQuality\"negative\" | \"neutral\" | \"positive\"noclassificationIsFacelessbooleannoexcludeKeywordstring[]nofromintegernoPage to fetchsizeintegernoNumber of items per pageby\"semantic\" | \"lexical\"noSearch by semantics (meaning of words) or lexical (exact words)\n\nResponse shape (abbreviated):\n\n{\n  \"pagination\": { \"total\": 50, \"from\": 0, \"size\": 20 },\n  \"hits\": [\n    {\n      \"id\": \"dQw4w9WgXcQ\",\n      \"kind\": \"video\",\n      \"snippet\": { \"channelId\": \"UChn5jutPQB_bRjnG80pzl5w\", \"title\": \"Similar Video\", \"publishedAt\": \"2025-02-01T00:00:00Z\" },\n      \"statistics\": { \"viewCount\": 120000, \"zScore\": 3.1, \"averageViewsRatio\": 5.2 }\n    }\n  ]\n}"
      },
      {
        "title": "Channel & Video Endpoints",
        "body": "Get detailed information about specific channels and videos."
      },
      {
        "title": "GET /channel/videos/{id}",
        "body": "Channel Videos\nGet videos from a YouTube channel with sampled metrics.\nCost: free per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/channel/videos/UChn5jutPQB_bRjnG80pzl5w\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nPath parameters:\n\nNameTypeDescriptionidstringA unique YouTube channel identifier\n\nResponse shape (abbreviated):\n\n{\n  \"id\": \"UChn5jutPQB_bRjnG80pzl5w\",\n  \"time\": \"2025-06-15T12:00:00Z\",\n  \"item\": {\n    \"id\": \"UChn5jutPQB_bRjnG80pzl5w\",\n    \"kind\": \"channel\",\n    \"snippet\": { \"title\": \"TubeLab\", \"handle\": \"@tubelabhq\" },\n    \"videos\": [{ \"id\": \"SVeXR66hcIg\", \"title\": \"Video Title\", \"viewCount\": 50000, \"publishedAt\": \"2025-01-15T00:00:00Z\" }],\n    \"statistics\": { \"subscribers\": 15000, \"totalViews\": 500000, \"videoCount\": 120 }\n  }\n}"
      },
      {
        "title": "GET /channel/shorts/{id}",
        "body": "Channel Shorts\nGet shorts from a YouTube channel with sampled metrics.\nCost: free per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/channel/shorts/UChn5jutPQB_bRjnG80pzl5w\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nPath parameters:\n\nNameTypeDescriptionidstringA unique YouTube channel identifier\n\nResponse shape (abbreviated):\n\n{\n  \"id\": \"UChn5jutPQB_bRjnG80pzl5w\",\n  \"time\": \"2025-06-15T12:00:00Z\",\n  \"item\": {\n    \"id\": \"UChn5jutPQB_bRjnG80pzl5w\",\n    \"kind\": \"channel\",\n    \"snippet\": { \"title\": \"TubeLab\", \"handle\": \"@tubelabhq\" },\n    \"shorts\": [{ \"id\": \"abc123\", \"title\": \"Short Title\", \"viewCount\": 100000, \"publishedAt\": \"2025-03-01T00:00:00Z\" }],\n    \"statistics\": { \"subscribers\": 15000, \"totalViews\": 500000 }\n  }\n}"
      },
      {
        "title": "GET /video/{id}",
        "body": "Video Details\nGet details of a YouTube video.\nCost: free per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/video/SVeXR66hcIg\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nPath parameters:\n\nNameTypeDescriptionidstringA unique YouTube video identifier\n\nResponse shape (abbreviated):\n\n{\n  \"ids\": [\"SVeXR66hcIg\"],\n  \"time\": \"2025-06-15T12:00:00Z\",\n  \"items\": [\n    {\n      \"id\": \"SVeXR66hcIg\",\n      \"kind\": \"video\",\n      \"snippet\": { \"channelId\": \"UChn5jutPQB_bRjnG80pzl5w\", \"title\": \"Video Title\", \"publishedAt\": \"2025-01-15T00:00:00Z\" },\n      \"statistics\": { \"viewCount\": 50000, \"likeCount\": 2000, \"commentCount\": 300 }\n    }\n  ]\n}"
      },
      {
        "title": "GET /video/transcript/{id}",
        "body": "Video Transcript\nGet the transcript of a YouTube video.\nCost: free per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/video/transcript/SVeXR66hcIg\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nPath parameters:\n\nNameTypeDescriptionidstringA unique YouTube video identifier\n\nResponse shape (abbreviated):\n\n{\n  \"ids\": [\"SVeXR66hcIg\"],\n  \"items\": [\n    {\n      \"id\": \"SVeXR66hcIg\",\n      \"events\": [{ \"startMs\": 0, \"durationMs\": 5000, \"endMs\": 5000, \"text\": \"Hello and welcome...\" }],\n      \"transcript\": \"Hello and welcome to this video...\"\n    }\n  ]\n}"
      },
      {
        "title": "GET /video/comments/{id}",
        "body": "Video Comments\nGet the last 100 comments of a YouTube video.\nCost: free per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/video/comments/SVeXR66hcIg\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nPath parameters:\n\nNameTypeDescriptionidstringA unique YouTube video identifier\n\nResponse shape (abbreviated):\n\n{\n  \"ids\": [\"SVeXR66hcIg\"],\n  \"time\": \"2025-06-15T12:00:00Z\",\n  \"items\": [\n    {\n      \"id\": \"SVeXR66hcIg\",\n      \"comments\": [{ \"authorText\": \"User\", \"text\": \"Great video!\", \"likesCount\": 42, \"replyCount\": 3, \"publishedAt\": \"2025-01-16T00:00:00Z\" }],\n      \"statistics\": { \"count\": 300 }\n    }\n  ]\n}"
      },
      {
        "title": "Scanning Endpoints",
        "body": "Start YouTube scans to discover channels and outlier videos in any niche. Scans run asynchronously - start one, then poll for status."
      },
      {
        "title": "POST /scan",
        "body": "Scan\nStart a YouTube scan to search for outliers and channels on any given topic.\nCost: 50–100 credits per request.\n\ncurl -s -X POST \"https://public-api.tubelab.net/v1/scan\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"findBy\":\"query\",\"query\":[\"UCUyeluBRhGPCW4rPe_UvBZQ\",\"UCX6OQ3DkcsbYNE6H8uQQuVA\"],\"mode\":\"standard\"}'\n\nBody parameters:\n\nNameTypeRequiredDefaultDescriptionfindBy\"channels\" | \"query\"noqueryStart the scan from queries (search results) or channelsquerystring[]yesSearch queries or YouTube channel idsmode\"fast\" | \"standard\"nofast- Fast: 1000 outliers or 100 channels - Standard: 2500 outliers or 250 channels\n\nResponse shape (abbreviated):\n\n{\n  \"id\": \"2a5e56f5-75f3-4f01-ac85-6e796f5cde87\",\n  \"name\": \"minecraft, gaming\",\n  \"status\": \"Queued\",\n  \"input\": { \"query\": [\"minecraft\", \"gaming\"], \"threshold\": 1000 },\n  \"endedAt\": null,\n  \"createdAt\": \"2025-06-15T12:00:00Z\",\n  \"updatedAt\": \"2025-06-15T12:00:00Z\"\n}"
      },
      {
        "title": "GET /scan/{id}",
        "body": "Scan\nGet a scan by id.\nCost: free per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/scan/2a5e56f5-75f3-4f01-ac85-6e796f5cde87\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nPath parameters:\n\nNameTypeDescriptionidstringScan id\n\nResponse shape (abbreviated):\n\n{\n  \"id\": \"2a5e56f5-75f3-4f01-ac85-6e796f5cde87\",\n  \"name\": \"minecraft, gaming\",\n  \"status\": \"Completed\",\n  \"input\": { \"query\": [\"minecraft\", \"gaming\"], \"threshold\": 1000 },\n  \"endedAt\": \"2025-06-15T13:30:00Z\",\n  \"createdAt\": \"2025-06-15T12:00:00Z\",\n  \"updatedAt\": \"2025-06-15T13:30:00Z\"\n}"
      },
      {
        "title": "Scan Workflow",
        "body": "Scans run asynchronously. Here's the typical flow:\n\nStart a scan with POST /scan - returns a scan ID and status Queued\nPoll for status with GET /scan/{id} - status progresses: Queued → Running → Completed\nSearch results with GET /search/outliers?referenceId={scanId} - returns discovered outlier videos\n\n# 1. Start scan\nSCAN_ID=$(curl -s -X POST \"https://public-api.tubelab.net/v1/scan\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"query\":[\"minecraft\",\"gaming\"],\"mode\":\"fast\"}' | jq -r '.id')\n\n# 2. Poll until complete\ncurl -s \"https://public-api.tubelab.net/v1/scan/$SCAN_ID\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\" | jq '.status'\n\n# 3. Search results once completed\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?referenceId=$SCAN_ID\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nModeOutliers LimitChannels LimitCostEst. TimeFast1,00010050 credits30 min – 2 hrsStandard2,500250100 credits2 – 4 hrs"
      },
      {
        "title": "Pagination",
        "body": "Search endpoints return pagination.total, pagination.from, and pagination.size. Use from and size query params to paginate:\n\n# Page 1 (items 0-19)\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?query=minecraft%20adventures&type=video&from=0&size=20\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\n# Page 2 (items 20-39)\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?query=minecraft%20adventures&type=video&from=20&size=20\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\""
      },
      {
        "title": "Range Filters",
        "body": "Many numeric fields support From/To suffixes for range filtering:\n\n# Channels with 10k-100k subscribers and avg views > 5000\ncurl -s \"https://public-api.tubelab.net/v1/search/channels?query=cooking%20healthy%20recipes&subscribersFrom=10000&subscribersTo=100000&averageViewsFrom=5000\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\""
      },
      {
        "title": "Sorting",
        "body": "Use sortBy and sortOrder params. Available sort fields vary by endpoint.\n\nImportant: When using query, omit sortBy to get the default relevance-based ranking. Adding a sort like sortBy=views overrides relevance and returns results ordered by that field, which usually produces worse matches. Only add sortBy when you don't use query (e.g. filter-only searches).\n\n# Filter-only search (no query) — sorting makes sense here\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?type=video&classificationQuality=positive&sortBy=views&sortOrder=desc\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\""
      },
      {
        "title": "Array Parameters",
        "body": "Array params use repeated keys:\n\n# Multiple search queries\ncurl -s \"https://public-api.tubelab.net/v1/search/channels?query=minecraft%20adventures&query=gaming%20tutorials\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\""
      },
      {
        "title": "Search Recipes",
        "body": "Ready-to-use filter combinations for common research tasks. Date filters use ISO 8601 format - compute relative dates with date or substitute directly.\n\nTip - queries: Search is semantic — longer, descriptive queries return much better results than single keywords. Use query=minecraft adventures or query=cooking healthy recipes instead of just query=minecraft or query=cooking. Think 2-4 words that describe the niche.\n\nTip - sorting: When using query, do NOT add sortBy — the default sort is by relevance and gives the best matches. Only use sortBy for filter-only searches (no query), e.g. sorting by foundAt or views.\n\nTip - averageViewsRatio: When searching outliers, prefer averageViewsRatioFrom=1 to find videos that outperformed the channel's average. A ratio of 2 means the video got 2x the channel's usual views. Values above 5 are very rare and indicate extreme virality - only use higher thresholds when you want to narrow results significantly.\n\nTip - content type: When searching outliers, prefer type=video to focus on long-form videos. Shorts tend to have inflated view counts and skew results. Only use type=short when specifically researching short-form content."
      },
      {
        "title": "Profitable channels (recently found)",
        "body": "Monetized channels found in the last year with estimated monthly revenue above $1,000 and at least 1,000 subscribers. Sorted by discovery date.\n\nONE_YEAR_AGO=$(date -u -d \"1 year ago\" +%Y-%m-%dT00:00:00Z 2>/dev/null || date -u -v-1y +%Y-%m-%dT00:00:00Z)\ncurl -s \"https://public-api.tubelab.net/v1/search/channels?monetizationAdsense=true&revenueMonthlyEstimationFrom=1000&subscribersFrom=1000&publishedAtFrom=$ONE_YEAR_AGO&language=en&language=de&language=fr&excludeNiche=music&excludeNiche=song&excludeNiche=lofi&excludeNiche=movies&excludeNiche=kids&excludeNiche=news&excludeNiche=politic&sortBy=foundAt&size=20\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\""
      },
      {
        "title": "Trending channels",
        "body": "Channels with high engagement (avg views/subscribers ratio above 1) and at least 10,000 average views, found in the last 6 months. Good for spotting rising creators.\n\nSIX_MONTHS_AGO=$(date -u -d \"6 months ago\" +%Y-%m-%dT00:00:00Z 2>/dev/null || date -u -v-6m +%Y-%m-%dT00:00:00Z)\ncurl -s \"https://public-api.tubelab.net/v1/search/channels?avgViewsToSubscribersRatioFrom=1&averageViewsFrom=10000&subscribersFrom=100&publishedAtFrom=$SIX_MONTHS_AGO&language=en&language=de&language=fr&excludeNiche=music&excludeNiche=song&excludeNiche=lofi&excludeNiche=movies&sortBy=foundAt&size=20\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\""
      },
      {
        "title": "Faceless viral videos",
        "body": "AI-classified faceless videos with positive quality published in the last month. Useful for finding faceless niche ideas.\n\nONE_MONTH_AGO=$(date -u -d \"1 month ago\" +%Y-%m-%dT00:00:00Z 2>/dev/null || date -u -v-1m +%Y-%m-%dT00:00:00Z)\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?type=video&classificationIsFaceless=true&classificationQuality=positive&publishedAtFrom=$ONE_MONTH_AGO&size=20\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\""
      },
      {
        "title": "High authenticity videos",
        "body": "Videos classified as positive quality by AI. Filters out low-effort and spammy content.\n\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?type=video&classificationQuality=positive&size=20\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\""
      },
      {
        "title": "Monetized channel videos",
        "body": "Outlier videos from channels with AdSense enabled. Useful for researching niches that generate ad revenue.\n\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?type=video&channelMonetizationAdsense=true&size=20\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\""
      },
      {
        "title": "Error Handling",
        "body": "All errors return JSON with an error object:\n\nStatusMeaningResponse400Validation error{ \"error\": { \"errors\": [{ \"code\": \"...\", \"message\": \"...\", \"path\": [\"param\"] }] } }401Invalid/missing API key{ \"error\": { \"message\": \"Unauthorized\" }, \"status\": \"error\" }402Insufficient credits{ \"error\": { \"message\": \"Insufficient credits\" }, \"status\": \"error\" }429Rate limited{ \"error\": { \"message\": \"Rate limit exceeded\", \"rateLimit\": { \"limit\": 10, \"current\": 11, \"remaining\": 0 } } }"
      },
      {
        "title": "jq Recipes",
        "body": "# Profitable channels: extract name, subs, revenue, and views\nONE_YEAR_AGO=$(date -u -d \"1 year ago\" +%Y-%m-%dT00:00:00Z 2>/dev/null || date -u -v-1y +%Y-%m-%dT00:00:00Z)\ncurl -s \"https://public-api.tubelab.net/v1/search/channels?monetizationAdsense=true&revenueMonthlyEstimationFrom=1000&subscribersFrom=1000&publishedAtFrom=$ONE_YEAR_AGO&sortBy=foundAt&size=10\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\" | jq '[.hits[] | {title: .snippet.title, handle: .snippet.handle, subs: .statistics.subscribers, avgViews: .statistics.averageViews}]'\n\n# Trending channels: list titles with engagement ratio\nSIX_MONTHS_AGO=$(date -u -d \"6 months ago\" +%Y-%m-%dT00:00:00Z 2>/dev/null || date -u -v-6m +%Y-%m-%dT00:00:00Z)\ncurl -s \"https://public-api.tubelab.net/v1/search/channels?avgViewsToSubscribersRatioFrom=1&averageViewsFrom=10000&subscribersFrom=100&publishedAtFrom=$SIX_MONTHS_AGO&sortBy=foundAt&size=10\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\" | jq '[.hits[] | {title: .snippet.title, subs: .statistics.subscribers, ratio: .statistics.avgViewsToSubscribersRatio}]'\n\n# Faceless viral videos: extract title, views, and z-score\nONE_MONTH_AGO=$(date -u -d \"1 month ago\" +%Y-%m-%dT00:00:00Z 2>/dev/null || date -u -v-1m +%Y-%m-%dT00:00:00Z)\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?type=video&classificationIsFaceless=true&classificationQuality=positive&publishedAtFrom=$ONE_MONTH_AGO&size=10\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\" | jq '[.hits[] | {title: .snippet.title, views: .statistics.viewCount, zScore: .statistics.zScore, channel: .snippet.channelTitle}]'\n\n# High-quality outliers: get top videos by views\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?type=video&classificationQuality=positive&sortBy=views&sortOrder=desc&size=10\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\" | jq '[.hits[] | {title: .snippet.title, views: .statistics.viewCount, channel: .snippet.channelTitle}]'\n\n# Get full transcript as plain text\ncurl -s \"https://public-api.tubelab.net/v1/video/transcript/SVeXR66hcIg\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\" | jq -r '.items[0].transcript'\n\n# Poll scan status until complete\ncurl -s \"https://public-api.tubelab.net/v1/scan/2a5e56f5-75f3-4f01-ac85-6e796f5cde87\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\" | jq '{status: .status, endedAt: .endedAt}'"
      }
    ],
    "body": "TubeLab API\n\nYouTube analytics and research API. Discover profitable niches, find viral outlier videos, analyze channels, get transcripts and comments, and run automated scans - all through REST endpoints returning JSON.\n\nBase URL: https://public-api.tubelab.net/v1\nAuth: API key in header\nRate limit: 10 requests/minute per API key\nFormat: JSON request/response\nDocs: https://tubelab.net/docs/api/introduction\nAuthentication\n\nEvery request requires an Authorization header with your API key:\n\nAuthorization: Api-Key $TUBELAB_API_KEY\n\n\nGet your API key at https://tubelab.net/developers - requires an active subscription.\n\nRate Limits & Credits\n\nRate limited to 10 requests per minute per API key. Exceeding this returns 429 Too Many Requests.\n\nMost endpoints cost credits. Cached responses (same request within a short window) are free.\n\nEndpoint\tCost\nGET /search/channels\t10 credits\nGET /search/channels/related\t10 credits\nGET /search/outliers\t5 credits\nGET /search/outliers/related\t5 credits\nGET /channel/videos/{id}\tfree\nGET /channel/shorts/{id}\tfree\nGET /video/{id}\tfree\nGET /video/transcript/{id}\tfree\nGET /video/comments/{id}\tfree\nPOST /scan\t50–100 credits\nGET /scan/{id}\tfree\n\nScan cost depends on mode: Fast = 50 credits, Standard = 100 credits.\n\nSearch Endpoints\n\nSearch for YouTube channels and viral videos (outliers). All search endpoints support pagination, sorting, and 30+ filters.\n\nGET /search/channels\n\nChannels Search for channels directly from the YouTube Niche Finder with AI enhanced data and 30+ filters. Cost: 10 credits per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/search/channels?query=minecraft%20adventures\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\n\nQuery parameters:\n\nName\tType\tRequired\tDescription\nquery\tstring[]\tno\tSearch queries\nseed\tstring | number | null\tno\tRandomize search results by passing a random seed\nfilterBy\t\"video\" | \"short\"\tno\tFilter by statistics of each content kind\ncontentKind\t\"video\" | \"short\" | \"long-form\" | \"short-form\"\tno\tFilter by type of content created by channel: - video - channel has videos; - short - channel has shorts; - long-form - channel has more...\npublishedAtFrom\tstring\tno\tFilter by a channel's last parsed video upload date (from a sample of 100 videos) - Expects an ISO date time string.\npublishedAtTo\tstring\tno\t\naverageViewsFrom\tinteger\tno\t\naverageViewsTo\tinteger\tno\t\nmedianViewsFrom\tinteger\tno\t\nmedianViewsTo\tinteger\tno\t\nlanguage\tstring[]\tno\tISO 639-1 language codes\navgViewsToSubscribersRatioFrom\tnumber\tno\tFilter by the outlier score of a channel\navgViewsToSubscribersRatioTo\tnumber\tno\t\nsubscribersFrom\tinteger\tno\t\nsubscribersTo\tinteger\tno\t\nvideosCountFrom\tinteger\tno\t\nvideosCountTo\tinteger\tno\t\nviewVariationCoefficientFrom\tnumber\tno\t\nviewVariationCoefficientTo\tnumber\tno\t\nrevenueMonthlyEstimationFrom\tnumber\tno\t\nrevenueMonthlyEstimationTo\tnumber\tno\t\nrpmEstimationFrom\tnumber\tno\t\nrpmEstimationTo\tnumber\tno\t\navgDurationFrom\tinteger\tno\tAverage duration of videos in seconds\navgDurationTo\tinteger\tno\t\nmonetizationAdsense\tboolean\tno\tFilter by whether the channel has AdSense enabled or not\nexcludeNiche\tstring[]\tno\tExclude niches from search results by keywords\nclassificationQuality\t\"negative\" | \"neutral\" | \"positive\"\tno\tAI classification of a channel quality.\nclassificationIsFaceless\tboolean\tno\tAI classification wether channel content has faceless potential or not\nfrom\tinteger\tno\tPage to fetch\nsize\tinteger\tno\tNumber of items per page\nsortBy\t\"subscribers\" | \"averageViews\" | \"avgViewsToSubscribersRatio\" | \"viewVariationCoefficient\" | \"revenueMonthly\" | \"rpm\" | \"foundAt\" | \"recency\"\tno\tSort results by a specific metric: Beaware when using semantic search (applying a query with the by parameter set to semantic) the sorting...\nsortOrder\t\"asc\" | \"desc\"\tno\tSorting order of results, where asc is ascending and desc is descending\n\nResponse shape (abbreviated):\n\n{\n  \"pagination\": { \"total\": 100, \"from\": 0, \"size\": 20 },\n  \"hits\": [\n    {\n      \"id\": \"UChn5jutPQB_bRjnG80pzl5w\",\n      \"snippet\": { \"handle\": \"@tubelabhq\", \"title\": \"TubeLab\", \"contentKind\": [\"video\",\"long-form\"] },\n      \"statistics\": { \"subscribers\": 15000, \"averageViews\": 5000, \"avgViewsToSubscribersRatio\": 0.33 },\n      \"language\": { \"code\": \"en\" },\n      \"monetization\": { \"adsense\": true },\n      \"classification\": { \"quality\": \"positive\", \"isFaceless\": false }\n    }\n  ]\n}\n\nGET /search/channels/related\n\nSimilar Channels Search for YouTube channels with related content to another channel. Cost: 10 credits per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/search/channels/related?relatedChannelId=UChn5jutPQB_bRjnG80pzl5w\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\n\nQuery parameters:\n\nName\tType\tRequired\tDescription\nrelatedChannelId\tstring[]\tyes\t\nfilterBy\t\"video\" | \"short\"\tno\tFilter by statistics of each content kind\ncontentKind\t\"video\" | \"short\" | \"long-form\" | \"short-form\"\tno\tFilter by type of content created by channel: - video - channel has videos; - short - channel has shorts; - long-form - channel has more...\npublishedAtFrom\tstring\tno\tFilter by a channel's last parsed video upload date (from a sample of 100 videos) - Expects an ISO date time string.\npublishedAtTo\tstring\tno\t\naverageViewsFrom\tinteger\tno\t\naverageViewsTo\tinteger\tno\t\nmedianViewsFrom\tinteger\tno\t\nmedianViewsTo\tinteger\tno\t\nlanguage\tstring[]\tno\tISO 639-1 language codes\navgViewsToSubscribersRatioFrom\tnumber\tno\tFilter by the outlier score of a channel\navgViewsToSubscribersRatioTo\tnumber\tno\t\nsubscribersFrom\tinteger\tno\t\nsubscribersTo\tinteger\tno\t\nvideosCountFrom\tinteger\tno\t\nvideosCountTo\tinteger\tno\t\nviewVariationCoefficientFrom\tnumber\tno\t\nviewVariationCoefficientTo\tnumber\tno\t\nrevenueMonthlyEstimationFrom\tnumber\tno\t\nrevenueMonthlyEstimationTo\tnumber\tno\t\nrpmEstimationFrom\tnumber\tno\t\nrpmEstimationTo\tnumber\tno\t\navgDurationFrom\tinteger\tno\tAverage duration of videos in seconds\navgDurationTo\tinteger\tno\t\nmonetizationAdsense\tboolean\tno\tFilter by whether the channel has AdSense enabled or not\nexcludeNiche\tstring[]\tno\tExclude niches from search results by keywords\nclassificationQuality\t\"negative\" | \"neutral\" | \"positive\"\tno\tAI classification of a channel quality.\nclassificationIsFaceless\tboolean\tno\tAI classification wether channel content has faceless potential or not\nfrom\tinteger\tno\tPage to fetch\nsize\tinteger\tno\tNumber of items per page\n\nResponse shape (abbreviated):\n\n{\n  \"pagination\": { \"total\": 50, \"from\": 0, \"size\": 20 },\n  \"hits\": [\n    {\n      \"id\": \"UCX6OQ3DkcsbYNE6H8uQQuVA\",\n      \"snippet\": { \"handle\": \"@example\", \"title\": \"Example Channel\", \"contentKind\": [\"video\"] },\n      \"statistics\": { \"subscribers\": 25000, \"averageViews\": 8000 },\n      \"language\": { \"code\": \"en\" }\n    }\n  ]\n}\n\nGET /search/outliers\n\nOutliers Search for videos directly from the YouTube Outliers Finder library with AI enhanced data and 30+ filters. Cost: 5 credits per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?query=minecraft%20adventures&type=video\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\n\nQuery parameters:\n\nName\tType\tRequired\tDescription\nquery\tstring[]\tno\tSearch queries\nseed\tstring | number | null\tno\tRandomize search results by passing a random seed\nsortBy\t\"views\" | \"zScore\" | \"averageViewsRatio\" | \"publishedAt\" | \"revenue\" | \"rpm\"\tno\tSort results by a specific metric: Beaware when using semantic search (applying a query with the by parameter set to semantic) the sorting...\nsortOrder\t\"asc\" | \"desc\"\tno\tSorting order of results, where asc is ascending and desc is descending\ntype\t\"video\" | \"short\"\tno\t\naverageViewsRatioFrom\tnumber\tno\t\naverageViewsRatioTo\tnumber\tno\t\nzScoreFrom\tnumber\tno\t\nzScoreTo\tnumber\tno\t\nviewCountFrom\tinteger\tno\t\nviewCountTo\tinteger\tno\t\nlanguage\tstring[]\tno\tISO 639-1 language codes\ndurationFrom\tinteger\tno\t\ndurationTo\tinteger\tno\t\npublishedAtFrom\tstring | string\tno\t\npublishedAtTo\tstring\tno\t\nsubscribersCountFrom\tinteger\tno\t\nsubscribersCountTo\tinteger\tno\t\nchannelAvgViewsFrom\tnumber\tno\t\nchannelAvgViewsTo\tnumber\tno\t\nchannelVideoCountFrom\tinteger\tno\t\nchannelVideoCountTo\tinteger\tno\t\nchannelId\tstring\tno\t\nchannelAvgViewsToSubscribersRatioFrom\tnumber\tno\t\nchannelAvgViewsToSubscribersRatioTo\tnumber\tno\t\ntitlePattern\tstring\tno\t\nreferenceId\tstring\tno\t\nrpmEstimationFrom\tnumber\tno\t\nrpmEstimationTo\tnumber\tno\t\nrevenueEstimationFrom\tnumber\tno\t\nrevenueEstimationTo\tnumber\tno\t\nchannelMonetizationAdsense\tboolean\tno\t\nclassificationQuality\t\"negative\" | \"neutral\" | \"positive\"\tno\t\nclassificationIsFaceless\tboolean\tno\t\nexcludeKeyword\tstring[]\tno\t\nfrom\tinteger\tno\tPage to fetch\nsize\tinteger\tno\tNumber of items per page\nby\t\"semantic\" | \"lexical\"\tno\tSearch by semantics (meaning of words) or lexical (exact words)\n\nResponse shape (abbreviated):\n\n{\n  \"pagination\": { \"total\": 100, \"from\": 0, \"size\": 20 },\n  \"hits\": [\n    {\n      \"id\": \"SVeXR66hcIg\",\n      \"kind\": \"video\",\n      \"snippet\": { \"channelId\": \"UChn5jutPQB_bRjnG80pzl5w\", \"title\": \"Video Title\", \"channelTitle\": \"Channel Name\", \"publishedAt\": \"2025-01-15T00:00:00Z\" },\n      \"statistics\": { \"viewCount\": 500000, \"zScore\": 4.2, \"averageViewsRatio\": 10.5, \"likeCount\": 15000, \"commentCount\": 1200 },\n      \"classification\": { \"quality\": \"positive\", \"isFaceless\": false }\n    }\n  ]\n}\n\nGET /search/outliers/related\n\nSimilar Outliers Search for YouTube outliers with related content to another outlier(s). Cost: 5 credits per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers/related?title=minecraft%20survival%20tutorial&type=video&by=semantic\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\n\nQuery parameters:\n\nName\tType\tRequired\tDescription\ntitle\tstring[]\tno\t\nvideoId\tstring[]\tno\t\nthumbnailVideoId\tstring\tno\tA unique YouTube video identifier\nrelatedChannelId\tstring[]\tno\t\ntype\t\"video\" | \"short\"\tno\t\naverageViewsRatioFrom\tnumber\tno\t\naverageViewsRatioTo\tnumber\tno\t\nzScoreFrom\tnumber\tno\t\nzScoreTo\tnumber\tno\t\nviewCountFrom\tinteger\tno\t\nviewCountTo\tinteger\tno\t\nlanguage\tstring[]\tno\tISO 639-1 language codes\ndurationFrom\tinteger\tno\t\ndurationTo\tinteger\tno\t\npublishedAtFrom\tstring | string\tno\t\npublishedAtTo\tstring\tno\t\nsubscribersCountFrom\tinteger\tno\t\nsubscribersCountTo\tinteger\tno\t\nchannelAvgViewsFrom\tnumber\tno\t\nchannelAvgViewsTo\tnumber\tno\t\nchannelVideoCountFrom\tinteger\tno\t\nchannelVideoCountTo\tinteger\tno\t\nchannelId\tstring\tno\t\nchannelAvgViewsToSubscribersRatioFrom\tnumber\tno\t\nchannelAvgViewsToSubscribersRatioTo\tnumber\tno\t\ntitlePattern\tstring\tno\t\nreferenceId\tstring\tno\t\nrpmEstimationFrom\tnumber\tno\t\nrpmEstimationTo\tnumber\tno\t\nrevenueEstimationFrom\tnumber\tno\t\nrevenueEstimationTo\tnumber\tno\t\nchannelMonetizationAdsense\tboolean\tno\t\nclassificationQuality\t\"negative\" | \"neutral\" | \"positive\"\tno\t\nclassificationIsFaceless\tboolean\tno\t\nexcludeKeyword\tstring[]\tno\t\nfrom\tinteger\tno\tPage to fetch\nsize\tinteger\tno\tNumber of items per page\nby\t\"semantic\" | \"lexical\"\tno\tSearch by semantics (meaning of words) or lexical (exact words)\n\nResponse shape (abbreviated):\n\n{\n  \"pagination\": { \"total\": 50, \"from\": 0, \"size\": 20 },\n  \"hits\": [\n    {\n      \"id\": \"dQw4w9WgXcQ\",\n      \"kind\": \"video\",\n      \"snippet\": { \"channelId\": \"UChn5jutPQB_bRjnG80pzl5w\", \"title\": \"Similar Video\", \"publishedAt\": \"2025-02-01T00:00:00Z\" },\n      \"statistics\": { \"viewCount\": 120000, \"zScore\": 3.1, \"averageViewsRatio\": 5.2 }\n    }\n  ]\n}\n\nChannel & Video Endpoints\n\nGet detailed information about specific channels and videos.\n\nGET /channel/videos/{id}\n\nChannel Videos Get videos from a YouTube channel with sampled metrics. Cost: free per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/channel/videos/UChn5jutPQB_bRjnG80pzl5w\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\n\nPath parameters:\n\nName\tType\tDescription\nid\tstring\tA unique YouTube channel identifier\n\nResponse shape (abbreviated):\n\n{\n  \"id\": \"UChn5jutPQB_bRjnG80pzl5w\",\n  \"time\": \"2025-06-15T12:00:00Z\",\n  \"item\": {\n    \"id\": \"UChn5jutPQB_bRjnG80pzl5w\",\n    \"kind\": \"channel\",\n    \"snippet\": { \"title\": \"TubeLab\", \"handle\": \"@tubelabhq\" },\n    \"videos\": [{ \"id\": \"SVeXR66hcIg\", \"title\": \"Video Title\", \"viewCount\": 50000, \"publishedAt\": \"2025-01-15T00:00:00Z\" }],\n    \"statistics\": { \"subscribers\": 15000, \"totalViews\": 500000, \"videoCount\": 120 }\n  }\n}\n\nGET /channel/shorts/{id}\n\nChannel Shorts Get shorts from a YouTube channel with sampled metrics. Cost: free per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/channel/shorts/UChn5jutPQB_bRjnG80pzl5w\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\n\nPath parameters:\n\nName\tType\tDescription\nid\tstring\tA unique YouTube channel identifier\n\nResponse shape (abbreviated):\n\n{\n  \"id\": \"UChn5jutPQB_bRjnG80pzl5w\",\n  \"time\": \"2025-06-15T12:00:00Z\",\n  \"item\": {\n    \"id\": \"UChn5jutPQB_bRjnG80pzl5w\",\n    \"kind\": \"channel\",\n    \"snippet\": { \"title\": \"TubeLab\", \"handle\": \"@tubelabhq\" },\n    \"shorts\": [{ \"id\": \"abc123\", \"title\": \"Short Title\", \"viewCount\": 100000, \"publishedAt\": \"2025-03-01T00:00:00Z\" }],\n    \"statistics\": { \"subscribers\": 15000, \"totalViews\": 500000 }\n  }\n}\n\nGET /video/{id}\n\nVideo Details Get details of a YouTube video. Cost: free per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/video/SVeXR66hcIg\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\n\nPath parameters:\n\nName\tType\tDescription\nid\tstring\tA unique YouTube video identifier\n\nResponse shape (abbreviated):\n\n{\n  \"ids\": [\"SVeXR66hcIg\"],\n  \"time\": \"2025-06-15T12:00:00Z\",\n  \"items\": [\n    {\n      \"id\": \"SVeXR66hcIg\",\n      \"kind\": \"video\",\n      \"snippet\": { \"channelId\": \"UChn5jutPQB_bRjnG80pzl5w\", \"title\": \"Video Title\", \"publishedAt\": \"2025-01-15T00:00:00Z\" },\n      \"statistics\": { \"viewCount\": 50000, \"likeCount\": 2000, \"commentCount\": 300 }\n    }\n  ]\n}\n\nGET /video/transcript/{id}\n\nVideo Transcript Get the transcript of a YouTube video. Cost: free per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/video/transcript/SVeXR66hcIg\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\n\nPath parameters:\n\nName\tType\tDescription\nid\tstring\tA unique YouTube video identifier\n\nResponse shape (abbreviated):\n\n{\n  \"ids\": [\"SVeXR66hcIg\"],\n  \"items\": [\n    {\n      \"id\": \"SVeXR66hcIg\",\n      \"events\": [{ \"startMs\": 0, \"durationMs\": 5000, \"endMs\": 5000, \"text\": \"Hello and welcome...\" }],\n      \"transcript\": \"Hello and welcome to this video...\"\n    }\n  ]\n}\n\nGET /video/comments/{id}\n\nVideo Comments Get the last 100 comments of a YouTube video. Cost: free per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/video/comments/SVeXR66hcIg\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\n\nPath parameters:\n\nName\tType\tDescription\nid\tstring\tA unique YouTube video identifier\n\nResponse shape (abbreviated):\n\n{\n  \"ids\": [\"SVeXR66hcIg\"],\n  \"time\": \"2025-06-15T12:00:00Z\",\n  \"items\": [\n    {\n      \"id\": \"SVeXR66hcIg\",\n      \"comments\": [{ \"authorText\": \"User\", \"text\": \"Great video!\", \"likesCount\": 42, \"replyCount\": 3, \"publishedAt\": \"2025-01-16T00:00:00Z\" }],\n      \"statistics\": { \"count\": 300 }\n    }\n  ]\n}\n\nScanning Endpoints\n\nStart YouTube scans to discover channels and outlier videos in any niche. Scans run asynchronously - start one, then poll for status.\n\nPOST /scan\n\nScan Start a YouTube scan to search for outliers and channels on any given topic. Cost: 50–100 credits per request.\n\ncurl -s -X POST \"https://public-api.tubelab.net/v1/scan\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"findBy\":\"query\",\"query\":[\"UCUyeluBRhGPCW4rPe_UvBZQ\",\"UCX6OQ3DkcsbYNE6H8uQQuVA\"],\"mode\":\"standard\"}'\n\n\nBody parameters:\n\nName\tType\tRequired\tDefault\tDescription\nfindBy\t\"channels\" | \"query\"\tno\tquery\tStart the scan from queries (search results) or channels\nquery\tstring[]\tyes\t\tSearch queries or YouTube channel ids\nmode\t\"fast\" | \"standard\"\tno\tfast\t- Fast: 1000 outliers or 100 channels - Standard: 2500 outliers or 250 channels\n\nResponse shape (abbreviated):\n\n{\n  \"id\": \"2a5e56f5-75f3-4f01-ac85-6e796f5cde87\",\n  \"name\": \"minecraft, gaming\",\n  \"status\": \"Queued\",\n  \"input\": { \"query\": [\"minecraft\", \"gaming\"], \"threshold\": 1000 },\n  \"endedAt\": null,\n  \"createdAt\": \"2025-06-15T12:00:00Z\",\n  \"updatedAt\": \"2025-06-15T12:00:00Z\"\n}\n\nGET /scan/{id}\n\nScan Get a scan by id. Cost: free per request.\n\ncurl -s \"https://public-api.tubelab.net/v1/scan/2a5e56f5-75f3-4f01-ac85-6e796f5cde87\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\n\nPath parameters:\n\nName\tType\tDescription\nid\tstring\tScan id\n\nResponse shape (abbreviated):\n\n{\n  \"id\": \"2a5e56f5-75f3-4f01-ac85-6e796f5cde87\",\n  \"name\": \"minecraft, gaming\",\n  \"status\": \"Completed\",\n  \"input\": { \"query\": [\"minecraft\", \"gaming\"], \"threshold\": 1000 },\n  \"endedAt\": \"2025-06-15T13:30:00Z\",\n  \"createdAt\": \"2025-06-15T12:00:00Z\",\n  \"updatedAt\": \"2025-06-15T13:30:00Z\"\n}\n\nScan Workflow\n\nScans run asynchronously. Here's the typical flow:\n\nStart a scan with POST /scan - returns a scan ID and status Queued\nPoll for status with GET /scan/{id} - status progresses: Queued → Running → Completed\nSearch results with GET /search/outliers?referenceId={scanId} - returns discovered outlier videos\n# 1. Start scan\nSCAN_ID=$(curl -s -X POST \"https://public-api.tubelab.net/v1/scan\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"query\":[\"minecraft\",\"gaming\"],\"mode\":\"fast\"}' | jq -r '.id')\n\n# 2. Poll until complete\ncurl -s \"https://public-api.tubelab.net/v1/scan/$SCAN_ID\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\" | jq '.status'\n\n# 3. Search results once completed\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?referenceId=$SCAN_ID\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nMode\tOutliers Limit\tChannels Limit\tCost\tEst. Time\nFast\t1,000\t100\t50 credits\t30 min – 2 hrs\nStandard\t2,500\t250\t100 credits\t2 – 4 hrs\nCommon Patterns\nPagination\n\nSearch endpoints return pagination.total, pagination.from, and pagination.size. Use from and size query params to paginate:\n\n# Page 1 (items 0-19)\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?query=minecraft%20adventures&type=video&from=0&size=20\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\n# Page 2 (items 20-39)\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?query=minecraft%20adventures&type=video&from=20&size=20\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nRange Filters\n\nMany numeric fields support From/To suffixes for range filtering:\n\n# Channels with 10k-100k subscribers and avg views > 5000\ncurl -s \"https://public-api.tubelab.net/v1/search/channels?query=cooking%20healthy%20recipes&subscribersFrom=10000&subscribersTo=100000&averageViewsFrom=5000\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nSorting\n\nUse sortBy and sortOrder params. Available sort fields vary by endpoint.\n\nImportant: When using query, omit sortBy to get the default relevance-based ranking. Adding a sort like sortBy=views overrides relevance and returns results ordered by that field, which usually produces worse matches. Only add sortBy when you don't use query (e.g. filter-only searches).\n\n# Filter-only search (no query) — sorting makes sense here\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?type=video&classificationQuality=positive&sortBy=views&sortOrder=desc\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nArray Parameters\n\nArray params use repeated keys:\n\n# Multiple search queries\ncurl -s \"https://public-api.tubelab.net/v1/search/channels?query=minecraft%20adventures&query=gaming%20tutorials\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nSearch Recipes\n\nReady-to-use filter combinations for common research tasks. Date filters use ISO 8601 format - compute relative dates with date or substitute directly.\n\nTip - queries: Search is semantic — longer, descriptive queries return much better results than single keywords. Use query=minecraft adventures or query=cooking healthy recipes instead of just query=minecraft or query=cooking. Think 2-4 words that describe the niche.\n\nTip - sorting: When using query, do NOT add sortBy — the default sort is by relevance and gives the best matches. Only use sortBy for filter-only searches (no query), e.g. sorting by foundAt or views.\n\nTip - averageViewsRatio: When searching outliers, prefer averageViewsRatioFrom=1 to find videos that outperformed the channel's average. A ratio of 2 means the video got 2x the channel's usual views. Values above 5 are very rare and indicate extreme virality - only use higher thresholds when you want to narrow results significantly.\n\nTip - content type: When searching outliers, prefer type=video to focus on long-form videos. Shorts tend to have inflated view counts and skew results. Only use type=short when specifically researching short-form content.\n\nProfitable channels (recently found)\n\nMonetized channels found in the last year with estimated monthly revenue above $1,000 and at least 1,000 subscribers. Sorted by discovery date.\n\nONE_YEAR_AGO=$(date -u -d \"1 year ago\" +%Y-%m-%dT00:00:00Z 2>/dev/null || date -u -v-1y +%Y-%m-%dT00:00:00Z)\ncurl -s \"https://public-api.tubelab.net/v1/search/channels?monetizationAdsense=true&revenueMonthlyEstimationFrom=1000&subscribersFrom=1000&publishedAtFrom=$ONE_YEAR_AGO&language=en&language=de&language=fr&excludeNiche=music&excludeNiche=song&excludeNiche=lofi&excludeNiche=movies&excludeNiche=kids&excludeNiche=news&excludeNiche=politic&sortBy=foundAt&size=20\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nTrending channels\n\nChannels with high engagement (avg views/subscribers ratio above 1) and at least 10,000 average views, found in the last 6 months. Good for spotting rising creators.\n\nSIX_MONTHS_AGO=$(date -u -d \"6 months ago\" +%Y-%m-%dT00:00:00Z 2>/dev/null || date -u -v-6m +%Y-%m-%dT00:00:00Z)\ncurl -s \"https://public-api.tubelab.net/v1/search/channels?avgViewsToSubscribersRatioFrom=1&averageViewsFrom=10000&subscribersFrom=100&publishedAtFrom=$SIX_MONTHS_AGO&language=en&language=de&language=fr&excludeNiche=music&excludeNiche=song&excludeNiche=lofi&excludeNiche=movies&sortBy=foundAt&size=20\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nFaceless viral videos\n\nAI-classified faceless videos with positive quality published in the last month. Useful for finding faceless niche ideas.\n\nONE_MONTH_AGO=$(date -u -d \"1 month ago\" +%Y-%m-%dT00:00:00Z 2>/dev/null || date -u -v-1m +%Y-%m-%dT00:00:00Z)\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?type=video&classificationIsFaceless=true&classificationQuality=positive&publishedAtFrom=$ONE_MONTH_AGO&size=20\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nHigh authenticity videos\n\nVideos classified as positive quality by AI. Filters out low-effort and spammy content.\n\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?type=video&classificationQuality=positive&size=20\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nMonetized channel videos\n\nOutlier videos from channels with AdSense enabled. Useful for researching niches that generate ad revenue.\n\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?type=video&channelMonetizationAdsense=true&size=20\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\"\n\nError Handling\n\nAll errors return JSON with an error object:\n\nStatus\tMeaning\tResponse\n400\tValidation error\t{ \"error\": { \"errors\": [{ \"code\": \"...\", \"message\": \"...\", \"path\": [\"param\"] }] } }\n401\tInvalid/missing API key\t{ \"error\": { \"message\": \"Unauthorized\" }, \"status\": \"error\" }\n402\tInsufficient credits\t{ \"error\": { \"message\": \"Insufficient credits\" }, \"status\": \"error\" }\n429\tRate limited\t{ \"error\": { \"message\": \"Rate limit exceeded\", \"rateLimit\": { \"limit\": 10, \"current\": 11, \"remaining\": 0 } } }\njq Recipes\n# Profitable channels: extract name, subs, revenue, and views\nONE_YEAR_AGO=$(date -u -d \"1 year ago\" +%Y-%m-%dT00:00:00Z 2>/dev/null || date -u -v-1y +%Y-%m-%dT00:00:00Z)\ncurl -s \"https://public-api.tubelab.net/v1/search/channels?monetizationAdsense=true&revenueMonthlyEstimationFrom=1000&subscribersFrom=1000&publishedAtFrom=$ONE_YEAR_AGO&sortBy=foundAt&size=10\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\" | jq '[.hits[] | {title: .snippet.title, handle: .snippet.handle, subs: .statistics.subscribers, avgViews: .statistics.averageViews}]'\n\n# Trending channels: list titles with engagement ratio\nSIX_MONTHS_AGO=$(date -u -d \"6 months ago\" +%Y-%m-%dT00:00:00Z 2>/dev/null || date -u -v-6m +%Y-%m-%dT00:00:00Z)\ncurl -s \"https://public-api.tubelab.net/v1/search/channels?avgViewsToSubscribersRatioFrom=1&averageViewsFrom=10000&subscribersFrom=100&publishedAtFrom=$SIX_MONTHS_AGO&sortBy=foundAt&size=10\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\" | jq '[.hits[] | {title: .snippet.title, subs: .statistics.subscribers, ratio: .statistics.avgViewsToSubscribersRatio}]'\n\n# Faceless viral videos: extract title, views, and z-score\nONE_MONTH_AGO=$(date -u -d \"1 month ago\" +%Y-%m-%dT00:00:00Z 2>/dev/null || date -u -v-1m +%Y-%m-%dT00:00:00Z)\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?type=video&classificationIsFaceless=true&classificationQuality=positive&publishedAtFrom=$ONE_MONTH_AGO&size=10\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\" | jq '[.hits[] | {title: .snippet.title, views: .statistics.viewCount, zScore: .statistics.zScore, channel: .snippet.channelTitle}]'\n\n# High-quality outliers: get top videos by views\ncurl -s \"https://public-api.tubelab.net/v1/search/outliers?type=video&classificationQuality=positive&sortBy=views&sortOrder=desc&size=10\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\" | jq '[.hits[] | {title: .snippet.title, views: .statistics.viewCount, channel: .snippet.channelTitle}]'\n\n# Get full transcript as plain text\ncurl -s \"https://public-api.tubelab.net/v1/video/transcript/SVeXR66hcIg\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\" | jq -r '.items[0].transcript'\n\n# Poll scan status until complete\ncurl -s \"https://public-api.tubelab.net/v1/scan/2a5e56f5-75f3-4f01-ac85-6e796f5cde87\" \\\n  -H \"Authorization: Api-Key $TUBELAB_API_KEY\" | jq '{status: .status, endedAt: .endedAt}'"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/antoniojps/tubelab-api",
    "publisherUrl": "https://clawhub.ai/antoniojps/tubelab-api",
    "owner": "antoniojps",
    "version": "1.0.4",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/tubelab-api",
    "downloadUrl": "https://openagent3.xyz/downloads/tubelab-api",
    "agentUrl": "https://openagent3.xyz/skills/tubelab-api/agent",
    "manifestUrl": "https://openagent3.xyz/skills/tubelab-api/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/tubelab-api/agent.md"
  }
}