Tiktok Video Scraper

Tiktok Video Scraper

The Tiktok Video Scraper is a purpose-built Apify actor that extracts structured metadata from public TikTok video URLs — fast and reliably. It solves the tedious manual process of opening videos one by one by turning links into clean, analytics-ready records with captions, hashtags, engagement counts, author details, and music information. Ideal for marketers, developers, data analysts, and researchers, this TikTok video scraper for videos scales from a handful of URLs to larger batches and can optionally capture related videos for deeper context.

What data / output can you get?

Below are real output fields as produced by the actor, with examples. Results are saved to your Apify dataset for easy export to JSON or CSV.

Data type	Description	Example value
id	Unique TikTok video ID	7200360993149553925
text	Video description (caption)	“Behind the scenes at Apify!”
textLanguage	Language code of the caption	“en”
createTimeISO	ISO timestamp of publication	“2023-02-07T10:45:45.000Z”
locationCreated	Location metadata if available	“US”
isAd	Whether the post is marked as an ad	false
authorMeta.name	Author’s username (uniqueId)	“apifyoffice”
authorMeta.verified	Author verification status	false
authorMeta.fans	Author’s followers count	12345
musicMeta.musicName	Music title	“original sound”
musicMeta.musicAuthor	Music author name	“Apify”
videoMeta.duration	Video duration in seconds	30
diggCount	Likes (hearts) count	1200
shareCount	Shares count	50
playCount	Views count	45000
commentCount	Comments count	30
collectCount	Saves count	20
webVideoUrl	Canonical TikTok video URL	https://www.tiktok.com/@apifyoffice/video/7200360993149553925

Bonus fields included in each item:

• authorMeta object with rich profile data (profileUrl, nickName, signature, avatars, followers, following, video counts, etc.)
• musicMeta object (musicOriginal, playUrl, cover images, musicId)
• videoMeta object (height, width, cover images, definition, format, subtitleLinks)
• hashtags array with hashtag objects and names
• flags like isSlideshow, isPinned, isSponsored
• submittedVideoUrl echo and media placeholders

Export your dataset results to JSON or CSV for analysis and reporting.

Key features

• 🚀 Bold-scale related video capture
  • Turn “one link” into “many insights.” When enabled, the actor uses a headless browser to discover and extract related videos per submitted post URL — ideal for trend and context analysis.
• 📦 Bulk URL processing
  • Paste multiple TikTok video links and scrape them in one run. Perfect for batch workflows where you need a TikTok video extractor to scale cleanly.
• 🧠 Structured, analytics-ready schema
  • Clean JSON with authorMeta, musicMeta, and videoMeta objects, plus engagement counts and hashtags. This TikTok video scraping tool ensures consistent fields for downstream analytics.
• 🧭 Resilient HTML+JSON parsing
  • Retrieves embedded data from page scripts with retry logic for robust extraction even under transient network conditions.
• 🧪 Headless Playwright engine for discovery
  • Uses Playwright for dynamic, scroll-based discovery of related items, increasing recall without manual browsing.
• 🔑 No login required
  • Works on publicly available TikTok video pages. Ideal when you need a TikTok video URL extractor without account setup.
• 💾 Easy data export
  • Results are saved to your Apify dataset so you can export to JSON or CSV with a click or via Apify’s platform tools.
• 🛡️ Production-oriented reliability
  • Built on Apify’s Python runtime with asynchronous networking and careful error handling for repeatable pipelines.

How to use Tiktok Video Scraper - step by step

1. Create or log in to your Apify account.
2. Open the Tiktok Video Scraper actor from your dashboard.
3. Add input data:
   • Paste one or more TikTok video links into “Direct URL(s) for scraping specific video(s)” (postURLs).
4. (Optional) Enable related videos:
   • Toggle “Scrape related videos” to include additional, related content for each submitted post.
   • Set “Number of related videos per post” (resultsPerPage) to control how many related videos to collect. Note: TikTok typically limits related videos to 12–16 per post.
5. Start the run:
   • Click Start. The actor fetches each URL, parses embedded JSON, and normalizes data. If related videos are enabled, it launches a headless browser for discovery.
6. Monitor progress:
   • Follow run logs to see how many items are captured per URL and when results are written.
