YouTube Trending Feed Extractor by Category & Market

{
  "description": "Read YouTube Charts or category hubs for one or more countries, with optional exact video details.",
  "properties": {
    "categories": {
      "default": [
        "gaming"
      ],
      "description": "One or more category pages. Gaming trending and Gaming live return up to 50 videos. News reads the selected news sections. Sports, Learning and Courses are editorial category feeds.",
      "editor": "select",
      "items": {
        "enum": [
          "gaming",
          "gamingLive",
          "news",
          "sports",
          "learning",
          "courses"
        ],
        "enumTitles": [
          "Gaming trending",
          "Gaming live",
          "News",
          "Sports",
          "Learning",
          "Courses"
        ],
        "type": "string"
      },
      "minItems": 1,
      "prefill": [
        "gaming"
      ],
      "title": "Category hubs (mode=hubs)",
      "type": "array",
      "uniqueItems": true
    },
    "charts": {
      "default": [
        "trendingVideos"
      ],
      "description": "One or more YouTube charts. Trending music videos is the official replacement for the retired general Trending page. Top songs and top artists are weekly; Shorts songs is daily or weekly. Music and Shorts charts include rank movement and optional history.",
      "editor": "select",
      "items": {
        "enum": [
          "trendingVideos",
          "topVideos",
          "topSongs",
          "topArtists",
          "shortsSongs",
          "movieTrailers",
          "podcasts"
        ],
        "enumTitles": [
          "Trending music videos (current)",
          "Top music videos (daily or weekly)",
          "Top songs (weekly)",
          "Top artists (weekly)",
          "Top songs in Shorts (daily or weekly)",
          "Trending movie trailers (current)",
          "Podcast shows (weekly)"
        ],
        "type": "string"
      },
      "minItems": 1,
      "prefill": [
        "trendingVideos"
      ],
      "title": "Charts (mode=charts)",
      "type": "array",
      "uniqueItems": true
    },
    "countries": {
      "default": [
        "US"
      ],
      "description": "One or more markets. The 68 YouTube Charts markets are supported; 'global' is supported only for charts that publish a global ranking (top videos, top songs, top artists, Shorts songs).",
      "editor": "select",
      "items": {
        "enum": [
          "AR",
          "AU",
          "AT",
          "BE",
          "BO",
          "BR",
          "CA",
          "CL",
          "CO",
          "CR",
          "CZ",
          "DK",
          "DO",
          "EC",
          "EG",
          "SV",
          "EE",
          "FI",
          "FR",
          "DE",
          "GT",
          "HN",
          "HK",
          "HU",
          "IS",
          "IN",
          "ID",
          "IE",
          "IL",
          "IT",
          "JP",
          "KE",
          "LU",
          "MY",
          "MX",
          "NL",
          "NZ",
          "NI",
          "NG",
          "NO",
          "PA",
          "PY",
          "PE",
          "PH",
          "PL",
          "PT",
          "RO",
          "RU",
          "SA",
          "RS",
          "SG",
          "ZA",
          "KR",
          "ES",
          "SE",
          "CH",
          "TW",
          "TZ",
          "TH",
          "TR",
          "UG",
          "UA",
          "AE",
          "GB",
          "US",
          "UY",
          "VN",
          "ZW",
          "global"
        ],
        "enumTitles": [
          "Argentina",
          "Australia",
          "Austria",
          "Belgium",
          "Bolivia",
          "Brazil",
          "Canada",
          "Chile",
          "Colombia",
          "Costa Rica",
          "Czechia",
          "Denmark",
          "Dominican Republic",
          "Ecuador",
          "Egypt",
          "El Salvador",
          "Estonia",
          "Finland",
          "France",
          "Germany",
          "Guatemala",
          "Honduras",
          "Hong Kong",
          "Hungary",
          "Iceland",
          "India",
          "Indonesia",
          "Ireland",
          "Israel",
          "Italy",
          "Japan",
          "Kenya",
          "Luxembourg",
          "Malaysia",
          "Mexico",
          "Netherlands",
          "New Zealand",
          "Nicaragua",
          "Nigeria",
          "Norway",
          "Panama",
          "Paraguay",
          "Peru",
          "Philippines",
          "Poland",
          "Portugal",
          "Romania",
          "Russia",
          "Saudi Arabia",
          "Serbia",
          "Singapore",
          "South Africa",
          "South Korea",
          "Spain",
          "Sweden",
          "Switzerland",
          "Taiwan",
          "Tanzania",
          "Thailand",
          "Turkey",
          "Uganda",
          "Ukraine",
          "United Arab Emirates",
          "United Kingdom",
          "United States",
          "Uruguay",
          "Vietnam",
          "Zimbabwe",
          "Global"
        ],
        "type": "string"
      },
      "minItems": 1,
      "prefill": [
        "US"
      ],
      "title": "Countries",
      "type": "array",
      "uniqueItems": true
    },
    "date": {
      "default": "",
      "description": "Historical chart date in YYYY-MM-DD format. Leave empty for the latest chart. Supported by Top music videos, Top songs, Top artists and Shorts songs; current-only charts ignore it.",
      "editor": "textfield",
      "prefill": "",
      "title": "Chart date (mode=charts)",
      "type": "string"
    },
    "includeVideoDetails": {
      "default": true,
      "description": "Fetch exact lifetime views, likes, upload dates and descriptions for every video. YouTube category, tags, Shorts eligibility and family-safe flags are filled when YouTube's player response is available and may be omitted on some cloud IPs. Adds one or more detail requests per video.",
      "prefill": false,
      "title": "Include exact video details",
      "type": "boolean"
    },
    "maxConcurrency": {
      "default": 5,
      "description": "How many exact-detail requests may run in parallel.",
      "maximum": 10,
      "minimum": 1,
      "prefill": 3,
      "title": "Detail concurrency",
      "type": "integer"
    },
    "maxItems": {
      "default": 100,
      "description": "Total data rows to return across all charts, categories and countries.",
      "maximum": 10000,
      "minimum": 1,
      "prefill": 3,
      "title": "Max items",
      "type": "integer"
    },
    "maxItemsPerChart": {
      "default": 100,
      "description": "Rows to take from each chart/country or category/country combination. Source ceilings still apply.",
      "maximum": 100,
      "minimum": 1,
      "prefill": 3,
      "title": "Max items per chart or feed",
      "type": "integer"
    },
    "mode": {
      "default": "charts",
      "description": "What to read. 'charts' uses YouTube's official music, trailer and podcast charts. 'hubs' uses YouTube's category pages such as Gaming trending, News, Sports, Learning and Courses.",
      "editor": "select",
      "enum": [
        "charts",
        "hubs"
      ],
      "enumTitles": [
        "YouTube Charts",
        "Category hubs"
      ],
      "prefill": "charts",
      "title": "Mode",
      "type": "string"
    },
    "monitorName": {
      "default": "default",
      "description": "Separate only-new histories by monitor name.",
      "editor": "textfield",
      "prefill": "default",
      "title": "Monitor name",
      "type": "string"
    },
    "newsSections": {
      "default": [
        "top"
      ],
      "description": "Which News tabs to read. 'Top stories' is the main /news page; the other sections are direct news-destination feeds. Available sections vary by country.",
      "editor": "select",
      "items": {
        "enum": [
          "top",
          "sports",
          "entertainment",
          "business",
          "world",
          "national",
          "health",
          "technology"
        ],
        "enumTitles": [
          "Top stories",
          "Sports",
          "Entertainment",
          "Business",
          "World",
          "National",
          "Health",
          "Technology"
        ],
        "type": "string"
      },
      "minItems": 1,
      "prefill": [
        "top"
      ],
      "title": "News sections (mode=hubs, categories includes news)",
      "type": "array",
      "uniqueItems": true
    },
    "onlyNew": {
      "default": false,
      "description": "Skip rows already emitted by a previous run with the same monitor name.",
      "prefill": false,
      "title": "Only new items",
      "type": "boolean"
    },
    "period": {
      "default": "daily",
      "description": "Daily or weekly ranking. Weekly-only charts automatically use weekly. Current-only charts such as Trending music videos and Trending movie trailers ignore this setting.",
      "editor": "select",
      "enum": [
        "daily",
        "weekly"
      ],
      "enumTitles": [
        "Daily",
        "Weekly"
      ],
      "prefill": "daily",
      "title": "Chart period (mode=charts)",
      "type": "string"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "YouTube Trending Feed Extractor Input",
  "type": "object"
}

{
  "actorOutputSchemaVersion": 1,
  "description": "Ranked YouTube chart entries and category-hub videos with rank movement, exact video details and status rows.",
  "properties": {
    "videos": {
      "description": "Dataset containing chart entries, category-hub videos and status rows.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "YouTube Trending Feed Extractor dataset",
      "type": "string"
    }
  },
  "title": "YouTube Trending Feed Extractor by Category & Market Output"
}

{
  "actorSpecification": 1,
  "views": {
    "full": {
      "display": {
        "component": "table",
        "properties": {
          "artistId": {
            "format": "text",
            "label": "Artist ID"
          },
          "category": {
            "format": "text",
            "label": "Category"
          },
          "channelHandle": {
            "format": "text",
            "label": "Handle"
          },
          "channelId": {
            "format": "text",
            "label": "Channel ID"
          },
          "channelName": {
            "format": "text",
            "label": "Channel"
          },
          "channelUrl": {
            "format": "link",
            "label": "Channel URL"
          },
          "chartDate": {
            "format": "text",
            "label": "Chart Date"
          },
          "chartPeriod": {
            "format": "text",
            "label": "Period"
          },
          "chartType": {
            "format": "text",
            "label": "Chart"
          },
          "chartViewCount": {
            "format": "number",
            "label": "Chart Views"
          },
          "commentCount": {
            "format": "number",
            "label": "Comments"
          },
          "countryCode": {
            "format": "text",
            "label": "Country"
          },
          "durationSeconds": {
            "format": "number",
            "label": "Duration (s)"
          },
          "durationText": {
            "format": "text",
            "label": "Duration"
          },
          "isLive": {
            "format": "boolean",
            "label": "Live"
          },
          "isShortsEligible": {
            "format": "boolean",
            "label": "Shorts Eligible"
          },
          "isVerified": {
            "format": "boolean",
            "label": "Verified"
          },
          "likeCount": {
            "format": "number",
            "label": "Likes"
          },
          "market": {
            "format": "text",
            "label": "Market"
          },
          "message": {
            "format": "text",
            "label": "Message"
          },
          "playlistId": {
            "format": "text",
            "label": "Playlist ID"
          },
          "position": {
            "format": "number",
            "label": "#"
          },
          "publishedDate": {
            "format": "text",
            "label": "Published Date"
          },
          "publishedTimeText": {
            "format": "text",
            "label": "Published"
          },
          "rankSource": {
            "format": "text",
            "label": "Rank Source"
          },
          "recordType": {
            "format": "text",
            "label": "Record"
          },
          "scrapedAt": {
            "format": "text",
            "label": "Scraped At"
          },
          "sourceName": {
            "format": "text",
            "label": "Source"
          },
          "sourceType": {
            "format": "text",
            "label": "Source Type"
          },
          "status": {
            "format": "text",
            "label": "Status"
          },
          "subscriberCount": {
            "format": "number",
            "label": "Subscribers"
          },
          "subscriberCountText": {
            "format": "text",
            "label": "Subscribers Text"
          },
          "thumbnailUrl": {
            "format": "link",
            "label": "Thumbnail"
          },
          "title": {
            "format": "text",
            "label": "Title"
          },
          "trackId": {
            "format": "text",
            "label": "Track ID"
          },
          "type": {
            "format": "text",
            "label": "Type"
          },
          "url": {
            "format": "link",
            "label": "URL"
          },
          "videoId": {
            "format": "text",
            "label": "Video ID"
          },
          "viewCount": {
            "format": "number",
            "label": "Lifetime Views"
          },
          "viewCountText": {
            "format": "text",
            "label": "Views Text"
          },
          "viewsPerHour": {
            "format": "number",
            "label": "Views / Hour"
          }
        }
      },
      "title": "Full Details",
      "transformation": {
        "fields": [
          "position",
          "recordType",
          "type",
          "videoId",
          "trackId",
          "artistId",
          "playlistId",
          "title",
          "url",
          "channelName",
          "channelId",
          "channelUrl",
          "channelHandle",
          "channelAvatarUrl",
          "isVerified",
          "viewCount",
          "viewCountText",
          "likeCount",
          "commentCount",
          "subscriberCount",
          "subscriberCountText",
          "chartViewCount",
          "publishedTimeText",
          "publishedDate",
          "durationText",
          "durationSeconds",
          "thumbnailUrl",
          "thumbnails",
          "badges",
          "isLive",
          "liveStatus",
          "scheduledStartTime",
          "isShortsEligible",
          "isFamilySafe",
          "viewsPerHour",
          "description",
          "keywords",
          "youtubeCategory",
          "artists",
          "songwriters",
          "producers",
          "label",
          "releaseDate",
          "primaryGenre",
          "numEpisodes",
          "lastUpdatedDate",
          "previousPosition",
          "rankChange",
          "periodsOnChart",
          "viewsChangePercent",
          "isNewEntry",
          "chartDate",
          "chartType",
          "chartPeriod",
          "period",
          "date",
          "countryCode",
          "countryName",
          "category",
          "market",
          "sourceType",
          "sourceName",
          "sourceUrl",
          "rankSource",
          "fallbackQuery",
          "status",
          "message",
          "mode",
          "resultCount",
          "scrapedAt"
        ]
      }
    },
    "overview": {
      "display": {
        "component": "table",
        "properties": {
          "channelName": {
            "format": "text",
            "label": "Channel"
          },
          "chartType": {
            "format": "text",
            "label": "Chart"
          },
          "chartViewCount": {
            "format": "number",
            "label": "Chart Views"
          },
          "countryCode": {
            "format": "text",
            "label": "Country"
          },
          "position": {
            "format": "number",
            "label": "#"
          },
          "sourceName": {
            "format": "text",
            "label": "Source"
          },
          "status": {
            "format": "text",
            "label": "Status"
          },
          "title": {
            "format": "text",
            "label": "Title"
          },
          "type": {
            "format": "text",
            "label": "Type"
          },
          "url": {
            "format": "link",
            "label": "URL"
          },
          "viewCount": {
            "format": "number",
            "label": "Lifetime Views"
          }
        }
      },
      "title": "Trending Overview",
      "transformation": {
        "fields": [
          "position",
          "sourceName",
          "title",
          "channelName",
          "chartViewCount",
          "viewCount",
          "countryCode",
          "chartType",
          "type",
          "url",
          "status"
        ]
      }
    }
  }
}