# Tiktok Videos Super Scraper (`muhammad_noman_riaz/tiktok-videos-super-scraper`) Actor

Extract complete, high-accuracy metadata from any TikTok video via direct URL. This actor gathers video details, author info, music data, engagement stats, hashtags, effects, and more, all in a single, clean JSON output.

- **URL**: https://apify.com/muhammad_noman_riaz/tiktok-videos-super-scraper.md
- **Developed by:** [Muhammad Noman Riaz](https://apify.com/muhammad_noman_riaz) (community)
- **Categories:** Social media, Videos, Developer tools
- **Stats:** 25 total users, 0 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

$5.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## TikTok Video Scraper - Extract TikTok Videos, Metadata & Analytics Data

Extract comprehensive TikTok video data, download TikTok videos, scrape TikTok metadata, and gather TikTok analytics with this powerful TikTok scraper tool. Get video information, author profiles, engagement metrics, music data, hashtags, and download TikTok videos in MP4 format.

### What You Can Extract from TikTok Videos

#### Video Metadata & Information

- Video dimensions, duration, and quality settings
- Creation date and upload timestamps
- Video captions and descriptions
- Thumbnail and cover image URLs
- Direct video download links

#### Author & Profile Data

- Username, display name, and profile links
- Follower counts, following statistics
- Account verification badges
- Profile pictures and bio information
- Total videos and likes by creator

#### Engagement & Analytics Metrics

- Like counts (diggCount)
- Share and comment statistics
- View counts and play metrics
- Save/bookmark counts
- Real-time engagement analytics

#### Music & Audio Information

- Song titles and artist names
- Music play URLs and audio tracks
- Original vs licensed music detection
- Music identification for tracking

#### Content Analysis Features

- Hashtag extraction from video descriptions
- User mention detection (@mentions)
- Effect stickers and video filters
- Sponsored content identification
- Slideshow and pinned video detection

### How to Use TikTok Video Scraper

#### Step 1: Prepare Your TikTok Video URLs

Collect the TikTok video URLs you want to scrape. You can process one video or multiple videos in a single batch.

#### Step 2: Configure Download Options

Choose what data you want to extract and download:

- Video metadata only
- Download TikTok videos in MP4 format
- Download video thumbnails and covers
- Extract related videos (optional)

#### Step 3: Run the Scraper

Upload your video URLs and start the scraping process. The tool will automatically extract all available data from each TikTok video.

#### Step 4: Download Your Results

Export your scraped TikTok data in your preferred format: JSON, CSV, Excel, or HTML table format.

### Input Configuration Options

#### Required Input

**postURLs** - Array of TikTok video URLs to scrape

```
[
  "https://www.tiktok.com/@username/video/1234567890123456789",
  "https://www.tiktok.com/@creator/video/9876543210987654321"
]
```

#### Optional Settings

- **shouldDownloadVideos**: Download TikTok videos as MP4 files
- **shouldDownloadCovers**: Download video thumbnail images
- **scrapeRelatedVideos**: Extract related video recommendations

### Example Usage

#### Extract TikTok Video Metadata Only

```json
{
  "postURLs": [
    "https://www.tiktok.com/@tiktok/video/1234567890123456789"
  ]
}
```

#### Download TikTok Videos + Thumbnails

```json
{
  "postURLs": [
    "https://www.tiktok.com/@creator/video/9876543210987654321"
  ],
  "shouldDownloadVideos": true,
  "shouldDownloadCovers": true
}
```

### Complete Data Output Example

```json
{
	"id": "7476622955951213831",
	"text": "ندي .. طبق اشتهر بين أهالي عسير في أعلى جبال المملكة، يتميز بطبخ اللحم داخل القصدير ليضيف نكهة الترف مع الأرز النثري ليقدم كطبق رئيسي في كل المناسبات، ولأن #بنجابي_المهيدب النخبة في الأرز .. تعاونا مع #هيئة_فنون_الطهي @mocculinary  لإظهار لذة المطبخ السعودي!",
	"textLanguage": "ar",
	"createTime": "1740786947",
	"createTimeISO": "2025-02-28T23:55:47.000Z",
	"locationCreated": "SA",
	"isAd": true,
	"authorMeta": {
		"id": "6950924620506317826",
		"name": "punjabialmuhaidib",
		"profileUrl": "https://www.tiktok.com/@punjabialmuhaidib",
		"nickName": "أرز بنجابي المهيدب",
		"verified": false,
		"signature": "عمري اكثر من ٧٠ عاماً ارتبط اسمي بالمائدة السعودية ولازلت أفضل أنواع الارز",
		"bioLink": null,
		"originalAvatarUrl": "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/9e856f8f9199474ed6835bed4fe16710~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=5320196d&x-expires=1763640000&x-signature=sjPAAM7LckOnBtdPQLYwngkUhuQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
		"avatar": "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/9e856f8f9199474ed6835bed4fe16710~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=5320196d&x-expires=1763640000&x-signature=sjPAAM7LckOnBtdPQLYwngkUhuQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
		"privateAccount": false,
		"roomId": "",
		"ttSeller": false,
		"following": 1,
		"friends": 0,
		"fans": 1166,
		"heart": 18000,
		"video": 6,
		"digg": 1,
		"commerceUserInfo": {
			"commerceUser": false
		}
	},
	"musicMeta": {
		"musicName": "original sound",
		"musicAuthor": "أرز بنجابي المهيدب",
		"musicOriginal": true,
		"playUrl": "https://v77.tiktokcdn.com/e1389feced1986e49a2450f2011b88e4/691dbd27/video/tos/alisg/tos-alisg-v-27dcd7/o0QCJnAswDfEUTPFBCEAF00fG5YgMFEDAZQBpk/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThtP1cPXq8Zmo&mime_type=audio_mpeg&qs=13&rc=ajg4OnQ5cjQ3eTMzODU8NEBpajg4OnQ5cjQ3eTMzODU8NEBoZnNfMmRrbi5gLS1kMS1zYSNoZnNfMmRrbi5gLS1kMS1zcw%3D%3D&vvpl=1&l=20251118204941ADC6347B0D9D5714C97A&btag=e00050000&cc=13",
		"coverMediumUrl": "https://v77.tiktokcdn.com/e1389feced1986e49a2450f2011b88e4/691dbd27/video/tos/alisg/tos-alisg-v-27dcd7/o0QCJnAswDfEUTPFBCEAF00fG5YgMFEDAZQBpk/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThtP1cPXq8Zmo&mime_type=image&qs=13&rc=ajg4OnQ5cjQ3eTMzODU8NEBpajg4OnQ5cjQ3eTMzODU8NEBoZnNfMmRrbi5gLS1kMS1zYSNoZnNfMmRrbi5gLS1kMS1zcw%3D%3D&vvpl=1&l=20251118204941ADC6347B0D9D5714C97A&btag=e00050000&cc=13",
		"originalCoverMediumUrl": "https://v77.tiktokcdn.com/e1389feced1986e49a2450f2011b88e4/691dbd27/video/tos/alisg/tos-alisg-v-27dcd7/o0QCJnAswDfEUTPFBCEAF00fG5YgMFEDAZQBpk/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=.NpOcInz7ThtP1cPXq8Zmo&mime_type=image&qs=13&rc=ajg4OnQ5cjQ3eTMzODU8NEBpajg4OnQ5cjQ3eTMzODU8NEBoZnNfMmRrbi5gLS1kMS1zYSNoZnNfMmRrbi5gLS1kMS1zcw%3D%3D&vvpl=1&l=20251118204941ADC6347B0D9D5714C97A&btag=e00050000&cc=13",
		"musicId": "7476623013211884305"
	},
	"webVideoUrl": "https://www.tiktok.com/@punjabialmuhaidib/video/7476622955951213831",
	"mediaUrls": [
		"https://api.apify.com/v2/key-value-stores/jhsdLNNDKJ32/records/video_7476622955951213831.mp4"
	],
	"videoMeta": {
		"height": 1024,
		"width": 576,
		"duration": 65,
		"coverUrl": "https://api.apify.com/v2/key-value-stores/jhsdLNNDKJ32/records/cover_7476622955951213831.jpg",
		"originalCoverUrl": "https://p16-sign-sg.tiktokcdn.com/tos-alisg-p-0037/oY1RfwErs9dYRCUQEavdT0gIDfAVFBAzRBMnkI~tplv-tiktokx-origin.image?dr=14575&x-expires=1763640000&x-signature=I00mmKiwdpv86%2FzfdqjIcBhCnnE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=sg1",
		"definition": "540p",
		"format": "mp4",
		"subtitleLinks": [],
		"downloadAddr": "https://api.apify.com/v2/key-value-stores/jhsdLNNDKJ32/records/video_7476622955951213831.mp4"
	},
	"diggCount": 1016,
	"shareCount": 37,
	"playCount": 2300000,
	"collectCount": 83,
	"commentCount": 3,
	"mentions": [],
	"detailedMentions": [],
	"hashtags": [
		{
			"id": "1697021084480513",
			"name": "بنجابي_المهيدب",
			"title": "",
			"cover": ""
		},
		{
			"id": "1689424173224962",
			"name": "هيئة_فنون_الطهي",
			"title": "",
			"cover": ""
		}
	],
	"effectStickers": [],
	"isSlideshow": false,
	"isPinned": false,
	"isSponsored": true,
	"submittedVideoUrl": "https://www.tiktok.com/@punjabialmuhaidib/video/7476622955951213831",
	"downloadedFiles": {
		"videoDownloadUrl": "https://v16-coin.tiktokcdn.com/ae12531becbaee4e338927230f617df2/691cc00b/video/tos/alisg/tos-alisg-pve-0037c001/oM1fZtexUA39AMfEAgLUCmgG7eqPHiSIMiKeER/?a=0&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1300&bt=650&cs=0&ds=6&ft=Jre.CX82ioOPD12as.4s3wUbteEFjeF~O5&mime_type=video_mp4&qs=0&rc=aDk0ZTc2OWgzNTY3Nzc6M0Bpam1rcHk5cnE3eTMzODczNEAzNWI0Y2BjXzYxLmAxLzI1YSNuMGliMmRjay5gLS1kMTFzcw%3D%3D&vvpl=1&l=20251118204946C56D8DA6A6DA9D1450CB&btag=e00090000",
		"video": "https://api.apify.com/v2/key-value-stores/jhsdLNNDKJ32/records/video_7476622955951213831.mp4",
		"cover": "https://api.apify.com/v2/key-value-stores/jhsdLNNDKJ32/records/cover_7476622955951213831.jpg"
	}
}
```

### Export Formats Available

**JSON** - Complete structured data for developers and APIs
**CSV** - Spreadsheet-compatible format for Excel/Google Sheets
**Excel** - Native .xlsx files ready for analysis
**HTML** - Human-readable tables for quick viewing

### Performance & Speed

- Processes 50-100 TikTok videos per batch
- 2-5 seconds average processing time per video
- Automatic error handling and retry mechanisms
- Handles large-scale TikTok data extraction

### Perfect For TikTok Marketing & Analytics

#### Content Creator Analytics

- Track video performance and engagement
- Analyze trending hashtags and music
- Monitor competitor content strategies
- Measure audience interaction patterns

#### Influencer Marketing Research

- Discover top-performing TikTok creators
- Analyze engagement rates and follower growth
- Research successful content formats
- Identify trending challenges and sounds

#### Brand & Campaign Monitoring

- Track brand mentions on TikTok
- Monitor hashtag campaign performance
- Analyze user-generated content
- Measure TikTok marketing ROI

#### Market Research & Trends

- Identify emerging TikTok trends
- Research popular music and sounds
- Analyze demographic engagement data
- Track viral content patterns

### Troubleshooting Guide

#### Videos Not Processing

- Verify TikTok URLs are correct and public
- Check if videos are deleted or private
- Ensure videos aren't region-restricted
- Confirm proper URL format: `https://www.tiktok.com/@username/video/ID`

#### Download Issues

- Some videos may have download restrictions
- Check available storage space
- Verify download options are enabled
- Try processing videos individually

#### Slow Processing

- Large batches take longer to complete
- Network speed affects download times
- TikTok rate limits may cause delays
- Split large jobs into smaller batches

#### Rate Limiting

- Reduce videos per batch (50-100 recommended)
- Add time between scraping sessions
- Avoid running multiple scrapers simultaneously

### Important Usage Guidelines

**Legal Compliance**

- Extract only publicly available TikTok data
- Comply with TikTok's Terms of Service
- Respect content creator rights
- Use data ethically and responsibly

**Best Practices**

- Process reasonable batch sizes
- Respect rate limits to avoid blocks
- Cache results when possible
- Use for legitimate research and analysis

### Support & Help

Need help with TikTok video scraping? Contact our support team for assistance with setup, troubleshooting, or custom requirements.

# Actor input Schema

## `postURLs` (type: `array`):

Add the URLs of TikTok videos you want to scrape. You can enter URLs one by one, or use the Bulk edit section to add a prepared list.

## `scrapeRelatedVideos` (type: `boolean`):

Tick to also scrape related videos from the video page.

## `shouldDownloadVideos` (type: `boolean`):

Tick to download TikTok videos (charged add-on).

## `shouldDownloadCovers` (type: `boolean`):

Tick to download TikTok video cover images (thumbnails).

## `shouldDownloadSlideshowImages` (type: `boolean`):

Tick to download slideshow images if the video is a slideshow.

## `shouldDownloadSubtitles` (type: `boolean`):

Tick to download TikTok video subtitles (only when present on the video).

## `maxWorkers` (type: `integer`):

Number of concurrent threads used for HTTP requests. Lower reduces CPU usage.

## Actor input object example

```json
{
  "postURLs": [
    "https://www.tiktok.com/@apifytech/video/7398101551744552225"
  ],
  "scrapeRelatedVideos": false,
  "shouldDownloadVideos": false,
  "shouldDownloadCovers": false,
  "shouldDownloadSlideshowImages": false,
  "shouldDownloadSubtitles": false,
  "maxWorkers": 2
}
```

# Actor output Schema

## `videos` (type: `string`):

The dataset containing all scraped TikTok videos

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "postURLs": [
        "https://www.tiktok.com/@apifytech/video/7398101551744552225"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("muhammad_noman_riaz/tiktok-videos-super-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "postURLs": ["https://www.tiktok.com/@apifytech/video/7398101551744552225"] }

# Run the Actor and wait for it to finish
run = client.actor("muhammad_noman_riaz/tiktok-videos-super-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "postURLs": [
    "https://www.tiktok.com/@apifytech/video/7398101551744552225"
  ]
}' |
apify call muhammad_noman_riaz/tiktok-videos-super-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,muhammad_noman_riaz/tiktok-videos-super-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/W5qEr8E4pcOkqFgt2/builds/TFvpfYIX5pC86H8vD/openapi.json