Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt

Use this file to discover all available pages before exploring further.

$1.6 / 1k results Monitor global TikTok trends, delivering top videos, posts, authors, and music data automatically

​
Endpoint

POST /api/v1/agents/tiktok/trends/run

​
Parameters

​
categories
array
required
Multi-select · Which TikTok trends to pull. Pick one or more.Options: hashtags, sounds, creators, videosLegend: hashtags = Trending Hashtags, sounds = Trending Sounds, creators = Trending Creators, videos = Trending Videos
​
country
string
default:"US"
Dropdown · Country to pull trends from (applies to all selected categories).View all 71 options →
​
maxResults
integer
default:50
Number · Approx items per category. Cap is ~100 hashtags/sounds, ~500 creators/videos. Use 0 for all.
​
adsTimeRange
string
default:"7"
Dropdown · Time window. (Doesn’t apply to trending creators.)Options: 7, 30, 120Legend: 7 = Last 7 days, 30 = Last 30 days, 120 = Last 120 days
​
adsHashtagIndustry
string
Dropdown · Filter trending hashtags to one industry. (Hashtags only.)
Apparel & Accessories, Baby, Kids & Maternity, Beauty & Personal Care, Business Services, Education, Financial Services, Food & Beverage, Games, Health, Home Improvement, Household Products, Life Services, News & Entertainment, Pets, Sports & Outdoor, Tech & Electronics, Travel, Vehicle & TransportationView all 18 as a structured list →
​
adsNewOnBoard
boolean
Toggle · Only show newly-trending hashtags. (Hashtags only.)
​
adsRankType
string
default:"popular"
Dropdown · Sort sounds by Popular or Breakout. (Sounds only.)Options: popular, surgingLegend: popular = Popular, surging = Breakout
​
adsApprovedForBusinessUse
boolean
Toggle · Only sounds licensed for branded content. (Sounds only.)
​
adsSortCreatorsBy
string
default:"follower"
Dropdown · Sort trending creators. (Creators only.)Options: follower, engagement, avg_viewsLegend: follower = Followers, engagement = Engagement, avg_views = Popularity
​
adsFollowers
string
Dropdown · Filter creators by follower count band. (Creators only.)Options: 1, 2, 3, 4Legend: 1 = 10K-100K, 2 = 100K-1M, 3 = 1M-10M, 4 = Over 10M
​
adsAudienceCountry
string
Dropdown · Filter creators by their audience’s country. (Creators only.)View all 71 options →
​
adsSortVideosBy
string
default:"vv"
Dropdown · Sort trending videos. (Videos only.)Options: vv, like, comment, repostLegend: vv = Hot, like = Likes, comment = Comments, repost = Shares

​
Response columns

FieldDisplay nameType
categoryCategorytext
trendUrlTrend URLurl
trendNameTrend Nametext
typeTypetext
rankRanknumber
rankChangeRank Changenumber
newNewboolean
promotedPromotedboolean
countryCountrytext
videoCountVideo Countnumber
viewCountView Countnumber
relatedCreatorsRelated Creatorsarray
trendHistoryTrend Historyobject

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/tiktok/trends/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "resultsPerPage": 10,
    "adsCountryCode": "US",
    "adsSoundsCountryCode": "US",
    "adsRankType": "popular",
    "adsCreatorsCountryCode": "US",
    "adsSortCreatorsBy": "follower",
    "adsVideosCountryCode": "US",
    "adsSortVideosBy": "vv"
  }
}'

​
Example response

Response
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "category": "Apparel & Accessories",
      "trendUrl": "https://www.tiktok.com/tag/prom",
      "trendName": "prom",
      "type": "hashtag",
      "rank": 1,
      "rankChange": 0,
      "new": true,
      "promoted": false,
      "country": "US",
      "videoCount": 179872,
      "viewCount": 766182036,
      "relatedCreators": null,
      "trendHistory": [
        {
          "date": "2026-04-24T00:00:00.000Z",
          "value": 1
        },
        {
          "date": "2026-04-25T00:00:00.000Z",
          "value": 0.53
        },
        {
          "date": "2026-04-26T00:00:00.000Z",
          "value": 0.36
        },
        {
          "date": "2026-04-27T00:00:00.000Z",
          "value": 0.27
        },
        {
          "date": "2026-04-28T00:00:00.000Z",
          "value": 0.25
        },
        {
          "date": "2026-04-29T00:00:00.000Z",
          "value": 0.34
        },
        {
          "date": "2026-04-30T00:00:00.000Z",
          "value": 0.82
        }
      ]
    }
  ]
}