TikTok Trends Scraper

TikTok Trends Scraper exports Explore topic categories and basic hashtag, sound, or video URL records for content planning. Download source-linked rows as JSON, CSV or Excel, or retrieve them through the API.

These are not measured popularity rankings or regional analytics. Discover can return a fixed topic list when current categories cannot be read. Other URL types can return URL-derived records even when the page is unavailable.

Quick start

1. Open the Actor and use the Discover URL, or replace it with supported public TikTok URLs.
2. Set a small result limit and review the input settings.
3. Run the Actor, then open the dataset to inspect and export the rows.

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

Prefer a video guide? This short Apify walkthrough shows you how to set up and run an Actor. It uses a different Actor, but the setup steps are the same.

Ready-to-run examples

Choose an example to start with a small, preconfigured input.

• Track daily TikTok Explore trends in the US — Collect up to five Explore categories with a US label. The label does not select US-specific trends, and the initial Discover rows can fill the limit before the saved keywords are processed.

What you get

• Explore categories: Topic names, list position and category IDs when available.
• Hashtag records: Convert keywords to hashtag URLs or supply tag URLs directly.
• Sound and video references: Basic source-linked records, using a page title when available.
• Exportable snapshots: Keep source URLs and collection timestamps for your own comparisons.

The Actor does not extract engagement counts, creator profiles, video transcripts or a measured viral leaderboard.

Who is it for?

• Content planners: Organize topic categories and hashtag references for briefs.
• Social media researchers: Maintain small source-linked collections for further investigation.
• Automation builders: Pass structured rows into spreadsheets, dashboards or AI-assisted workflows.

Input settings

Setting	JSON key	Purpose
TikTok URLs	startUrls	Public HTTPS Discover, /tag/, /music/ or /video/ URLs.
Hashtag keywords	keywords	Converted to tag URLs after the explicit URLs.
Default trend type	trendType	discover, hashtag, sound or video when the path does not identify a type.
Country label	country	Label copied to results, not a geographic filter.
Language	language	Preferred page language, default en.
Maximum items	maxItems	Total saved-row cap, 1–500, default 20.
Proxy configuration	proxyConfiguration	Existing connection settings, with Apify Proxy selected in the form.

With no URLs or keywords, the Actor uses Discover. When both are supplied, explicit URLs are processed first. A full result limit can leave later inputs unprocessed. Detailed connection choices and limitations are in the field help.

Hashtag-only input recipe

Remove Discover when you want keyword records rather than topic categories.

{
  "startUrls": [],
  "keywords": ["travel", "skincare"],
  "maxItems": 2,
  "proxyConfiguration": {"useApifyProxy": true}
}

Output data

Each saved row represents a topic category or a basic URL record. This illustrative shape shows a Discover category, not a newly collected result:

{
  "trendType": "discover",
  "keywordOrUrl": "https://www.tiktok.com/discover",
  "title": "Travel",
  "hashtag": "#travel",
  "description": "Public TikTok Explore topic category: Travel",
  "rank": 1,
  "region": "US",
  "scrapedAt": "2026-10-26T00:00:00.000Z",
  "sourceUrl": "https://www.tiktok.com/discover"
}

Field	Meaning
trendType	Discover category, hashtag, sound or video record.
title	Topic name, page title or URL-derived text.
rank	List position, not measured popularity.
hashtag	Hashtag derived from the category or tag URL.
description	Generated category description for Discover rows.
categoryId	Category identifier when returned by TikTok, absent from fixed-list fallback rows.
soundTitle	Page title or URL-derived title for sound records.
videoUrl	Input URL for video records.
region	Supplied country label, uppercased.
keywordOrUrl, sourceUrl	Requested source URL, including keyword-derived URLs.
scrapedAt	Collection timestamp.

The dataset view also contains legacy author and engagement columns. The current implementation does not populate authorUsername, viewCount, likeCount, commentCount or shareCount. Optional fields may be absent. A saved row alone does not prove that its page was accessible or that current categories were obtained.

Download your results

Open your run's dataset, choose Export and select JSON, CSV or Excel. JSON keeps nested fields together. CSV and Excel are useful when you want to review the records in a spreadsheet.

