Tiktok Profile Videos Api Scraper

A powerful Apify Actor that scrapes videos from TikTok user profiles using the official TikTok API. This actor extracts comprehensive video data including metadata, statistics, music information, and more.

Why Choose Us?

• Comprehensive Data Extraction: Get all available video data including metadata, statistics, music info, challenges, and more
• Smart Proxy Rotation: Automatic fallback from no proxy → datacenter → residential proxy with retry logic
• Bulk Processing: Process multiple profiles in a single run
• Flexible Sorting: Sort videos by newest or oldest
• Detailed Logging: Real-time progress updates and detailed logs
• Production Ready: Built with error handling, retry logic, and rate limiting

Key Features

• ✅ Scrape videos from TikTok profiles using official API
• ✅ Automatic proxy rotation with fallback mechanism
• ✅ Support for bulk profile processing
• ✅ Configurable sort order (newest/oldest)
• ✅ Maximum videos limit per profile
• ✅ Comprehensive video data extraction
• ✅ Detailed logging and progress tracking
• ✅ Error handling and retry logic

Input

JSON Example

{
  "startUrls": [
    { "url": "https://www.tiktok.com/@mrbeast" },
    { "url": "https://www.tiktok.com/@charlidamelio" }
  ],
  "sortOrder": "newest",
  "maxVideos": 50,
  "maxComments": 0,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Input Fields

• startUrls (required): Array of TikTok profile URLs, usernames, or keywords

  • Can be full URLs: https://www.tiktok.com/@username
  • Or just usernames: username or @username

• sortOrder (optional): Sort order for videos

  • "newest" (default): Newest videos first
  • "oldest": Oldest videos first

• maxVideos (optional): Maximum number of videos to scrape per profile

  • Set to 0 or leave empty to scrape all videos
  • Default: 0 (unlimited)

• maxComments (optional): Maximum number of comments per video

  • Currently not implemented, reserved for future use
  • Default: 0

• proxyConfiguration (optional): Proxy settings

  • By default, no proxy is used
  • If TikTok blocks requests, automatically falls back to:
    1. Datacenter proxy
    2. Residential proxy (with 3 retries)
  • All proxy events are logged clearly

Output

Output Format

Each video in the dataset contains comprehensive information:

{
  "id": "7582653507375746334",
  "aweme_id": "7582653507375746334",
  "url": "https://www.tiktok.com/@mrbeast/video/7582653507375746334",
  "desc": "Video description...",
  "description": "Video description...",
  "createTime": 1765474107,
  "author": {
    "id": "6614519312189947909",
    "uniqueId": "mrbeast",
    "nickname": "MrBeast",
    "avatarThumb": {
      "url_list": ["https://..."],
      "width": null,
      "height": null
    },
    "verified": true
  },
  "stats": {
    "playCount": 1100000,
    "diggCount": 63900,
    "commentCount": 9020,
    "shareCount": 8440,
    "collectCount": 4182
  },
  "video": {
    "duration": 93,
    "width": 720,
    "height": 1280,
    "play_addr": {
      "url_list": ["https://..."],
      "width": 720,
      "height": 1280
    },
    "download_addr": {
      "url_list": ["https://..."],
      "width": 720,
      "height": 1280
    }
  },
  "music": {
    "id": "7582653324450925343",
    "title": "original sound",
    "author": "MrBeast",
    "duration": 93,
    "play_url": {
      "url_list": ["https://..."]
    }
  },
  "challenges": [],
  "profile_username": "mrbeast",
  "profile_url": "https://www.tiktok.com/@mrbeast"
}

Output Fields

• id: Video ID
• aweme_id: Alternative video ID format
• url: Direct link to the video
• desc/description: Video description
• createTime: Video creation timestamp
• author: Complete author information (username, nickname, avatar, verification status, etc.)
• stats: Video statistics (views, likes, comments, shares, bookmarks)
• video: Video details (duration, dimensions, play URLs, download URLs)
• music: Music/sound information (title, author, duration, play URL)
• challenges: Hashtags/challenges associated with the video
• profile_username: Username of the profile scraped
• profile_url: URL of the profile scraped

🚀 How to Use the Actor (via Apify Console)

1. Log in at https://console.apify.com and go to Actors
2. Find your actor (tiktok-profile-videos-api-scraper) and click it
3. Configure inputs:
   • Add TikTok profile URLs or usernames in the startUrls field
   • Set sortOrder (newest/oldest)
   • Set maxVideos if you want to limit the number of videos
   • Configure proxyConfiguration if needed (optional)
4. Run the actor
5. Monitor logs in real time to see progress
6. Access results in the OUTPUT tab
7. Export results to JSON or CSV

Best Use Cases

• Content Research: Analyze video performance and trends
• Competitor Analysis: Monitor competitor profiles and content
• Data Collection: Build datasets for machine learning or analysis
• Content Aggregation: Collect videos from multiple creators
• Trend Analysis: Track popular content and hashtags
• Social Media Monitoring: Monitor specific profiles for new content

Frequently Asked Questions

How does proxy rotation work?

The actor uses a smart proxy rotation strategy:

1. Default: No proxy (direct connection)
2. If blocked: Automatically switches to datacenter proxy
3. If still blocked: Falls back to residential proxy with 3 retry attempts
4. Sticky behavior: Once a proxy type is selected, it sticks for all remaining requests
5. Clear logging: All proxy events are logged for transparency

Can I scrape private profiles?

No, this actor only works with public TikTok profiles. Private profiles cannot be accessed without authentication.

What's the rate limit?

The actor includes built-in delays (1-2 seconds) between requests to be respectful to TikTok's servers. For large-scale scraping, consider using proxy configuration.

How many videos can I scrape?

You can scrape unlimited videos per profile, or set a maxVideos limit. The actor will continue until all videos are scraped or the limit is reached.

Does this work with keywords?

Currently, the actor focuses on profile scraping. Keyword search functionality may be added in future versions.

What if a profile doesn't exist?

The actor will log an error and continue with the next profile in the list. Failed profiles are tracked in the final summary.

Support and Feedback

For issues, questions, or feedback, please contact the actor maintainer or open an issue in 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
• Use responsibly and ethically

---

Note: This actor uses TikTok's official web API and may be affected by changes to TikTok's platform. Regular updates ensure compatibility with the latest TikTok structure.