Inicio rápido del raspador de TikTok

Recupere un perfil de cuenta de TikTok con el actor Detalle de Usuario. Este tutorial utiliza el nombre de usuario y la solicitud del ejemplo oficial de Detalle de Usuario.

Antes de comenzar

Necesita una cuenta de Scrapeless, una clave de API válida y cURL. Obtenga su clave desde el panel de control de Scrapeless.

1. Envíe una solicitud de perfil

Reemplace YOUR_API_KEY con su clave. Puede reemplazar teamtrump con el nombre de usuario que desea recuperar. Como en el ejemplo oficial, pase el nombre de usuario directamente en lugar de una URL de perfil.

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.tiktok.user.detail",
  "input": {
    "unique_id": "teamtrump"
  }
}'

actor selecciona scraper.tiktok.user.detail. El input.unique_id requerido identifica la cuenta.

2. Lea un resultado completado

Una respuesta HTTP 200 devuelve los datos del perfil. Este es un subconjunto del ejemplo de respuesta publicado, no una captura reciente:

{
  "account_id": "7365161718782395438",
  "unique_id": "teamtrump",
  "sec_uid": "MS4wLjABAAAAIb0gpCf24bC1i5TWl87J5SjS0h7ZB59nfledznAyQ_DF7-vpgJJ8nYfzo98Ba3fp",
  "nickname": "Team Trump",
  "profile_url": "https://www.tiktok.com/@teamtrump",
  "is_verified": true
}

El ejemplo completo también incluye avatar y statistics. Sus valores de estadísticas son cadenas. Guarde el sec_uid real de su resultado completado si desea solicitar las publicaciones de la cuenta con Trabajo de Usuario.

3. Recupere una tarea que aún está procesándose

Si recibe HTTP 201, lea taskId de la respuesta y reemplace YOUR_TASK_ID abajo:

curl --request GET 'https://api.scrapeless.com/api/v1/scraper/result/YOUR_TASK_ID' \
  --header 'x-api-token: YOUR_API_KEY'

Utilice Resultados y sondeo para intervalos de sondeo y límites de reintento. Reutilice el ID de tarea devuelto en lugar de crear una solicitud de perfil duplicada.

Si la solicitud falla

Revise el estado HTTP y el cuerpo de la respuesta. La documentación de referencia de Detalle de Usuario describe una respuesta 400 con code y message, e incluye el ejemplo de error code: 20500, message: "scraping failed". Verifique el nombre de usuario de entrada y la autenticación antes de reintentar.

Próximos pasos

Continúe con Endpoints para solicitar publicaciones usando sec_uid o recuperar un producto de tienda usando product_id y region.

Introducción Endpoints