See Apify's download and export guide for the available formats and field options.

Pricing

This Actor uses pay-per-event pricing. The start event is charged once when a run starts processing its inputs.

The item event is charged for each record prepared for saving, including fixed-list topic fallbacks and URL-derived records. These charges do not guarantee fresh page data. No separate error rows are emitted.

Use maxItems to bound the number of rows. A run that fails after starting can still incur its start charge and charges for earlier records.

See the live Pricing tab for current rates and discounts.

Tips for best results

• Start with five rows. Review the meaning and completeness of the output before increasing the limit.
• Use one input type at a time. Discover categories can fill the row limit before keyword URLs are reached.
• Keep labels consistent. Country labels help organize your own exports but do not establish regional popularity.
• Inspect source links. Use them for follow-up research rather than treating fallback records as verified fresh trends.

Limits and caveats

• No login, private analytics, creator dashboard or ad-account access. This is not an official TikTok service.
• Discover returns category order, not measured popularity. When extraction or access fails, it can return a fixed list of common topics. The current rows do not carry an explicit fallback flag.
• Hashtag, sound and video records are basic references. Page failures can still produce URL-derived rows, and engagement counts are not extracted.
• Supported paths are Discover, /tag/, /music/ and /video/. Standard /@username/video/ links are rejected by the current URL validator.
• Country is only a label. Language is a page preference, not a guarantee about returned content.
• TikTok can restrict or change public pages. A run can fail on invalid input or essential execution errors. Scheduling repeats collection, not automatic trend detection.

Automation and integrations

Save your settings for next time

Once you have an input that works for you, save it as an Apify task. This keeps your settings together so you can use them again without filling in the form from scratch.

Run on a schedule

Need fresh results regularly? You can schedule the Actor or a saved task to run at a time that suits you.

Each scheduled run collects the data again. If you want to compare results or highlight changes, add that step in your own workflow.

Send results to your other tools

Use n8n, Make or Zapier to connect this scraper to the rest of your workflow. For example, you could pass its results to an AI assistant or add records to a spreadsheet. Follow the Apify integration guides for your chosen tool.

For a custom connection, an Apify webhook can notify your app when a run finishes or fails. Your app can then fetch the results or handle the failure.

API usage

Want to collect this data from your own app or automation? The examples below send input to the scraper and show how to collect its results.

The Node.js and Python examples wait for the run to finish before reading its results. The cURL example starts the run and returns its details. Wait for that run to finish, then use its defaultDatasetId to fetch the results.

For setup instructions, see Apify's JavaScript client guide, Python client guide and Actor runs API reference.

cURL

curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~tiktok-trends-scraper/runs' \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"startUrls":[{"url":"https://www.tiktok.com/discover"}],"keywords":[],"maxItems":5,"proxyConfiguration":{"useApifyProxy":true}}'

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: [],
  maxItems: 5,
  proxyConfiguration: { useApifyProxy: true }
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

import os
from apify_client import ApifyClient

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': [],
    'maxItems': 5,
    'proxyConfiguration': {'useApifyProxy': True},
})
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)

MCP and AI agents

You can ask your AI assistant to collect data with TikTok Trends Scraper and help you work with the results. The scraper returns the data, and your assistant can then summarize it, compare records or prepare notes.

Connect your assistant through the Apify MCP server. MCP gives your assistant a way to find this scraper, run it and read the results. Follow the official setup and sign-in guide for your app.

Easier setup with an Apify plugin

If you use a supported coding assistant, the official Apify plugin can set up the connection for you. It connects your assistant to Apify and includes instructions for common tasks. Follow the guide for your particular app.

Use Apify AI in Console

Prefer to keep everything in Apify? Open Apify AI in Console and ask it to find Fetch Cat's TikTok Trends Scraper. You can describe the data you want and ask questions about the results.

Apify AI is currently in beta. It asks for confirmation before starting an Actor, and normal run charges apply.

Choose your assistant

• Claude and Claude Code (Anthropic): Apify setup guide.
• ChatGPT and Codex (OpenAI): Apify setup guides.
• Grok Bot (xAI): Apify plugin guide.
• Gemini CLI (Google): MCP server setup guide. Use the server URL below with the HTTP configuration supported by Gemini CLI.