7. Download results:
   • Go to the run’s Dataset and export to JSON or CSV for analysis and reporting.

Pro Tip: Enabling related videos can quickly expand a small seed list into a richer dataset for trend analysis and benchmarking.

Use cases

Use case name	Description
Marketing trend discovery	Identify formats, sounds, and hashtags gaining traction by analyzing engagement metrics and hashtags across scraped videos.
Influencer performance analysis	Evaluate creators using engagement counts (views, likes, comments, shares) and authorMeta fields to benchmark growth and impact.
Competitor campaign monitoring	Track competitor posts and related videos to gauge messaging, timing, and ROI signals from public engagement.
Content strategy refinement	Extract captions, hashtags, and musicMeta to learn what resonates and inform your next creative decisions.
Academic & behavioral research	Study posting cadence, music usage, and engagement distributions using createTime, musicMeta, and videoMeta fields.
Data enrichment pipelines	Feed structured TikTok video data (authors, music, engagement) into analytics models or dashboards for cross-channel insights.
Social listening cues	Use captions and hashtags to surface themes and community signals for brand monitoring and qualitative analysis.

Why choose Tiktok Video Scraper?

The Tiktok Video Scraper is optimized for precise, structured extraction at scale — without manual overhead.

• 🎯 Accuracy-first parsing: Extracts embedded JSON structures for consistent fields like authorMeta, musicMeta, and videoMeta.
• 📈 Scales with your workload: Accepts bulk URLs and optionally expands each via related video discovery.
• 🧩 Developer-friendly foundation: Built in Python with Playwright for robust, headless discovery where needed.
• 🔒 Public-only by design: No login required; focused on publicly available TikTok video pages.
• 💾 Flexible exports: Save to Apify dataset and export to JSON or CSV for analysis or ingestion.
• 🧱 Stable alternative to extensions: Avoid brittle browser extensions and manual copy-paste with production-grade scraping logic.
• 🛠️ Resilient operations: Async requests, retries, and headless scrolling to keep your pipeline reliable.

In short, it’s a dependable TikTok video scraper for videos that balances depth (related videos) with clean, structured outputs.

Is it legal / ethical to use Tiktok Video Scraper?

Yes — when used responsibly on public data. This actor targets publicly available TikTok video pages and extracts visible metadata only.

Guidelines for compliant use:

• Only scrape public content (e.g., video metadata, captions, hashtags, and public engagement counts).
• Do not target private or login-restricted content.
• Avoid collecting or using personal data in ways that conflict with privacy regulations (e.g., GDPR, CCPA).
• Ensure your use of scraped data aligns with TikTok’s terms and applicable local laws.
• When in doubt, consult your legal team for project-specific guidance.

Input parameters & output format

Example JSON input

{
  "postURLs": [
    "https://www.tiktok.com/@apifyoffice/video/7200360993149553925"
  ],
  "scrapeRelatedVideos": true,
  "resultsPerPage": 12
}

Input parameters

• postURLs (array, required): Add the URLs of posted videos you want to scrape. You can enter URLs one by one, or upload/link to a text file. Default: none (required).
• scrapeRelatedVideos (boolean, optional): Tick to scrape related videos for the post URLs you provide. The maximum number of scraped related videos is set by the resultsPerPage count. Default: false.
• resultsPerPage (integer, optional): Number of related videos to scrape per post URL. Applies only when Scrape related videos is enabled. Minimum: 1; Maximum: 1,000,000; Default: 10. Note: TikTok typically limits related videos to 12–16 per video.

Example JSON output

