{
  "title": "TikTok Hashtag Momentum & Top Creator Tracker Input",
  "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.",
  "type": "object",
  "schemaVersion": 1,
  "properties": {
    "mode": {
      "title": "What to collect",
      "type": "string",
      "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"
      ],
      "default": "trendingHashtags",
      "prefill": "trendingHashtags"
    },
    "countries": {
      "title": "Markets",
      "type": "array",
      "description": "(mode=trendingHashtags) One or more markets to read the hashtag chart for. Each market adds its own ranked rows.",
      "editor": "select",
      "items": {
        "type": "string",
        "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"
        ]
      },
      "default": [
        "US"
      ],
      "prefill": [
        "US"
      ]
    },
    "periods": {
      "title": "Time Windows",
      "type": "array",
      "description": "(mode=trendingHashtags) Lookback windows in days. 7 shows recent spikes, 90 shows longer-term trends. Select one or more.",
      "editor": "select",
      "items": {
        "type": "string",
        "enum": [
          "7",
          "30",
          "90"
        ],
        "enumTitles": [
          "Last 7 days",
          "Last 30 days",
          "Last 90 days"
        ]
      },
      "default": [
        "7"
      ],
      "prefill": [
        "7"
      ]
    },
    "includeOverallRanking": {
      "title": "Include Overall Chart",
      "type": "boolean",
      "description": "(mode=trendingHashtags) Include each market's overall top-3 hashtag chart. Turn off to read only the industry charts selected below.",
      "default": true,
      "prefill": true
    },
    "scanAllIndustries": {
      "title": "Scan All Industries",
      "type": "boolean",
      "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.",
      "default": true,
      "prefill": false
    },
    "industries": {
      "title": "Industry Charts",
      "type": "array",
      "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": {
        "type": "string",
        "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"
        ]
      },
      "default": [],
      "prefill": []
    },
    "includeCreatorLeaders": {
      "title": "Add Creator Leaderboard",
      "type": "boolean",
      "description": "(mode=trendingHashtags) Add creator rows that aggregate the creators TikTok credits across the collected hashtags, sorted by how many trends they appear in.",
      "default": false,
      "prefill": false
    },
    "minHashtagAppearances": {
      "title": "Minimum Trend Appearances",
      "type": "integer",
      "description": "(mode=trendingHashtags, creator leaderboard only) Only list creators credited on at least this many collected hashtag rows.",
      "default": 2,
      "minimum": 1,
      "maximum": 10,
      "prefill": 2
    },
    "videoCountries": {
      "title": "Video Markets",
      "type": "array",
      "description": "(mode=trendingVideos) Markets with a public TikTok trending-video chart. Select one or more.",
      "editor": "select",
      "items": {
        "type": "string",
        "enum": [
          "US",
          "JP",
          "VN",
          "TH",
          "ID"
        ],
        "enumTitles": [
          "United States",
          "Japan",
          "Vietnam",
          "Thailand",
          "Indonesia"
        ]
      },
      "default": [
        "US"
      ],
      "prefill": [
        "US"
      ]
    },
    "videoPeriods": {
      "title": "Video Time Windows",
      "type": "array",
      "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": {
        "type": "string",
        "enum": [
          "7",
          "30"
        ],
        "enumTitles": [
          "Last 7 days",
          "Last 30 days"
        ]
      },
      "default": [
        "7"
      ],
      "prefill": [
        "7"
      ]
    },
    "videoSortBy": {
      "title": "Rank Videos By",
      "type": "string",
      "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"
      ],
      "default": "views",
      "prefill": "views"
    },
    "videoOrganicOnly": {
      "title": "Organic Videos Only",
      "type": "boolean",
      "description": "(mode=trendingVideos) Rank only organic (non-promoted) videos. TikTok returns a different ranking for organic-only charts.",
      "default": false,
      "prefill": false
    },
    "videoContentTags": {
      "title": "Video Content Tags",
      "type": "array",
      "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": {
        "type": "string",
        "enum": [
          "all",
          "11002",
          "11003",
          "11010",
          "11013",
          "11015"
        ],
        "enumTitles": [
          "All tags (unfiltered + 5 tags)",
          "Beauty & Care",
          "Fashion",
          "Food & Beverage",
          "Lifestyle & Leisure",
          "Technology & Finance"
        ]
      },
      "default": [],
      "prefill": []
    },
    "weeksBack": {
      "title": "Extra Weekly Windows",
      "type": "integer",
      "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.",
      "default": 0,
      "minimum": 0,
      "maximum": 4,
      "prefill": 0
    },
    "includeTopComments": {
      "title": "Include Top Comments",
      "type": "boolean",
      "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).",
      "default": false,
      "prefill": false
    },
    "maxItems": {
      "title": "Maximum Rows",
      "type": "integer",
      "description": "Maximum number of data rows to write per run. Creator rows are not counted.",
      "default": 1000,
      "minimum": 1,
      "maximum": 5000,
      "prefill": 10
    }
  },
  "required": []
}