Connect just this scraper

To keep your setup focused on this scraper, add this server configuration to a compatible MCP client:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=fetch_cat/tiktok-trends-scraper"
    }
  }
}

Sign in to Apify when your client asks. If your client uses a Bearer token instead, follow its setup guide and keep the token in its secure configuration. Configuration formats vary by app, so use the linked guide if your client needs a different format.

Use Apify's general server

Already connected to the general Apify MCP server at https://mcp.apify.com? You can use it to find this scraper without adding another server. Ask your assistant to use TikTok Trends Scraper by Fetch Cat, or give it the identifier fetch_cat/tiktok-trends-scraper.

Your assistant can check the available settings and retrieve the results from the returned run. If the run is still working, it should follow that run rather than start it again. Both connection options use Apify's hosted service.

Example requests

• "Get five TikTok Explore topic categories and organize them into content-planning notes."
• "Collect basic TikTok hashtag references for travel and skincare without adding Discover categories, then put their source links in a table."
• "Retrieve ten Explore categories and help me group the returned topics into possible campaign themes."

Normal Apify charges apply. Check the live Pricing tab before asking your assistant to run a larger batch.

Pay with x402

If your AI agent has a funded wallet, it can pay for Apify usage through x402. This experimental option lets an agent use Apify without a conventional account.

Apify AGI provides a prepaid API token with a spending cap after payment. Your agent can use that token to run this scraper through the Apify API or an authenticated MCP connection.

Some MCP setups also support paying for each request directly. That is a different payment option, so check the official guide for its availability.

Follow the official guide for wallet setup, supported payment options and current terms. Apify handles the payments. Keep wallet keys and payment tokens in your agent's secure configuration.

Other ways for agents to pay

Apify also supports MPP for prepaid access through AGI and Skyfire for eligible Actors. If your agent already uses one of these, see the agentic payment guide to choose the right setup.

FAQ

Is this a TikTok trends API?

You can run it through the Apify API and retrieve structured rows. It is not TikTok's official API or a measured popularity feed.

Does the country setting select local trends?

No. It labels each row. It does not filter trends by country or establish where a topic is popular.

Can I get trending songs, counts or full videos?

Sound URLs produce basic title-and-source records. The Actor does not discover a ranked song chart, extract engagement counts or download videos. Use the related specialized Actors for other workflows after checking their own contracts.

Why do repeated runs return the same topics?

Explore categories can remain stable. A fixed topic list can also be returned when current categories are unavailable. Compare source links and category IDs, and do not interpret repetition as measured trend movement.

Do I need TikTok login credentials?

No. Do not supply cookies or passwords. The Actor uses public pages.

Can I export to Excel or use an AI assistant?

Yes. Export the dataset or use the API and MCP guidance above. Any summaries or comparisons are performed by your downstream tools, not by the scraper itself.

Related Actors

• TikTok Hashtag Scraper — Collect metadata for available public TikTok hashtag-feed videos, without downloading video files.
• TikTok Profile Scraper — Collect public TikTok profile details, aggregate counts and available recent video summaries.
• TikTok Video Scraper — Collect public TikTok video metadata and available engagement from known full video URLs.
• TikTok Ads Library Scraper — Collect curated TikTok Creative Center Top Ads and available public performance indicators, rather than a complete ad archive.
• YouTube Shorts Scraper — Collect metadata for available public YouTube Shorts.

Support and feedback

For custom additions or integrations, email hello@fetchcat.dev.

Found an error or have a feature request? Open an issue with the run URL, a non-sensitive input example and what you expected.

Need help sharing it? See Apify’s guide to sharing a run when reporting an issue. Sharing a run can give the developer access to its input, logs and results, so use a run that contains no sensitive data. Please leave out API tokens, passwords, cookies, private documents and personal data. Use a public sample URL or a redacted example instead.

Tried this scraper? We'd love to hear how it worked for you. Leave a review to help others choose the right tool and help us improve it. Your feedback means a lot to us.

Made with care for curious people, AI agents and the possibilities in data. ♥