TikTok Video Scraper

🇺🇸 English | 🇧🇷 Português

Extract video data from TikTok profiles: views, likes, comments, shares, music info, hashtags, and cover images. Supports multiple input formats. No API key needed.

✨ Features

• 📊 Complete video metrics — plays, likes, comments, shares, bookmarks
• 🎵 Music metadata — song title, artist, album, duration
• 🏷️ Hashtags & challenges — extracted from video descriptions
• 🖼️ Cover images — default, origin, and dynamic covers
• 👤 Author info — username, nickname, avatar
• 🔄 Flexible input — accepts arrays, strings, URLs, and workflow formats
• ✅ Validated output — every item checked before delivery
• 🌐 Apify Proxy — built-in proxy support for reliability

📥 Input

Field	Type	Default	Description
profiles	string[]	—	TikTok usernames (with or without @)
maxItems	integer	12	Maximum videos per profile (1–100)
startUrls	URL[]	—	Alternative: TikTok profile URLs

Input Formats

The actor accepts multiple input formats:

// Array of strings
{ "profiles": ["@charlidamelio", "khaby.lame"] }

// Single string (comma-separated)
{ "profiles": "charlidamelio, khaby.lame" }

// URL format
{ "startUrls": [{ "url": "https://www.tiktok.com/@charlidamelio" }] }

📤 Output

Each video produces one object:

Field	Type	Description
id	string	TikTok video ID
webVideoUrl	string	Full video URL
desc	string	Video description/caption
createTime	string	ISO timestamp
playCount	integer	Number of views/plays
diggCount	integer	Number of likes
commentCount	integer	Number of comments
shareCount	integer	Number of shares
collectCount	integer	Number of favorites/bookmarks
covers	object	{ default, origin, dynamic } cover image URLs
duration	integer	Duration in seconds
hashtags	string[]	Challenge/hashtag names
musicMeta	object	{ title, artist, album, duration, coverUrl }
author	object	{ uniqueId, nickname, avatar }
scrapedAt	string	ISO timestamp of scraping time

Output Example

{
  "id": "7234567890123456789",
  "webVideoUrl": "https://www.tiktok.com/@user/video/7234567890123456789",
  "desc": "Amazing sunset 🌅 #nature #travel",
  "createTime": "2024-01-15T18:30:00.000Z",
  "playCount": 1500000,
  "diggCount": 250000,
  "commentCount": 3200,
  "shareCount": 15000,
  "collectCount": 45000,
  "covers": {
    "default": "https://p16-sign.tiktokcdn.com/...",
    "origin": "https://p16-sign.tiktokcdn.com/...",
    "dynamic": "https://p16-sign.tiktokcdn.com/..."
  },
  "duration": 32,
  "hashtags": ["nature", "travel"],
  "musicMeta": {
    "title": "original sound",
    "artist": "user",
    "album": "",
    "duration": 32,
    "coverUrl": "https://p16-sign.tiktokcdn.com/..."
  },
  "author": {
    "uniqueId": "user",
    "nickname": "User Name",
    "avatar": "https://p16-sign.tiktokcdn.com/..."
  },
  "scrapedAt": "2024-01-15T20:00:00.000Z"
}

📋 Use Cases

• Influencer Analytics — Track video performance and engagement rates
• Competitor Research — Monitor competitors' TikTok strategy
• Hashtag & Challenge Tracking — Discover trending challenges
• Music Trends — Identify popular sounds and songs
• Content Strategy — Analyze what works in your niche
• Market Research — Understand audience engagement patterns
• Reporting — Export data for dashboards and presentations

❓ FAQ

Q: Do I need a TikTok API key? A: No! This actor works without any API credentials.

Q: Can I scrape private profiles? A: No, only public profiles are supported.

Q: What proxy should I use? A: Apify Proxy is recommended. Residential proxies give the best results for TikTok.

Q: How many videos can I get per profile? A: Up to 100 videos per profile per run.

Q: Does it include music information? A: Yes! The musicMeta field includes song title, artist, album, and duration.

Q: Does it include bookmark/save counts? A: Yes! The collectCount field shows how many users saved the video.

🔗 Related Actors

