TikTok Video Scraper

Extract public TikTok video metadata, engagement statistics, author details, hashtags, and music information from TikTok video URLs.

What does TikTok Video Scraper do?

TikTok Video Scraper turns a list of public TikTok video links into structured dataset rows.

Use it to collect video IDs, captions, author names, publish times, duration, music, hashtags, cover images, and engagement counters.

The actor is designed for URL-based monitoring, competitive analysis, campaign reporting, and creator research.

Who is it for?

• 📊 Social media analysts tracking video performance.
• 🏢 Agencies reporting TikTok campaign results.
• 🧑‍🎤 Creators benchmarking public posts.
• 🛍️ Brand teams monitoring influencer content.
• 🧪 Researchers building public social media datasets.

Why use this actor?

• ✅ Structured output from public TikTok video URLs.
• ✅ One dataset row per submitted video.
• ✅ Engagement metrics in numeric fields.
• ✅ Hashtags and music fields ready for analysis.
• ✅ Handles unavailable videos with a clear status row.

What data can you extract?

Field	Description
videoId	TikTok video ID
authorUsername	Creator handle
authorDisplayName	Creator display name
description	Video caption
createTime	Publish time in ISO format
durationSeconds	Video duration
musicTitle	Music or sound title
musicAuthor	Music or sound author
hashtags	Hashtags used in the caption
diggCount	Like count
commentCount	Comment count
shareCount	Share count
playCount	View/play count
collectCount	Save/favorite count
coverUrl	Cover image URL
canonicalUrl	Normalized TikTok video URL

How much does it cost to scrape TikTok video metadata?

This actor uses pay-per-event pricing.

You pay a small start fee for each run and a per-result fee for each video metadata row saved to the dataset.

For small tests, keep the prefilled single video URL and review the output before scaling to larger batches.

How to scrape TikTok videos

1. Open the actor on Apify.
2. Paste one or more full TikTok video URLs.
3. Set maxItems if you want to process only part of the list.
4. Run the actor.
5. Export the dataset as JSON, CSV, Excel, or through the API.

Input

{
  "videoUrls": [
    "https://www.tiktok.com/@scout2015/video/6718335390845095173"
  ],
  "maxItems": 10
}

Input fields

videoUrls

Array of full public TikTok video URLs.

Use links in the format:

https://www.tiktok.com/@username/video/VIDEO_ID

maxItems

Maximum number of video URLs to process in the run.

proxyConfiguration

Optional Apify proxy configuration.

Most small public-video checks can start without a proxy.

Output

{
  "videoUrl": "https://www.tiktok.com/@scout2015/video/6718335390845095173",
  "videoId": "7623088450576633119",
  "authorUsername": "khaby.lame",
  "authorDisplayName": "Khabane lame",
  "description": "Not a good morning 🚑#learnfromkhaby #comedy",
  "createTime": "2026-04-30T12:37:04.000Z",
  "durationSeconds": 16,
  "musicTitle": "original sound",
  "musicAuthor": "Khabane lame",
  "hashtags": ["learnfromkhaby", "comedy"],
  "diggCount": 12345,
  "commentCount": 123,
  "shareCount": 45,
  "playCount": 67890,
  "collectCount": 100,
  "coverUrl": "https://...",
  "canonicalUrl": "https://www.tiktok.com/@scout2015/video/6718335390845095173",
  "isAvailable": true,
  "fetchedAt": "2026-06-27T00:00:00.000Z"
}

Tips for reliable runs

• 🔗 Use full public TikTok video URLs.
• 🧪 Test one or two links before running a large batch.
• 📌 Remove duplicate URLs before starting a run.
• 🚫 Private, deleted, or unavailable videos may return isAvailable: false.
• 🌍 If TikTok blocks a region, try enabling Apify Proxy.

Common use cases

Campaign reporting

Collect public engagement metrics for a list of sponsored TikTok videos.

Creator monitoring

Track metadata from creator posts used in influencer programs.

Competitor research

