Início rápido do TikTok Scraper

Recupere o perfil de uma conta do TikTok com o Actor User Detail. Este passo a passo usa o nome de usuário e a requisição do exemplo oficial de User Detail.

Antes de começar

Você precisa de uma conta Scrapeless, uma chave de API válida e cURL. Obtenha sua chave no painel da Scrapeless.

1. Envie uma requisição de perfil

Substitua YOUR_API_KEY pela sua chave. Você pode substituir teamtrump pelo nome de usuário que deseja recuperar. Assim como no exemplo oficial, passe o próprio nome de usuário em vez de uma 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 seleciona scraper.tiktok.user.detail. O campo obrigatório input.unique_id identifica a conta.

2. Leia um resultado concluído

Uma resposta HTTP 200 retorna os dados do perfil. Este é um subconjunto do exemplo de resposta publicado, não uma captura nova:

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

O exemplo completo também inclui avatar e statistics. Seus valores de estatísticas são strings. Salve o sec_uid real do seu resultado concluído se quiser requisitar as postagens da conta com User Work.

3. Recupere uma tarefa que ainda está em processamento

Se você receber HTTP 201, leia o taskId da resposta e substitua YOUR_TASK_ID abaixo:

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

Use Resultados e Polling para intervalos de polling e limites de repetição. Reutilize o ID da tarefa retornado em vez de criar uma requisição de perfil duplicada.

Se a requisição falhar

Inspecione o status HTTP e o corpo da resposta. A referência do User Detail documenta uma resposta 400 com code e message, e inclui o exemplo de erro code: 20500, message: "scraping failed". Verifique o nome de usuário de entrada e a autenticação antes de tentar novamente.

Próximos passos

Continue para Endpoints para requisitar postagens usando sec_uid ou recuperar um produto da Shop usando product_id e region.

Introdução Endpoints