YouTube Shorts Metadata Extractor for Channels & Hashtags

{
  "properties": {
    "channelUrls": {
      "default": [
        "https://www.youtube.com/@MrBeast"
      ],
      "description": "YouTube channel URLs, handles (@username), or channel IDs (UCxxx). Required when inputMode is 'channel'.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [
        "https://www.youtube.com/@MrBeast"
      ],
      "title": "Channel URLs",
      "type": "array"
    },
    "hashtags": {
      "description": "Hashtags to scrape Shorts from (e.g. #cooking, sports). Required when inputMode is 'hashtag'. Include or omit the # prefix.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [
        "#shorts"
      ],
      "title": "Hashtags",
      "type": "array"
    },
    "includeDetails": {
      "default": true,
      "description": "Visit each Short's page for exact views, likes, comment count, publish date, duration, category, sound and captions. Turn off for a faster, cheaper listing-only run (views as displayed, no likes or dates).",
      "prefill": true,
      "title": "Include Exact Details",
      "type": "boolean"
    },
    "includeMembersOnly": {
      "default": false,
      "description": "Channel mode only. Also collect members-only Shorts when YouTube offers the 'Members only' filter on that channel's Shorts tab (a gradual rollout — the actor retries the tab a few times and notes it in the status message when unavailable). Member rows count toward maxShorts and cost up to two player requests each.",
      "prefill": false,
      "title": "Include Members-Only Shorts",
      "type": "boolean"
    },
    "inputMode": {
      "default": "channel",
      "description": "Where to find Shorts. 'channel' reads a channel's Shorts tab, 'hashtag' a hashtag's Shorts feed, 'search' YouTube search results filtered to Shorts, 'direct' specific Shorts URLs or video IDs, 'sound' finds other Shorts that use the same sound as seed Shorts.",
      "enum": [
        "channel",
        "hashtag",
        "search",
        "direct",
        "sound"
      ],
      "enumTitles": [
        "Channel Shorts Tab",
        "Hashtag Shorts",
        "Keyword Search",
        "Direct Shorts URLs",
        "Shorts by Sound"
      ],
      "title": "Input Mode",
      "type": "string"
    },
    "market": {
      "default": "US",
      "description": "YouTube market/region for localized content. Affects the language of metadata returned.",
      "editor": "select",
      "enum": [
        "US",
        "GB",
        "CA",
        "AU",
        "DE",
        "FR",
        "JP",
        "KR",
        "BR",
        "IN",
        "MX",
        "IT",
        "ES",
        "NL",
        "PL",
        "RU",
        "SE",
        "NO",
        "DK",
        "FI",
        "ZA",
        "SG",
        "HK",
        "TW",
        "ID",
        "MY",
        "TH",
        "PH",
        "AR",
        "CO",
        "CL"
      ],
      "enumTitles": [
        "United States",
        "United Kingdom",
        "Canada",
        "Australia",
        "Germany",
        "France",
        "Japan",
        "South Korea",
        "Brazil",
        "India",
        "Mexico",
        "Italy",
        "Spain",
        "Netherlands",
        "Poland",
        "Russia",
        "Sweden",
        "Norway",
        "Denmark",
        "Finland",
        "South Africa",
        "Singapore",
        "Hong Kong",
        "Taiwan",
        "Indonesia",
        "Malaysia",
        "Thailand",
        "Philippines",
        "Argentina",
        "Colombia",
        "Chile"
      ],
      "title": "Market / Region",
      "type": "string"
    },
    "maxShorts": {
      "default": 3,
      "description": "Maximum number of Shorts to return per channel, hashtag or search query (per run in direct mode).",
      "editor": "number",
      "maximum": 10000,
      "minimum": 1,
      "prefill": 3,
      "title": "Max Shorts Per Source",
      "type": "integer"
    },
    "oldestPostDate": {
      "description": "Only include Shorts published on or after this date. Format: YYYY-MM-DD. Leave empty to include all. Works in channel, search and direct modes; hashtag mode needs 'Include Exact Details' because dates come from each Short's page.",
      "editor": "textfield",
      "nullable": true,
      "prefill": "",
      "title": "Oldest Post Date",
      "type": "string"
    },
    "searchQueries": {
      "description": "Keywords to search on YouTube, keeping only Shorts results. Required when inputMode is 'search'.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [
        "cooking shorts"
      ],
      "title": "Search Queries",
      "type": "array"
    },
    "shortUrls": {
      "default": [
        "https://www.youtube.com/shorts/pfUG56htjBc"
      ],
      "description": "Shorts URLs, youtu.be links, watch URLs, or 11-character video IDs. Required when inputMode is 'direct'; used as the sound seeds when inputMode is 'sound'.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [
        "https://www.youtube.com/shorts/pfUG56htjBc"
      ],
      "title": "Shorts URLs or IDs",
      "type": "array"
    },
    "sortShortsBy": {
      "default": "newest",
      "description": "Order of the channel's Shorts tab, matching the buttons YouTube shows: newest first (default), most popular, or oldest first. Falls back to newest when a channel does not offer the chosen order.",
      "editor": "select",
      "enum": [
        "newest",
        "popular",
        "oldest"
      ],
      "enumTitles": [
        "Newest first",
        "Most popular",
        "Oldest first"
      ],
      "prefill": "newest",
      "title": "Sort Shorts By",
      "type": "string"
    }
  },
  "required": [],
  "schemaVersion": 1,
  "title": "YouTube Shorts Scraper Input",
  "type": "object"
}

{
  "actorOutputSchemaVersion": 1,
  "description": "YouTube Shorts with exact view, like, comment, date, duration, category and sound metadata, scraped by channel, hashtag, keyword search or direct URL.",
  "properties": {
    "shorts": {
      "description": "Dataset containing all scraped Shorts with exact engagement metrics, dates and channel metadata.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "YouTube Shorts Metadata Extractor dataset",
      "type": "string"
    }
  },
  "title": "YouTube Shorts Metadata Extractor for Channels & Hashtags Output"
}

