> ## Documentation Index
> Fetch the complete documentation index at: https://mindcase.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok Trends

> Monitor global TikTok trends, delivering top videos, posts, authors, and music data automatically

`$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

<ParamField body="categories" type="array" required>
  **Multi-select** · Which TikTok trends to pull. Pick one or more.

  **Options:** `hashtags`, `sounds`, `creators`, `videos`

  *Legend: `hashtags` = Trending Hashtags, `sounds` = Trending Sounds, `creators` = Trending Creators, `videos` = Trending Videos*
</ParamField>

<ParamField body="country" type="string" default="US">
  **Dropdown** · Country to pull trends from (applies to all selected categories).

  [View all 71 options →](/agents/tiktok/trends/values#country)
</ParamField>

<ParamField body="maxResults" type="integer" default={50}>
  **Number** · Approx items per category. Cap is \~100 hashtags/sounds, \~500 creators/videos. Use 0 for all.
</ParamField>

<ParamField body="adsTimeRange" type="string" default="7">
  **Dropdown** · Time window. (Doesn't apply to trending creators.)

  **Options:** `7`, `30`, `120`

  *Legend: `7` = Last 7 days, `30` = Last 30 days, `120` = Last 120 days*
</ParamField>

<ParamField body="adsHashtagIndustry" type="string">
  **Dropdown** · Filter trending hashtags to one industry. (Hashtags only.)

  <Accordion title="Show all 18 options">
    `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 & Transportation`

    [View all 18 as a structured list →](/agents/tiktok/trends/values#adshashtagindustry)
  </Accordion>
</ParamField>

<ParamField body="adsNewOnBoard" type="boolean">
  **Toggle** · Only show newly-trending hashtags. (Hashtags only.)
</ParamField>

<ParamField body="adsRankType" type="string" default="popular">
  **Dropdown** · Sort sounds by Popular or Breakout. (Sounds only.)

  **Options:** `popular`, `surging`

  *Legend: `popular` = Popular, `surging` = Breakout*
</ParamField>

<ParamField body="adsApprovedForBusinessUse" type="boolean">
  **Toggle** · Only sounds licensed for branded content. (Sounds only.)
</ParamField>

<ParamField body="adsSortCreatorsBy" type="string" default="follower">
  **Dropdown** · Sort trending creators. (Creators only.)

  **Options:** `follower`, `engagement`, `avg_views`

  *Legend: `follower` = Followers, `engagement` = Engagement, `avg_views` = Popularity*
</ParamField>

<ParamField body="adsFollowers" type="string">
  **Dropdown** · Filter creators by follower count band. (Creators only.)

  **Options:** `1`, `2`, `3`, `4`

  *Legend: `1` = 10K-100K, `2` = 100K-1M, `3` = 1M-10M, `4` = Over 10M*
</ParamField>

<ParamField body="adsAudienceCountry" type="string">
  **Dropdown** · Filter creators by their audience's country. (Creators only.)

  [View all 71 options →](/agents/tiktok/trends/values#adsaudiencecountry)
</ParamField>

<ParamField body="adsSortVideosBy" type="string" default="vv">
  **Dropdown** · Sort trending videos. (Videos only.)

  **Options:** `vv`, `like`, `comment`, `repost`

  *Legend: `vv` = Hot, `like` = Likes, `comment` = Comments, `repost` = Shares*
</ParamField>

## Response columns

| Field             | Display name     | Type    |
| ----------------- | ---------------- | ------- |
| `category`        | Category         | text    |
| `trendUrl`        | Trend URL        | url     |
| `trendName`       | Trend Name       | text    |
| `type`            | Type             | text    |
| `rank`            | Rank             | number  |
| `rankChange`      | Rank Change      | number  |
| `new`             | New              | boolean |
| `promoted`        | Promoted         | boolean |
| `country`         | Country          | text    |
| `videoCount`      | Video Count      | number  |
| `viewCount`       | View Count       | number  |
| `relatedCreators` | Related Creators | array   |
| `trendHistory`    | Trend History    | object  |

## Example

<CodeGroup>
  ```bash curl theme={null}
  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"
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/tiktok/trends/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "resultsPerPage": 10,
      "adsCountryCode": "US",
      "adsSoundsCountryCode": "US",
      "adsRankType": "popular",
      "adsCreatorsCountryCode": "US",
      "adsSortCreatorsBy": "follower",
      "adsVideosCountryCode": "US",
      "adsSortVideosBy": "vv"
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "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
        }
      ]
    }
  ]
}
```