TikTok Trends Scraper

Track public TikTok Explore topics, hashtag pages, sounds, and videos for social media research.

Data fields

FieldTypeDescription
rankinteger | nullValue exported as rank.
trendTypestringValue exported as trendType.
titlestringValue exported as title.
hashtagstring | nullValue exported as hashtag.
descriptionstring | nullValue exported as description.
videoUrlstring | nullValue exported as videoUrl.
authorUsernamestring | nullValue exported as authorUsername.
soundTitlestring | nullValue exported as soundTitle.

Input preview

startUrlsTikTok URLs
keywordsHashtag keywords
trendTypeDefault trend type
countryCountry / region code
languageLanguage code
maxItemsMaximum trend items

API and agents

This actor can be run through Apify API, datasets, webhooks, schedules, and the official Apify MCP server.

How this actor works

See example inputs, outputs, API usage, and practical limits before running this actor on Apify.

Open Apify page

Track and export public TikTok Explore topics, hashtag pages, sounds, and video trend records by URL, keyword, country, language, and trend type.

Use this Actor to collect TikTok trend data for social media research, content planning, ecommerce monitoring, creator strategy, campaign tracking, and recurring trend dashboards. Results can be downloaded as CSV, JSON, Excel, XML, RSS, or used through the Apify Dataset API.

At a glance

  • Trend URL input: Start from TikTok Discover, hashtag pages, sound pages, or public video URLs.
  • Keyword to hashtag workflow: Enter keywords such as travel or skincare and the Actor converts them into TikTok hashtag URLs.
  • Trend records: Export trend type, rank, title, hashtag, description, video URL, author, sound title, public counts, region label, source URL, and timestamp.
  • Monitoring ready: Run the same trend inputs on a schedule to build daily or weekly snapshots.
  • API export: Send TikTok trend rows to spreadsheets, dashboards, content calendars, BI tools, or AI agents.

What can it do?

TikTok Trends Scraper turns public TikTok trend pages and keyword-derived hashtag pages into structured dataset rows.

  • Collect Discover topics: Use https://www.tiktok.com/discover for public Explore topic rows.
  • Track hashtag pages: Enter hashtag keywords or TikTok /tag/ URLs.
  • Inspect sound and video URLs: Add public sound or video URLs when you need source-linked trend records.
  • Label by region and language: Store your target country and preferred language with each row.
  • Export snapshots: Use Apify schedules, API calls, webhooks, and integrations for recurring trend monitoring.

Common workflows

  • Content planning: Find recurring TikTok topics, hashtags, sounds, and public video examples.
  • Trend dashboards: Build daily or weekly trend snapshots by region, keyword, or source URL.
  • Ecommerce monitoring: Track public product, lifestyle, seasonal, or category themes.
  • Campaign research: Watch hashtag pages around launches, events, creators, or communities.
  • Creator strategy: Identify content patterns, sound topics, and video examples for ideation.
  • Market research: Compare public TikTok trend rows across country labels and keyword groups.

What data can you extract?

The Actor returns one dataset row per public TikTok trend item.

Field Description
rank Rank within the extracted trend list
trendType Discover, hashtag, sound, or video
title Trend topic, hashtag page title, sound title, or video title
hashtag Hashtag when available or derived from the topic
description Public trend or topic description when available
videoUrl Public TikTok video URL when the input is a video
authorUsername Public author username when exposed
soundTitle Sound title for sound URLs
viewCount Optional public view count
likeCount Optional public like count
commentCount Optional public comment count
shareCount Optional public share count
region Country or region label supplied in the input
keywordOrUrl Input keyword-derived URL or original URL
sourceUrl TikTok URL used for the record
scrapedAt ISO timestamp for the run

Example input

