Tiktok Scraper

A powerful Apify Actor for scraping TikTok profiles, videos, reposts, hashtags, and keyword search results with automatic proxy fallback.

Why Choose Us?

• Comprehensive Scraping: Scrape videos, reposts, hashtags, and keyword searches in one actor
• Automatic Proxy Fallback: Intelligently handles blocks with automatic proxy switching (none → datacenter → residential)
• Live Data Saving: Results are saved immediately as they're scraped
• Bulk Processing: Process multiple profiles and queries in a single run
• Robust Error Handling: Graceful error handling with detailed logging

Key Features

• ✅ Profile Video Scraping: Extract all videos from TikTok profiles
• ✅ Repost Scraping: Get reposted content from profiles
• ✅ Hashtag Search: Search and scrape content by hashtags
• ✅ Keyword Search: Search TikTok by keywords
• ✅ Automatic Proxy Management: Smart fallback from no proxy → datacenter → residential
• ✅ Real-time Logging: Detailed logs to track scraping progress
• ✅ Bulk Input Support: Process multiple URLs/usernames at once

Input

Example Input JSON

{
  "startUrls": [
    { "url": "https://www.tiktok.com/@mrbeast" },
    { "url": "https://www.tiktok.com/@nike" }
  ],
  "profileScrapeSections": ["videos", "repost"],
  "searchQuery": "Ronaldo",
  "searchType": "keyword",
  "maxResults": 100,
  "proxyConfiguration": {}
}

Input Fields

Field	Type	Required	Description
startUrls	Array	Yes	List of TikTok profile URLs or usernames
profileScrapeSections	Array	No	Sections to scrape: ["videos", "repost"] (default: ["videos"])
searchQuery	String	No	Search query for hashtag/keyword search (leave empty to skip)
searchType	String	No	"keyword" or "hashtag" (default: "keyword")
maxResults	Integer	No	Maximum results per profile/query (1-1000, default: 100)
proxyConfiguration	Object	No	Proxy settings (optional, automatic fallback enabled)

Output

The actor outputs structured data to the Apify dataset. Each item includes:

• Type: Type of scraped data (profile_video, profile_repost, hashtag_search, keyword_search)
• Username/Query: The username or search query
• Data: The actual scraped content (video details, repost info, etc.)
• Success: Whether the scraping was successful

Example Output

{
  "type": "profile_video",
  "username": "mrbeast",
  "video": {
    "id": "7234567890123456789",
    "url": "https://www.tiktok.com/@mrbeast/video/7234567890123456789",
    "title": "Video description",
    "create_time": 1234567890,
    "author": {
      "username": "mrbeast",
      "nickname": "MrBeast",
      "verified": true
    },
    "stats": {
      "views": 1000000,
      "likes": 50000,
      "comments": 1000,
      "shares": 500
    }
  },
  "success": true
}

🚀 How to Use the Actor (via Apify Console)

1. Log in at https://console.apify.com and go to Actors
2. Find tiktok-scraper and click it
3. Configure inputs:
   • Add TikTok profile URLs or usernames in startUrls
   • Select which sections to scrape (videos, repost)
   • Optionally add a search query
   • Set maximum results
   • Configure proxy if needed (or leave empty for automatic fallback)
4. Click Start to run the actor
5. Monitor logs in real time to see scraping progress
6. Access results in the OUTPUT tab
7. Export results to JSON or CSV

Best Use Cases

• Content Research: Scrape videos from competitor profiles
• Trend Analysis: Search hashtags and keywords to track trends
• Influencer Research: Collect data from multiple influencer profiles
• Content Aggregation: Gather videos and reposts for analysis
• Market Research: Search for specific topics and keywords

Frequently Asked Questions

Q: What happens if TikTok blocks my requests?
A: The actor automatically falls back through proxy tiers: no proxy → datacenter → residential. All proxy events are logged clearly. The actor will retry 3 times with residential proxy if needed.

Q: Can I scrape private accounts?
A: No, the actor only scrapes publicly available content.

Q: How many profiles can I scrape at once?
A: You can add unlimited profiles in the startUrls array. The actor processes them sequentially.

Q: What's the difference between keyword and hashtag search?
A: Keyword search searches TikTok's general search, while hashtag search specifically targets hashtag pages.

Q: How long does scraping take?
A: Depends on the number of profiles/queries and max results. The actor processes items as fast as possible while respecting rate limits.

Q: Does the actor save data as it scrapes?
A: Yes! The actor uses live saving - data is pushed to the dataset immediately as it's scraped, so you won't lose data if the actor crashes.

Support and Feedback

For issues, questions, or feedback, please contact support through the Apify platform.

Cautions

• Data is collected only from publicly available sources
• No data is taken from private accounts or password-protected content
• The end user is responsible for ensuring legal compliance (spam laws, privacy, data protection, etc.)
• Respect TikTok's Terms of Service and rate limits