TikTok Profile Scraper - Posts

Este actor permite scrapear videos de perfiles de TikTok usando usernames específicos. Los resultados incluyen información detallada de cada video, estadísticas y datos del autor.

---

Input

El input debe enviarse como JSON y soporta los siguientes campos:

Campo	Tipo	Descripción	Opciones	Valor por defecto
Profile(s)	array de strings	Lista de usernames de TikTok que quieres scrapear. Se puede agregar uno por línea.	N/A	N/A
Profile sections to scrape	string	Si el perfil tiene videos repostados, puedes scrapearlos seleccionando Reposts.	Videos, Reposts	Videos
Profile video sorting	string	Orden de los videos del perfil.	Simple, Popular, Oldest, Liked	Simple
Minimum post date	string	Fecha mínima de publicación a incluir (YYYY-MM-DD).	N/A	N/A
Maximum post date	string	Fecha máxima de publicación a incluir (YYYY-MM-DD).	N/A	N/A
Number of results by line	integer	Número de videos a scrapear por perfil. Rango permitido: 1-200.	N/A	50

Ejemplo de input:

{
  "Profile(s)": ["taylorswift", "charlidamelio"],
  "Profile sections to scrape": "Videos",
  "Profile video sorting": "Latest",
  "minDate": "2025-10-01",
  "maxDate": "2025-10-10",
  "resultsLimit": 100
}

---

Output

El actor devuelve un array de objetos JSON, cada uno representando un video:

Campo	Tipo	Descripción
type	string	Tipo de contenido, siempre "Videos"
search	string	Username del perfil
video_id	string	ID único del video
link_post	string	URL directa del video
desc	string	Descripción del video
post_date	string	Fecha de publicación (YYYY-MM-DD HH:MM:SS)
create_time	integer	Timestamp de creación
text_language	string	Idioma detectado del texto
is_ad	boolean	Indica si es contenido promocionado
hashtags	array	Hashtags del video
music.title	string	Título de la música usada
music.author_name	string	Autor de la música
music.id	string	ID de la música
music.cover	string	URL de la portada de la música
video.play_url	string	URL para reproducir el video
video.duration	integer	Duración en segundos
video.height	integer	Altura del video en px
video.width	integer	Ancho del video en px
stats.play_count	integer	Reproducciones
stats.comment_count	integer	Comentarios
stats.share_count	integer	Shares
stats.digg_count	integer	Likes
stats.collect_count	integer	Guardados
author.unique_id	string	Username del autor
author.nickname	string	Nombre del autor
author.id	string	ID interno del autor
author.verified	boolean	Si está verificado
author.signature	string	Bio del autor
author.avatar	string	URL del avatar
author.follower_count	integer	Seguidores
author.following_count	integer	Siguiendo
author.heart_count	integer	Total de likes recibidos
author.video_count	integer	Total de videos publicados
link_user	string	URL del perfil

Ejemplo de output:

[
  {
    "type": "Videos",
    "search": "taylorswift",
    "video_id": "7559313483398008095",
    "link_post": "https://www.tiktok.com/@taylorswift/video/7559313483398008095",
    "desc": "Never been accused of not keeping it 💯",
    "post_date": "2025-10-09 19:57:14",
    "create_time": 1760039834,
    "text_language": "en",
    "is_ad": false,
    "hashtags": [],
    "music.title": "The Fate of Ophelia",
    "music.author_name": "Taylor Swift",
    "music.id": "7556815852168759313",
    "music.cover": "https://p16-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/oQewhAfrNQKV6AteGNQAhmGGAjcLIMrYKAnexf.jpeg",
    "video.play_url": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/owf0qgRRGrlcCCJWAIe0ARAH6L6wKRII0EYjfQ/?a=1988...",
    "video.duration": 60,
    "video.height": 1024,
    "video.width": 576,
    "stats.play_count": 5700000,
    "stats.comment_count": 8927,
    "stats.share_count": 21800,
    "stats.digg_count": 1100000,
    "stats.collect_count": 38300,
    "author.unique_id": "taylorswift",
    "author.nickname": "Taylor Swift",
    "author.id": "6881290705605477381",
    "author.verified": true,
    "author.signature": "This is pretty much just a cat account",
    "author.avatar": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/c39c2807c155535cf328225955e00aba~tplv-tiktokx-cropcenter:720:720.jpeg",
    "author.follower_count": 33100000,
    "author.following_count": 0,
    "author.heart_count": 258300000,
    "author.video_count": 76,
    "link_user": "https://www.tiktok.com/@taylorswift"
  }
]

---

Ejecución

1. Subir el actor a Apify.
2. Configurar los inputs según los perfiles y fechas deseadas.
3. Ejecutar el actor.
4. Descargar los resultados en formato JSON o CSV según tu necesidad.

---

Notas

• Puedes usar minDate y maxDate para filtrar los videos por fecha de publicación.
• resultsLimit define cuántos videos se descargarán por perfil (máximo 200).
• La opción Profile video sorting permite seleccionar entre los videos más recientes, más antiguos, populares o más gustados.

---

Este README ya está listo para subir a tu actor en Apify.