TikTok Trends Scraper API

Reliable TikTok trends scraper with enterprise-grade performance and 90%+ success rate

Stay ahead of viral content with real-time TikTok trending video data. Get no-watermark URLs, complete metadata, and multi-country support with consistent, dependable results.

🎯 Key Benefits

• ⚡ Fast & Reliable - 90%+ success rate with residential proxies and enterprise infrastructure
• 📹 No-Watermark Videos - Clean URLs without TikTok branding
• 🔗 Permanent Links Available - Generate permalinks that NEVER expire (unlike TikTok's 2-3 hour URLs)
• 🌍 9 Countries Supported - US, UK, Canada, Australia, Germany, France, Japan, Brazil, India
• 🛡️ Robust Performance - Consistent results with advanced proxy rotation and error handling
• 📊 Complete Metadata - Views, likes, shares, comments, author info
• ♾️ Long-term Storage - Archive viral content with permanent, downloadable links
• 🔧 Production Ready - Built for scale with comprehensive monitoring and failover systems

📊 Performance & Reliability

Enterprise-grade infrastructure designed for consistent results

Metric	Performance
Success Rate	90%+ with residential proxies
Speed	~100 videos in 2-3 minutes
Uptime	99.9% availability
Data Freshness	Real-time trending data

Built with redundant systems and automatic failover for maximum reliability

📥 Input Parameters

{
  "country": "United States",
  "numberOfVideos": 20,
  "downloadCoverImage": false,
  "downloadVideo": false,
  "generatePermalinks": false,
  "useApifyProxy": true,
  "proxyType": "RESIDENTIAL",
  "webhookUrl": "https://your-api.com/webhook"
}

Parameters Explained

• country - Target country for trending videos
• numberOfVideos - How many trending videos to fetch (1-100)
• downloadCoverImage - Get thumbnail images
• downloadVideo - Get no-watermark video URLs
• generatePermalinks - Generate permanent storage links for videos (see Permalink feature below)
• useApifyProxy - Use Apify's proxy service (recommended)
• proxyType - DATACENTER (free) or RESIDENTIAL (better success)
• webhookUrl (optional) - Your API endpoint to receive the scraped data

📤 Output Format

{
  "video_id": "7234567890123456789",
  "url": "https://www.tiktok.com/@username/video/7234567890123456789",
  "title": "Video caption/description",
  "author": "username",
  "author_nickname": "Display Name",
  "views": 1500000,
  "likes": 250000,
  "shares": 15000,
  "comments": 5000,
  "trending_position": 1,
  "country": "United States",
  "stats": {
    "views": 1500000,
    "likes": 250000,
    "shares": 15000,
    "comments": 5000
  },
  "media_urls": {
    "video": "https://...",  // no-watermark URL
    "cover": "https://..."   // thumbnail URL
  },
  "music": {
    "title": "Song Name",
    "author": "Artist Name"
  },
  "created_at": "2024-01-15T10:30:00Z",
  "permalink": "https://..."  // Only if generatePermalinks is true
}

🚀 Quick Start

Using Apify Console

1. Click "Try for free" button
2. Select your country
3. Set number of videos
4. Choose proxy type (RESIDENTIAL recommended)
5. Click "Start"
6. Get results in JSON!

Using API

// Node.js example
const { ApifyClient } = require('apify-client');

const client = new ApifyClient({
    token: 'YOUR_API_TOKEN',
});

const input = {
    country: "United States",
    numberOfVideos: 50,
    useApifyProxy: true,
    proxyType: "RESIDENTIAL"
};

const run = await client.actor("fetchly/tiktok-trends-api").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

# Python example
from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run_input = {
    "country": "United States",
    "numberOfVideos": 50,
    "useApifyProxy": True,
    "proxyType": "RESIDENTIAL"
}

run = client.actor("fetchly/tiktok-trends-api").call(run_input=run_input)
items = client.dataset(run["defaultDatasetId"]).list_items().items

for item in items:
    print(f"#{item['trending_position']}: {item['title'][:50]}...")
    print(f"Views: {item['views']:,}, Likes: {item['likes']:,}")

🎯 Use Cases

• 📈 Trend Analysis - Track what's going viral in different countries
• 🎬 Content Creation - Find trending sounds and formats for your content
• 🏢 Market Research - Understand regional content preferences
• 📊 Competitive Intelligence - Monitor competitor viral content
• 🤖 Automation - Auto-post trending content to your platforms

⚙️ Advanced Features

🔗 Permalink Feature (NEW!)

Generate permanent storage links for TikTok videos that never expire:

• What it does: Automatically uploads videos to a permanent storage server
• How to enable: Set generatePermalinks: true in your input
• Output: Adds a permalink field to each video with a permanent URL
• Benefits:
  • ✅ Links never expire (unlike TikTok CDN URLs which expire in 2-3 hours)
  • ✅ Direct download support (no authentication needed)
  • ✅ Reliable long-term storage for your collected videos
  • ✅ Perfect for archiving viral content

Media Downloads

The scraper provides video and cover image URLs:

• Video URLs: When downloadVideo is enabled, the video files are stored on APIFY.
• Cover URLs: When downloadCoverImage is enabled, cover image URLs are stored on APIFY.
• Webhook integration: Use the webhookUrl parameter to send JSON data to your API

Proxy Configuration

For best results, use RESIDENTIAL proxies:

• ✅ 90%+ success rate
• ✅ Avoid TikTok blocks
• ✅ Accurate geo-location

Custom Proxies

You can also use your own proxies:

{
  "useApifyProxy": false,
  "proxies": [
    {
      "host": "proxy.example.com",
      "port": 8080,
      "username": "user",
      "password": "pass"
    }
  ]
}

📊 Performance Metrics

• Speed: ~100 videos in 2-3 minutes
• Success Rate: 90%+ with residential proxies
• Data Freshness: Real-time trending data

🆚 Why Choose Us?

Feature	Us	Competitors
Success Rate	90%+ ✅	Varies
No-watermark URLs	✅	✅
Cover images	✅	✅
Multi-country	✅ 9 countries	Varies
Documentation	✅ Detailed	Basic
Support	✅ Fast response	Varies
Reliability	✅ Enterprise-grade	Varies

🔧 Troubleshooting

"No videos found"

• Switch to RESIDENTIAL proxies
• Try a different country
• Reduce number of videos per run

"Rate limited"

• Add delays between runs
• Use proxy rotation
• Spread requests over time

"CAPTCHA detected"

• Use RESIDENTIAL proxies (recommended)
• Reduce request frequency

💬 Support

• Need help? Reach out to us at hello@fetchly.cc

🏷️ Tags

tiktok trends scraper api no-watermark viral social-media data-extraction

---

Ready to start? Click "Try for free" and experience reliable TikTok trend data collection!