{
  "actorSpecification": 1,
  "views": {
    "detailed": {
      "display": {
        "component": "table",
        "properties": {
          "captionLanguages": {
            "format": "array",
            "label": "Captions"
          },
          "category": {
            "format": "text",
            "label": "Category"
          },
          "channelAvatarUrl": {
            "format": "link",
            "label": "Avatar"
          },
          "channelBannerUrl": {
            "format": "link",
            "label": "Banner"
          },
          "channelDescription": {
            "format": "text",
            "label": "Channel Desc"
          },
          "channelId": {
            "format": "text",
            "label": "Channel ID"
          },
          "channelJoinedDate": {
            "format": "text",
            "label": "Joined"
          },
          "channelLocation": {
            "format": "text",
            "label": "Channel Location"
          },
          "channelName": {
            "format": "text",
            "label": "Channel"
          },
          "channelTotalVideos": {
            "format": "number",
            "label": "Total Videos"
          },
          "channelTotalViews": {
            "format": "number",
            "label": "Total Views"
          },
          "channelUrl": {
            "format": "link",
            "label": "Channel URL"
          },
          "channelUsername": {
            "format": "text",
            "label": "Username"
          },
          "commentsCount": {
            "format": "number",
            "label": "Comments"
          },
          "commentsTurnedOff": {
            "format": "boolean",
            "label": "Comments Off"
          },
          "duration": {
            "format": "text",
            "label": "Duration"
          },
          "durationSeconds": {
            "format": "number",
            "label": "Duration (sec)"
          },
          "hashtags": {
            "format": "array",
            "label": "Hashtags"
          },
          "inputChannelUrl": {
            "format": "text",
            "label": "Input URL"
          },
          "isChannelVerified": {
            "format": "boolean",
            "label": "Verified"
          },
          "isMembersOnly": {
            "format": "boolean",
            "label": "Members Only"
          },
          "likes": {
            "format": "number",
            "label": "Likes"
          },
          "matchedSoundTitle": {
            "format": "text",
            "label": "Matched Sound"
          },
          "numberOfSubscribers": {
            "format": "number",
            "label": "Subscribers"
          },
          "order": {
            "format": "number",
            "label": "Order"
          },
          "publishDate": {
            "format": "text",
            "label": "Published"
          },
          "scrapedAt": {
            "format": "text",
            "label": "Scraped At"
          },
          "soundTitle": {
            "format": "text",
            "label": "Sound"
          },
          "source": {
            "format": "text",
            "label": "Source"
          },
          "sourceType": {
            "format": "text",
            "label": "Source Type"
          },
          "thumbnailUrl": {
            "format": "link",
            "label": "Thumbnail"
          },
          "title": {
            "format": "text",
            "label": "Title"
          },
          "type": {
            "format": "text",
            "label": "Type"
          },
          "uploadDate": {
            "format": "text",
            "label": "Uploaded (UTC)"
          },
          "url": {
            "format": "link",
            "label": "URL"
          },
          "videoId": {
            "format": "text",
            "label": "Video ID"
          },
          "viewCount": {
            "format": "number",
            "label": "Views"
          },
          "viewCountText": {
            "format": "text",
            "label": "Views (text)"
          }
        }
      },
      "title": "Detailed",
      "transformation": {
        "fields": [
          "title",
          "type",
          "videoId",
          "url",
          "thumbnailUrl",
          "viewCount",
          "viewCountText",
          "likes",
          "commentsCount",
          "duration",
          "durationSeconds",
          "publishDate",
          "uploadDate",
          "category",
          "soundTitle",
          "matchedSoundTitle",
          "captionLanguages",
          "hashtags",
          "channelName",
          "channelUrl",
          "channelId",
          "channelUsername",
          "channelDescription",
          "channelJoinedDate",
          "channelLocation",
          "channelAvatarUrl",
          "channelBannerUrl",
          "channelTotalVideos",
          "channelTotalViews",
          "numberOfSubscribers",
          "isChannelVerified",
          "isMembersOnly",
          "inputChannelUrl",
          "sourceType",
          "source",
          "order",
          "commentsTurnedOff",
          "scrapedAt"
        ]
      }
    },
    "overview": {
      "display": {
        "component": "table",
        "properties": {
          "channelId": {
            "format": "text",
            "label": "Channel ID"
          },
          "channelName": {
            "format": "text",
            "label": "Channel"
          },
          "duration": {
            "format": "text",
            "label": "Duration"
          },
          "hashtags": {
            "format": "array",
            "label": "Hashtags"
          },
          "likes": {
            "format": "number",
            "label": "Likes"
          },
          "scrapedAt": {
            "format": "text",
            "label": "Scraped At"
          },
          "soundTitle": {
            "format": "text",
            "label": "Sound"
          },
          "title": {
            "format": "text",
            "label": "Title"
          },
          "type": {
            "format": "text",
            "label": "Type"
          },
          "uploadDate": {
            "format": "text",
            "label": "Uploaded"
          },
          "url": {
            "format": "link",
            "label": "URL"
          },
          "videoId": {
            "format": "text",
            "label": "Video ID"
          },
          "viewCount": {
            "format": "number",
            "label": "Views"
          }
        }
      },
      "title": "Overview",
      "transformation": {
        "fields": [
          "title",
          "type",
          "videoId",
          "viewCount",
          "likes",
          "duration",
          "uploadDate",
          "url",
          "hashtags",
          "soundTitle",
          "channelName",
          "channelId",
          "scrapedAt"
        ]
      }
    }
  }
}