🧠 TikTok Posts Scraper by Profile URL

Overview

This actor scrapes TikTok posts from one or multiple user profiles. Simply provide a TikTok profile URL like https://www.tiktok.com/@username and the actor will return recent video post data, including engagement metrics, media URLs, and more.

🚀 Why choose this actor?

Forget manual copy-paste or unreliable browser extensions. With this actor, you get structured TikTok post data directly in JSON format, ideal for automation workflows, research, and social analytics. Plus, NO PROXIES NEEDED, making it simple and lightweight.

Use Cases

• Track post performance of influencers or competitors
• Monitor brand campaigns across TikTok profiles
• Academic or market research on content trends
• Discover viral content patterns over time

🔑 Key Features

• Scrapes posts from public TikTok profiles
• Collects likes, comments, shares, plays, and more
• Retrieves video URLs, cover images, music metadata, and subtitles (if available)
• Custom date range filters available
• NO proxies required
• Fast, scalable, and easy-to-use

⚙️ How It Works

1. Provide one or more TikTok profile URLs.
2. Optionally set a date range (start_date, end_date).
3. Set how many posts you want (must be a multiple of 10).
4. Run the actor. You'll get structured data including media, stats, and metadata.

Input Parameters

Field	Type	Description	Required	Example
profile_urls	array	TikTok profile URLs to scrape (e.g. https://www.tiktok.com/@username)	✅ Yes	["https://www.tiktok.com/@johndoe"]
max_results	integer	Maximum number of posts to scrape (must be a multiple of 10, default: 10)	❌ No	20
start_date	string	Earliest post date to scrape (YYYY-MM-DD format)	❌ No	"2024-01-01"
end_date	string	Latest post date to scrape (YYYY-MM-DD format)	❌ No	"2024-12-31"

📤 Output (Full Example)

{
  "url": "https://www.tiktok.com/@johndoe/video/1234567890",
  "post_id": "1234567890",
  "description": "Just having fun 😄",
  "create_time": "2024-01-15T14:23:00.000Z",
  "digg_count": 45000,
  "share_count": "300",
  "collect_count": 5000,
  "comment_count": 120,
  "play_count": 900000,
  "video_duration": 60,
  "original_sound": "JohnDoe: original sound",
  "profile_id": "998877",
  "profile_username": "JohnDoe",
  "profile_url": "https://www.tiktok.com/@johndoe",
  "profile_avatar": "https://example.com/avatar.jpg",
  "profile_biography": "Follow for fun content!",
  "preview_image": "https://example.com/preview.jpg",
  "post_type": "video",
  "offical_item": false,
  "secu_id": "xxxx",
  "original_item": false,
  "shortcode": "1234567890",
  "width": 576,
  "ratio": "540p",
  "video_url": "https://example.com/video.mp4",
  "music": {
    "authorname": "JohnDoe",
    "covermedium": "https://example.com/music.jpg",
    "id": "987654321",
    "original": true,
    "playurl": "https://example.com/audio.mp3",
    "title": "original sound"
  },
  "is_verified": true,
  "account_id": "johndoe",
  "tagged_user": null,
  "profile_followers": 150000,
  "region": "US",
  "subtitle_info": [],
  "timestamp": "2025-07-18T14:05:22.936Z",
  "input": {
    "url": "https://www.tiktok.com/@johndoe/video/1234567890",
    "country": ""
  },
  "discovery_input": {
    "url": "https://www.tiktok.com/@johndoe",
    "num_of_posts": 10,
    "what_to_collect": "Posts & Reposts",
    "start_date": "",
    "end_date": "",
    "post_type": "",
    "country": ""
  }
}

💸 Pricing

• Free User: Up to 10 results per run.
• Pay-as-you-go: $2.50 per 1,000 results.

📢 LEGAL DISCLAIMER

This tool is not affiliated with or endorsed by TikTok. Use it responsibly and comply with TikTok’s Terms of Service. Data availability depends on public visibility and API changes.

🔄 UPDATE POLICY

This actor is actively maintained. Breaking changes or major improvements will be versioned. Minor field additions may occur without notice.

❓ FAQ

Does this actor work on private accounts?
No, it only works on public TikTok profiles.

What if I set max_results = 35?
You’ll get 40 results. This field rounds up to the next multiple of 10.

Can I use this without a proxy?
YES! This actor does NOT require proxies to run.

How many free results do I get?
10 results per run are free for free-tier users.