TikTok Post Scraper by URL

🧩 Overview

This Actor collects data from public TikTok posts using provided search or profile URLs. Ideal for social media analysis, content tracking, or trend monitoring, it scrapes detailed metadata for each video post — no login required and fully automated.

⭐ Why choose this actor?

This actor offers a simple and efficient way to extract high-engagement TikTok posts using just a URL. Whether you're conducting influencer research or trend discovery, it delivers rich and structured data instantly.
NO PROXIES REQUIRED ✅
MULTIPLE URL SUPPORT ✅
CAPTURES FULL POST METADATA ✅

🔍 Use Cases

• Monitor viral video performance
• Research top-performing TikTok content
• Build datasets for machine learning or marketing
• Track engagement trends across different accounts

🚀 Key Features

• Collect up to 10 posts per URL
• Extracts likes, shares, comments, hashtags, and more
• Captures video metadata and profile insights
• Input multiple TikTok URLs at once
• Optimized for search URLs or profile pages

⚙️ How It Works

1. Provide one or more TikTok search or profile URLs
2. Set the max_post_per_url (must be a multiple of 10)
3. The actor scrapes post metadata including video URLs, stats, and user info
4. Download the structured dataset in JSON, CSV or Excel format

📥 Input Parameters

Field	Type	Description	Required	Example
urls	array	List of TikTok URLs (search results or profiles)	Yes	["https://www.tiktok.com/search?lang=en&q=dogs"]
max_post_per_url	integer	Max number of posts per URL. Must be a multiple of 10	No	20

📤 Output (Full Example)

{
  "url": "https://www.tiktok.com/@example/video/1234567890123456789",
  "post_id": "1234567890123456789",
  "description": "funny cat playing with yarn 🧶 #cats #funny",
  "create_time": "2025-06-28T20:22:26.000Z",
  "digg_count": 1600000,
  "share_count": "89300",
  "collect_count": 88400,
  "comment_count": 16700,
  "play_count": 7200000,
  "video_duration": 61,
  "hashtags": ["cats", "funny"],
  "original_sound": "catmusic: original sound",
  "profile_id": "1234567890123456",
  "profile_username": "catlover",
  "profile_url": "https://www.tiktok.com/@catlover",
  "profile_avatar": "https://example.com/avatar.jpg",
  "preview_image": "https://example.com/preview.jpg",
  "post_type": "video",
  "offical_item": false,
  "secu_id": "secure_example_id",
  "original_item": false,
  "shortcode": "1234567890123456789",
  "width": 576,
  "ratio": "540p",
  "video_url": "https://example.com/video.mp4",
  "music": {
    "authorname": "catmusic",
    "covermedium": "https://example.com/cover.jpg",
    "id": "123456789",
    "original": true,
    "playurl": "https://example.com/music.mp3",
    "title": "original sound"
  },
  "is_verified": false,
  "account_id": "catlover",
  "profile_followers": 65700,
  "timestamp": "2025-07-18T11:51:54.554Z",
  "input": {
    "url": "https://www.tiktok.com/search?lang=en&q=cat",
    "num_of_posts": 10,
    "country": ""
  }
}

💰 Pricing

• Free Users: Up to 10 results per run.
• Pay As You Go: $2.00 per 1,000 results

📢 Legal Disclaimer

This actor is intended for educational and research use. You are solely responsible for complying with TikTok’s Terms of Service and any applicable data regulations when using the data.

THIS ACTOR DOES NOT USE PROXIES.
ONLY 10 RESULTS ARE FREE FOR FREE USERS.
THE max_post_per_url VALUE MUST BE A MULTIPLE OF 10.

🔄 Update Policy

We monitor TikTok UI/API changes frequently and apply fixes as needed. Please report any breaking changes or unexpected output.

❓ FAQ

Can I scrape private or restricted videos?
No. This actor only accesses publicly visible content.

Does it work with hashtags, profiles, and search URLs?
Yes, it supports all of those formats.

What if I put max_post_per_url = 35?
It will automatically round up to 40 and return that number of results.