• Instagram Reels Scraper — Instagram metrics
• YouTube Fast Scraper — YouTube video data
• Reddit Scraper — Reddit posts and comments

📝 Changelog

v1.2 (Current)

• ✅ Improved extraction reliability
• ✅ Better handling of various input formats
• ✅ Added collectCount (bookmarks/favorites)
• ✅ Enhanced proxy support

v1.1

• ✅ Output validation
• ✅ Music metadata extraction

v1.0

• Initial release

---

TikTok Video Scraper

🇺🇸 English | 🇧🇷 Português

Extraia dados de vídeos de perfis TikTok: visualizações, curtidas, comentários, compartilhamentos, info de música, hashtags e imagens de capa. Suporta múltiplos formatos de entrada. Sem necessidade de API key.

✨ Funcionalidades

• 📊 Métricas completas — plays, curtidas, comentários, compartilhamentos, favoritos
• 🎵 Metadados de música — título, artista, álbum, duração
• 🏷️ Hashtags e challenges — extraídas das descrições
• 🖼️ Imagens de capa — default, origin e dynamic
• 👤 Info do autor — username, nickname, avatar
• 🔄 Entrada flexível — aceita arrays, strings, URLs e formatos de workflow
• ✅ Output validado — cada item verificado antes da entrega
• 🌐 Apify Proxy — suporte a proxy integrado para confiabilidade

�� Entrada

Campo	Tipo	Padrão	Descrição
profiles	string[]	—	Usernames TikTok (com ou sem @)
maxItems	integer	12	Máximo de vídeos por perfil (1–100)
startUrls	URL[]	—	Alternativa: URLs de perfis TikTok

Formatos de Entrada

O actor aceita múltiplos formatos:

// Array de strings
{ "profiles": ["@charlidamelio", "khaby.lame"] }

// String única (separada por vírgula)
{ "profiles": "charlidamelio, khaby.lame" }

// Formato URL
{ "startUrls": [{ "url": "https://www.tiktok.com/@charlidamelio" }] }

📤 Saída

Cada vídeo produz um objeto:

Campo	Tipo	Descrição
id	string	ID do vídeo TikTok
webVideoUrl	string	URL completa do vídeo
desc	string	Descrição/legenda do vídeo
createTime	string	Timestamp ISO
playCount	integer	Número de visualizações
diggCount	integer	Número de curtidas
commentCount	integer	Número de comentários
shareCount	integer	Número de compartilhamentos
collectCount	integer	Número de favoritos/salvos
covers	object	{ default, origin, dynamic } URLs das capas
duration	integer	Duração em segundos
hashtags	string[]	Nomes de challenges/hashtags
musicMeta	object	{ title, artist, album, duration, coverUrl }
author	object	{ uniqueId, nickname, avatar }
scrapedAt	string	Timestamp ISO do momento da coleta

📋 Casos de Uso

• Análise de influenciadores — Acompanhe performance de vídeos e taxas de engajamento
• Pesquisa de concorrentes — Monitore a estratégia TikTok dos concorrentes
• Tracking de hashtags e challenges — Descubra challenges em alta
• Tendências de música — Identifique sons e músicas populares
• Estratégia de conteúdo — Analise o que funciona no seu nicho
• Pesquisa de mercado — Entenda padrões de engajamento do público
• Relatórios — Exporte dados para dashboards e apresentações

❓ Perguntas Frequentes

P: Preciso de API key do TikTok? R: Não! Este actor funciona sem nenhuma credencial de API.

P: Posso raspar perfis privados? R: Não, apenas perfis públicos são suportados.

P: Qual proxy devo usar? R: Apify Proxy é recomendado. Proxies residenciais dão melhores resultados para TikTok.

P: Quantos vídeos consigo por perfil? R: Até 100 vídeos por perfil por execução.

P: Inclui informações de música? R: Sim! O campo musicMeta inclui título, artista, álbum e duração.

P: Inclui contagem de favoritos/salvos? R: Sim! O campo collectCount mostra quantos usuários salvaram o vídeo.

🔗 Actors Relacionados

• Instagram Reels Scraper — Métricas do Instagram
• YouTube Fast Scraper — Dados de vídeos do YouTube
• Reddit Scraper — Posts e comentários do Reddit