Compare captions, hashtags, music, and engagement across public videos.

Content analysis

Export captions and hashtags for downstream text analysis.

Integrations

Use exported datasets in:

• Google Sheets
• Airtable
• BI dashboards
• Social listening workflows
• Marketing reports
• Data warehouses

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-video-scraper').call({
  videoUrls: ['https://www.tiktok.com/@scout2015/video/6718335390845095173'],
  maxItems: 1,
});

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

API usage: Python

from apify_client import ApifyClient

client = ApifyClient('MY-APIFY-TOKEN')
run = client.actor('fetch_cat/tiktok-video-scraper').call(run_input={
    'videoUrls': ['https://www.tiktok.com/@scout2015/video/6718335390845095173'],
    'maxItems': 1,
})

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)

API usage: cURL

curl -X POST "https://api.apify.com/v2/acts/fetch_cat~tiktok-video-scraper/runs?token=$APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"videoUrls":["https://www.tiktok.com/@scout2015/video/6718335390845095173"],"maxItems":1}'

MCP integration

Use this actor from MCP-compatible tools through Apify MCP Server when you want Claude, Cursor, or another MCP client to run TikTok video metadata extraction without writing custom API code.

MCP server URL:

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

Claude Code setup:

$claude mcp add apify https://mcp.apify.com/?tools=fetch_cat/tiktok-video-scraper

Claude Desktop JSON configuration:

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

MCP example prompts you can ask:

• "Use Apify MCP to run fetch_cat/tiktok-video-scraper for these TikTok URLs and rank them by play count."
• "Use the TikTok Video Scraper MCP tool to extract captions, hashtags, and music for this campaign URL list."

Claude Desktop prompt example

"Run fetch_cat/tiktok-video-scraper for these TikTok video URLs and summarize which videos have the most plays."

Claude Code prompt example

"Use Apify MCP to scrape metadata for this TikTok campaign URL list, export the dataset, and calculate average engagement."

More MCP prompts

• "Extract TikTok video stats for these five URLs and return a table sorted by play count."
• "Compare likes, comments, shares, and saves for this creator's public campaign videos."
• "Save TikTok video metadata to an Apify dataset and tell me which captions contain product hashtags."

Troubleshooting

The actor returned isAvailable: false

The video may be deleted, private, region-restricted, or temporarily unavailable.

Check the URL in a browser and confirm it is a public video page.

A metric looks different from the TikTok app

TikTok engagement counts can change quickly.

Run the actor again when you need a fresh snapshot.

Short links are not working

Use the full video URL format whenever possible.

Limits

This actor is for public video metadata only.

It does not scrape comments, replies, direct messages, private accounts, or TikTok Shop records.

Legality and responsible use

Only scrape public TikTok pages you are allowed to access.

Respect TikTok terms, privacy rights, copyright, and applicable laws.

Do not use the actor to collect private or sensitive personal data.

Related scrapers

• https://apify.com/fetch_cat/tiktok-comments-scraper
• https://apify.com/fetch_cat/tiktok-ads-library-scraper
• https://apify.com/fetch_cat/tiktok-transcript-scraper
• https://apify.com/fetch_cat/instagram-stories-highlights-scraper
• https://apify.com/fetch_cat/x-profile-tweets-scraper

FAQ

Can I scrape multiple TikTok videos at once?

Yes. Add multiple full video URLs to videoUrls.

Does this actor download video files?

No. It extracts public metadata and engagement counters.

Does this actor scrape comments?

No. Use the related TikTok Comments Scraper for comments.

Can I schedule it?

Yes. Use Apify schedules to run the same input daily, weekly, or monthly.

Can I export to CSV?

Yes. Apify datasets support JSON, CSV, Excel, XML, RSS, and HTML exports.

Does it require login?

No login is required for public video metadata.

What happens with duplicate URLs?

The actor de-duplicates URLs during input normalization.

What is the best first test?

Run the prefilled sample input with one video and inspect the dataset row.

Changelog

• Initial version: public TikTok video metadata by URL.