Endpoints del TikTok Scraper

Seleccione el actor de TikTok para los datos que necesite. Cada operación utiliza el mismo endpoint de solicitud HTTP, pero su actor y campos de entrada difieren.

Solicitud y autenticación

POST https://api.scrapeless.com/api/v1/scraper/request
x-api-token: YOUR_API_KEY
Content-Type: application/json

Reemplace YOUR_API_KEY con su clave de API de Scrapeless. Envíe un objeto JSON que contenga actor y input.

Elija una operación

Detalles del usuario

Pase el nombre de usuario de la cuenta en unique_id, como se muestra en el ejemplo oficial:

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"
  }
}'

La respuesta publicada incluye account_id, unique_id, sec_uid, nickname, profile_url, avatar, statistics, y banderas de cuenta como is_verified.

Guarde sec_uid si desea llamar a Trabajo del usuario. Un nombre de usuario, ID de cuenta y sec_uid son valores distintos; no sustituya uno por otro.

Referencia de la API de detalles del usuario

Trabajo del usuario

Recupere las publicaciones de una cuenta utilizando su sec_uid. La solicitud siguiente utiliza el mismo identificador de cuenta que la respuesta oficial de Detalles del usuario; sustitúyalo por el sec_uid de su propia solicitud completada 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.work",
  "input": {
    "sec_uid": "MS4wLjABAAAAIb0gpCf24bC1i5TWl87J5SjS0h7ZB59nfledznAyQ_DF7-vpgJJ8nYfzo98Ba3fp",
    "cursor": "0",
    "count": 10
  }
}'

El ejemplo exitoso contiene un array items . Este extracto conserva campos seleccionados del primer elemento:

{
  "items": [
    {
      "post_id": "7673888001365150989",
      "post_url": "https://www.tiktok.com/@teamtrump/video/7673888001365150989",
      "play_count": 572300,
      "like_count": 31000
    }
  ]
}

El elemento completo también incluye información del video y del autor. La documentación menciona un campo de entrada cursor, pero su ejemplo de respuesta no incluye un cursor de página siguiente ni campo has_more . No construya un bucle de paginación que asuma la existencia de cualquiera de estos campos.

Referencia de la API de Trabajo del usuario

Página de tienda

Recupere detalles del producto con un ID de producto de TikTok Shop y una región. Ambas entradas son cadenas obligatorias. Esta solicitud conserva el valor gb del ejemplo oficial:

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.shop.page",
  "input": {
    "product_id": "1729411983267761850",
    "region": "gb"
  }
}'

El valor devuelto en region representa la región real en la página del producto. Este subconjunto del ejemplo publicado muestra los tipos de campo; los precios y conteos son valores históricos del ejemplo:

{
  "product_id": "1729411983267761850",
  "region": "GB",
  "sold_count": "17644",
  "price": {
    "currency": "GBP",
    "sale_price": "5.78"
  },
  "rating": 4.5,
  "review_count": "823"
}

El ejemplo completo también incluye stock, images, options, skus, seller y shipping_options. Mantenga los IDs de producto como cadenas; el ejemplo también representa sold_count, review_count y price.sale_price como cadenas.

Referencia de la API de Página de tienda

Manejar los resultados de la tarea

Una respuesta HTTP 200 contiene el resultado completado. Una respuesta HTTP 201 significa que el procesamiento aún está en curso; guarde su taskId y recupere esa tarea con:

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

Reemplace YOUR_TASK_ID con el ID devuelto por su solicitud. Siga las indicaciones de Resultados e interrupciones periódicas para conocer los intervalos de sondeo y los límites de reintento.

Revise también los cuerpos de error además de los códigos de estado HTTP. Una respuesta 400 puede incluir code: 20500 y message: "scraping failed"; no constituye una respuesta de datos exitosa. Verifique el destino y las entradas de la solicitud antes de reintentar.

Ejemplos de respuesta

Los extractos en esta página son subconjuntos de ejemplos oficiales de la API, no resultados en vivo de las solicitudes de ejemplo. Lea la referencia de la operación vinculada para obtener la carga completa y maneje los valores ausentes según las necesidades de su aplicación.