{
  "startUrls": [
    { "url": "https://www.tiktok.com/discover" }
  ],
  "keywords": ["travel", "skincare"],
  "country": "US",
  "language": "en",
  "trendType": "discover",
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Example output

{
  "rank": 1,
  "trendType": "hashtag",
  "title": "skincare",
  "hashtag": "skincare",
  "description": "Public TikTok hashtag topic",
  "videoUrl": "https://www.tiktok.com/@creator/video/...",
  "authorUsername": "creator",
  "soundTitle": null,
  "viewCount": 1234567,
  "likeCount": 12345,
  "commentCount": 123,
  "shareCount": 45,
  "region": "US",
  "keywordOrUrl": "skincare",
  "sourceUrl": "https://www.tiktok.com/tag/skincare",
  "scrapedAt": "2026-06-23T14:30:00.000Z"
}

How to run it

  1. Open the Actor on Apify.
  2. Keep the Discover URL or add public TikTok tag, music, or video URLs.
  3. Add optional hashtag keywords.
  4. Set country, language, trend type, and maxItems.
  5. Choose proxy settings if needed.
  6. Start the run and export the dataset.

Search tips

  • Use keyword groups: Compare related topics such as travel, skincare, and fitness.
  • Keep snapshots small: Use maxItems: 20 while testing trend inputs.
  • Schedule the same inputs: Recurring runs are useful for trend movement over time.
  • Label regions consistently: Use the same country value for comparable trend snapshots.
  • Use URLs for precision: Paste exact TikTok tag, sound, or video URLs when a keyword is ambiguous.

Limits and caveats

  • The Actor extracts publicly visible TikTok pages only.
  • It is not a replacement for private TikTok analytics, creator dashboards, or ad account reporting.
  • TikTok may localize, cache, limit, or block public trend pages.
  • Some count fields are empty when TikTok does not expose them on the public page.

Integrations

You can connect TikTok trend data to downstream tools:

  • Export CSV or Excel to content calendars and trend trackers.
  • Load JSON rows into dashboards for scheduled trend snapshots.
  • Trigger webhooks after daily or weekly monitoring runs.
  • Send trend rows to AI tools for clustering or content ideation.
  • Combine trends with TikTok hashtag, profile, video, and ads datasets.

API usage

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/tiktok-trends-scraper').call({
  startUrls: [{ url: 'https://www.tiktok.com/discover' }],
  keywords: ['travel', 'skincare'],
  country: 'US',
  maxItems: 20
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

from apify_client import ApifyClient
import os

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('fetch_cat/tiktok-trends-scraper').call(run_input={
    'startUrls': [{'url': 'https://www.tiktok.com/discover'}],
    'keywords': ['travel', 'skincare'],
    'country': 'US',
    'maxItems': 20,
})
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)

cURL

curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~tiktok-trends-scraper/runs?token=YOUR_APIFY_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"startUrls":[{"url":"https://www.tiktok.com/discover"}],"keywords":["travel","skincare"],"country":"US","maxItems":20}'

MCP and AI agents

This Actor can be used through the official Apify MCP server at https://mcp.apify.com.

For a focused single-Actor tool setup, use:

https://mcp.apify.com?tools=fetch_cat/tiktok-trends-scraper

Use the same JSON keys shown in the input configuration table, such as startUrls, keywords, trendType, country, language, and maxItems.

Support

If a run fails, returns no data, or a field looks wrong, open an issue from the Actor page.

Please include the Apify run ID or run URL, input JSON, one example public URL, query, or input item, what you expected, and what the dataset returned. Small reproducible inputs make parsing or site-layout issues much faster to fix.

Common questions

Questions and answers reused from the canonical actor README.

Can I use this as a TikTok trends API?

Yes. You can run the Actor through the Apify API and read results from the Dataset API.

Is this a replacement for TikTok analytics?

No. It extracts public trend pages and public metadata only.

Can I schedule daily trend checks?

Yes. Use Apify schedules with the same URLs, keywords, country, and maxItems values.

Why did I get fewer rows than requested?

TikTok may expose fewer public items for a page, keyword, region, or connection at the time of the run.