{
  "description": "Collect TikTok's ranked trending hashtags and trending videos by market, time window and industry, with post/view counts, popularity curves, momentum signals, creator leaders and video engagement metrics. No login, cookies or proxy setup.",
  "properties": {
    "countries": {
      "default": [
        "US"
      ],
      "description": "(mode=trendingHashtags) One or more markets to read the hashtag chart for. Each market adds its own ranked rows.",
      "editor": "select",
      "items": {
        "enum": [
          "US",
          "GB",
          "CA",
          "AU",
          "DE",
          "FR",
          "IT",
          "ES",
          "BR",
          "MX",
          "AR",
          "CO",
          "JP",
          "KR",
          "ID",
          "MY",
          "PH",
          "SG",
          "TH",
          "VN",
          "TW",
          "TR",
          "SA",
          "AE",
          "IL",
          "EG",
          "ZA"
        ],
        "enumTitles": [
          "United States",
          "United Kingdom",
          "Canada",
          "Australia",
          "Germany",
          "France",
          "Italy",
          "Spain",
          "Brazil",
          "Mexico",
          "Argentina",
          "Colombia",
          "Japan",
          "South Korea",
          "Indonesia",
          "Malaysia",
          "Philippines",
          "Singapore",
          "Thailand",
          "Vietnam",
          "Taiwan",
          "Turkey",
          "Saudi Arabia",
          "United Arab Emirates",
          "Israel",
          "Egypt",
          "South Africa"
        ],
        "type": "string"
      },
      "prefill": [
        "US"
      ],
      "title": "Markets",
      "type": "array"
    },
    "includeCreatorLeaders": {
      "default": false,
      "description": "(mode=trendingHashtags) Add creator rows that aggregate the creators TikTok credits across the collected hashtags, sorted by how many trends they appear in.",
      "prefill": false,
      "title": "Add Creator Leaderboard",
      "type": "boolean"
    },
    "includeOverallRanking": {
      "default": true,
      "description": "(mode=trendingHashtags) Include each market's overall top-3 hashtag chart. Turn off to read only the industry charts selected below.",
      "prefill": true,
      "title": "Include Overall Chart",
      "type": "boolean"
    },
    "includeTopComments": {
      "default": false,
      "description": "(mode=trendingVideos) Add each video's top comments and comment keywords. Each video's comments are read separately (up to 100 videos per run).",
      "prefill": false,
      "title": "Include Top Comments",
      "type": "boolean"
    },
    "industries": {
      "default": [],
      "description": "(mode=trendingHashtags) Specific industry charts to read when 'Scan all industries' is off. Ignored when scanning all industries. 19 public categories are available.",
      "editor": "select",
      "items": {
        "enum": [
          "10000000000",
          "11000000000",
          "12000000000",
          "13000000000",
          "14000000000",
          "15000000000",
          "16000000000",
          "17000000000",
          "18000000000",
          "19000000000",
          "20000000000",
          "21000000000",
          "22000000000",
          "23000000000",
          "24000000000",
          "25000000000",
          "27000000000",
          "28000000000",
          "29000000000"
        ],
        "enumTitles": [
          "Education",
          "Vehicle & Transportation",
          "Baby, Kids & Maternity",
          "Financial Services",
          "Beauty & Personal Care",
          "Tech & Electronics",
          "Appliances",
          "Travel",
          "Household Products",
          "Pets",
          "Apps",
          "Home Improvement",
          "Apparel & Accessories",
          "News & Entertainment",
          "Business Services",
          "Games",
          "Food & Beverage",
          "Sports & Outdoor",
          "Health"
        ],
        "type": "string"
      },
      "prefill": [],
      "title": "Industry Charts",
      "type": "array"
    },
    "maxItems": {
      "default": 1000,
      "description": "Maximum number of data rows to write per run. Creator rows are not counted.",
      "maximum": 5000,
      "minimum": 1,
      "prefill": 10,
      "title": "Maximum Rows",
      "type": "integer"
    },
    "minHashtagAppearances": {
      "default": 2,
      "description": "(mode=trendingHashtags, creator leaderboard only) Only list creators credited on at least this many collected hashtag rows.",
      "maximum": 10,
      "minimum": 1,
      "prefill": 2,
      "title": "Minimum Trend Appearances",
      "type": "integer"
    },
    "mode": {
      "default": "trendingHashtags",
      "description": "Choose 'Trending hashtags' for TikTok's ranked hashtag charts (post/view counts, popularity curve, creators) or 'Trending videos' for TikTok's ranked video charts (views, engagement, author stats).",
      "editor": "select",
      "enum": [
        "trendingHashtags",
        "trendingVideos"
      ],
      "enumTitles": [
        "Trending hashtags",
        "Trending videos"
      ],
      "prefill": "trendingHashtags",
      "title": "What to collect",
      "type": "string"
    },
    "periods": {
      "default": [
        "7"
      ],
      "description": "(mode=trendingHashtags) Lookback windows in days. 7 shows recent spikes, 90 shows longer-term trends. Select one or more.",
      "editor": "select",
      "items": {
        "enum": [
          "7",
          "30",
          "90"
        ],
        "enumTitles": [
          "Last 7 days",
          "Last 30 days",
          "Last 90 days"
        ],
        "type": "string"
      },
      "prefill": [
        "7"
      ],
      "title": "Time Windows",
      "type": "array"
    },
    "scanAllIndustries": {
      "default": true,
      "description": "(mode=trendingHashtags) Read all 19 industry charts for every market and window. This widens coverage from 3 to up to 60 hashtags per market and window, because each industry chart is read separately.",
      "prefill": false,
      "title": "Scan All Industries",
      "type": "boolean"
    },
    "videoContentTags": {
      "default": [],
      "description": "(mode=trendingVideos) Query TikTok's video ranking by content tag and dedupe the videos. Each selected tag is a separate ranking read; 'All tags' also includes the unfiltered chart, returning up to ~24 videos per market, window and sort instead of 4. Leave empty for the current unfiltered ranking.",
      "editor": "select",
      "items": {
        "enum": [
          "all",
          "11002",
          "11003",
          "11010",
          "11013",
          "11015"
        ],
        "enumTitles": [
          "All tags (unfiltered + 5 tags)",
          "Beauty & Care",
          "Fashion",
          "Food & Beverage",
          "Lifestyle & Leisure",
          "Technology & Finance"
        ],
        "type": "string"
      },
      "prefill": [],
      "title": "Video Content Tags",
      "type": "array"
    },
    "videoCountries": {
      "default": [
        "US"
      ],
      "description": "(mode=trendingVideos) Markets with a public TikTok trending-video chart. Select one or more.",
      "editor": "select",
      "items": {
        "enum": [
          "US",
          "JP",
          "VN",
          "TH",
          "ID"
        ],
        "enumTitles": [
          "United States",
          "Japan",
          "Vietnam",
          "Thailand",
          "Indonesia"
        ],
        "type": "string"
      },
      "prefill": [
        "US"
      ],
      "title": "Video Markets",
      "type": "array"
    },
    "videoOrganicOnly": {
      "default": false,
      "description": "(mode=trendingVideos) Rank only organic (non-promoted) videos. TikTok returns a different ranking for organic-only charts.",
      "prefill": false,
      "title": "Organic Videos Only",
      "type": "boolean"
    },
    "videoPeriods": {
      "default": [
        "7"
      ],
      "description": "(mode=trendingVideos) Windows in days for the trending-video chart: 7 for videos created in the last week, 30 for the last month.",
      "editor": "select",
      "items": {
        "enum": [
          "7",
          "30"
        ],
        "enumTitles": [
          "Last 7 days",
          "Last 30 days"
        ],
        "type": "string"
      },
      "prefill": [
        "7"
      ],
      "title": "Video Time Windows",
      "type": "array"
    },
    "videoSortBy": {
      "default": "views",
      "description": "(mode=trendingVideos) Metric used for the video ranking.",
      "editor": "select",
      "enum": [
        "views",
        "engagementRate",
        "sixSecondViewRate"
      ],
      "enumTitles": [
        "Video views",
        "Engagement rate",
        "6-second view-through rate"
      ],
      "prefill": "views",
      "title": "Rank Videos By",
      "type": "string"
    },
    "weeksBack": {
      "default": 0,
      "description": "(mode=trendingVideos) Add past weekly rankings by moving the chart end date back 7 days per step (0-4). Useful for comparing this week with earlier weeks.",
      "maximum": 4,
      "minimum": 0,
      "prefill": 0,
      "title": "Extra Weekly Windows",
      "type": "integer"
    }
  },
  "required": [],
  "schemaVersion": 1,
  "title": "TikTok Hashtag Momentum & Top Creator Tracker Input",
  "type": "object"
}