{
  "id": "7200360993149553925",
  "text": "Behind the scenes at Apify!",
  "textLanguage": "en",
  "createTime": 1675766745,
  "createTimeISO": "2023-02-07T10:45:45.000Z",
  "locationCreated": "US",
  "isAd": false,
  "authorMeta": {
    "id": "1234567890",
    "name": "apifyoffice",
    "profileUrl": "https://www.tiktok.com/@apifyoffice",
    "nickName": "Apify",
    "verified": false,
    "signature": "Automation for the web",
    "bioLink": "https://apify.com",
    "originalAvatarUrl": "https://example.com/avatar_large.jpg",
    "avatar": "https://example.com/avatar_medium.jpg",
    "privateAccount": false,
    "roomId": "",
    "ttSeller": false,
    "followDatasetUrl": null,
    "following": 10,
    "friends": 5,
    "fans": 12345,
    "heart": 100000,
    "video": 200,
    "digg": 0
  },
  "musicMeta": {
    "musicName": "original sound",
    "musicAuthor": "Apify",
    "musicOriginal": true,
    "playUrl": "https://example.com/music.mp3",
    "coverMediumUrl": "https://example.com/music_cover.jpg",
    "originalCoverMediumUrl": "https://example.com/music_cover_large.jpg",
    "musicId": "9876543210"
  },
  "webVideoUrl": "https://www.tiktok.com/@apifyoffice/video/7200360993149553925",
  "mediaUrls": [],
  "commentsDatasetUrl": null,
  "videoMeta": {
    "height": 1024,
    "width": 576,
    "duration": 30,
    "coverUrl": "https://example.com/cover.jpg",
    "originalCoverUrl": "https://example.com/origin_cover.jpg",
    "definition": "540p",
    "format": "mp4",
    "subtitleLinks": []
  },
  "diggCount": 1200,
  "shareCount": 50,
  "playCount": 45000,
  "collectCount": 20,
  "commentCount": 30,
  "repostCount": 0,
  "mentions": [],
  "detailedMentions": [],
  "hashtags": [
    { "id": "1234", "name": "automation", "title": "", "cover": "" },
    { "name": "webscraping" }
  ],
  "effectStickers": [],
  "isSlideshow": false,
  "isPinned": false,
  "isSponsored": false,
  "submittedVideoUrl": "https://www.tiktok.com/@apifyoffice/video/7200360993149553925"
}

Error handling example

{
  "error": "404, Not Found",
  "url": "https://www.tiktok.com/@sample/video/0000000000000000000"
}

Note: Some optional fields may be empty or null when not present on the public page (e.g., bioLink, commentsDatasetUrl, mentions).

FAQ

Does this Tiktok Video Scraper require login or cookies?

No. It scrapes publicly available TikTok video pages and does not require login or cookies. It’s a safe choice when you need a TikTok video scraping tool for public content.

Can it download videos or remove watermarks?

No. This actor focuses on metadata extraction (captions, hashtags, engagement, author and music info). It is not a TikTok video downloader and does not provide a TikTok video scraper without watermark capability.

Can it scrape related videos from a single URL?

Yes. Enable “Scrape related videos” and control the maximum number via “Number of related videos per post” (resultsPerPage). TikTok typically limits related results to around 12–16 per video.

What fields are included in the output?

You get a structured JSON with top-level fields like id, text, createTimeISO, locationCreated, engagement counts, plus nested authorMeta, musicMeta, and videoMeta objects. Hashtags and flags like isPinned or isSponsored are also included.

How do I export results?

All results are saved to your Apify dataset. From there, you can export to JSON or CSV for analysis, reporting, or ingestion into your data pipelines.

How many TikTok videos can I process at once?

You can provide multiple post URLs in the postURLs array. If related videos are enabled, each seed URL can expand to several more items up to your resultsPerPage setting and the platform’s typical limits.

Is it okay to analyze hashtags and captions from videos?

Yes, provided you stick to public content and comply with TikTok’s terms and applicable data privacy laws. This actor extracts publicly visible captions, hashtags, and engagement metrics.

Is this suitable for developers and analysts?

Yes. It outputs structured JSON with consistent schemas (authorMeta, musicMeta, videoMeta), making it easy to integrate into analytics notebooks, ETL jobs, or dashboards.

Closing CTA / Final thoughts

The Tiktok Video Scraper is built for fast, structured extraction of public TikTok video metadata at scale. It turns URLs into clean records with captions, hashtags, engagement metrics, and rich author/music/video details — and can optionally pull in related videos for broader context. Whether you’re a marketer tracking trends, a developer building a pipeline, or a researcher studying platform dynamics, you’ll get reliable, export-ready data in JSON or CSV. Start extracting smarter TikTok video insights today and accelerate your analysis with a dependable TikTok video extractor.