API do TikTok

A API do TikTok permite consultar perfis de usuários, listar vídeos, ler comentários e respostas, pesquisar vídeos e usuários, explorar hashtags e percorrer o grafo social (seguidores / seguindo). Onze endpoints, todos a 1 crédito por requisição.

Endpoints

Autenticação

Toda resposta bem-sucedida inclui campos de rastreamento de crédito: credits_used, credits_remaining e response_time (ms).

Obtendo um sec_user_id

A maioria dos endpoints requer um sec_user_id em vez de um nome de usuário. Chame primeiro o endpoint Perfil com um nome de usuário e, em seguida, use data.user.sec_uid para requisições subsequentes.

Perfil do Usuário

POST https://api.scavio.dev/api/v1/tiktok/profile

Obter perfil de usuário do TikTok. Informe ou username ou sec_user_id.

Corpo da Requisição

Exemplo

curl -X POST 'https://api.scavio.dev/api/v1/tiktok/profile' \
  -H 'Authorization: Bearer SUA_CHAVE_API' \
  -H 'Content-Type: application/json' \
  -d '{"username": "tiktok"}'

Campos da Resposta (data.user)

Exemplo de Resposta

{
  "data": {
    "user": {
      "unique_id": "tiktok",
      "nickname": "TikTok",
      "sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
      "uid": "107955",
      "signature": "One TikTok can make a big impact",
      "bio_url": "linktr.ee/tiktok",
      "follower_count": 94015018,
      "following_count": 1,
      "aweme_count": 1510,
      "total_favorited": 457945663
    }
  },
  "response_time": 1245,
  "credits_used": 1,
  "credits_remaining": 11753
}

Posts do Usuário

POST https://api.scavio.dev/api/v1/tiktok/user/posts

Listar os vídeos de um usuário. Requer sec_user_id (obtenha-o do endpoint de perfil).

Corpo da Requisição

Paginação

Use data.max_cursor como cursor na próxima requisição. Pare quando data.has_more for 0.

Campos do Vídeo (data.aweme_list[])

Detalhes do Vídeo

POST https://api.scavio.dev/api/v1/tiktok/video

Obter detalhes completos de um único vídeo.

Corpo da Requisição

Exemplo

curl -X POST 'https://api.scavio.dev/api/v1/tiktok/video' \
  -H 'Authorization: Bearer SUA_CHAVE_API' \
  -H 'Content-Type: application/json' \
  -d '{"video_id": "7350810998023949599"}'

Campos Adicionais (data.aweme_detail)

Inclui todos os campos de vídeo listados acima, além de:

Exemplo de Resposta

{
  "data": {
    "aweme_detail": {
      "aweme_id": "7350810998023949599",
      "desc": "im so sick of being tired im so tired of being sick",
      "create_time": 1711494099,
      "statistics": {
        "digg_count": 2002382,
        "comment_count": 8119,
        "play_count": 12171757,
        "share_count": 274978,
        "collect_count": 211332
      }
    }
  },
  "response_time": 1605,
  "credits_used": 1,
  "credits_remaining": 11752
}

Comentários do Vídeo

POST https://api.scavio.dev/api/v1/tiktok/video/comments

Obter comentários em um vídeo.

Corpo da Requisição

Paginação

Use data.cursor como próximo cursor. Pare quando data.has_more for 0.

Campos do Comentário (data.comments[])

Respostas a Comentários

POST https://api.scavio.dev/api/v1/tiktok/video/comments/replies

Obter respostas a um comentário específico.

Corpo da Requisição

Paginação

Igual aos comentários: use data.cursor, pare quando data.has_more for 0. Cada resposta tem os mesmos campos que um objeto de comentário.

Pesquisar Vídeos

POST https://api.scavio.dev/api/v1/tiktok/search/videos

Pesquisar vídeos do TikTok por palavra-chave.

Corpo da Requisição

Exemplo

curl -X POST 'https://api.scavio.dev/api/v1/tiktok/search/videos' \
  -H 'Authorization: Bearer SUA_CHAVE_API' \
  -H 'Content-Type: application/json' \
  -d '{"keyword": "receita de cozinha", "count": 10, "publish_time": "7"}'

Paginação

Use data.cursor como próximo cursor. Pare quando data.has_more for 0. Cada item em data.aweme_list tem a mesma estrutura que um detalhe de vídeo.

Pesquisar Usuários

POST https://api.scavio.dev/api/v1/tiktok/search/users

Pesquisar usuários do TikTok por palavra-chave.

Corpo da Requisição

Campos da Resposta (data.user_list[].user_info)

Informações da Hashtag

POST https://api.scavio.dev/api/v1/tiktok/hashtag

Obter detalhes e estatísticas da hashtag. Informe ou hashtag_name ou hashtag_id.

Corpo da Requisição

Campos da Resposta

Exemplo de Resposta

{
  "data": {
    "challengeInfo": {
      "challenge": {
        "id": "229207",
        "title": "fyp",
        "desc": "",
        "stats": {
          "videoCount": 0,
          "viewCount": 118798000000000
        }
      }
    }
  },
  "response_time": 892,
  "credits_used": 1,
  "credits_remaining": 11751
}

Vídeos da Hashtag

POST https://api.scavio.dev/api/v1/tiktok/hashtag/videos

Listar vídeos de uma hashtag. Requer hashtag_id (obtenha-o do endpoint de informações da hashtag).

Corpo da Requisição

Paginação

Use data.cursor como próximo cursor. Pare quando data.has_more for 0. A resposta contém data.aweme_list[] com a mesma estrutura de vídeo da pesquisa e dos posts do usuário.

Seguidores do Usuário

POST https://api.scavio.dev/api/v1/tiktok/user/followers

Obter a lista de seguidores de um usuário.

Corpo da Requisição

Paginação

Informe ambos page_token e min_time da resposta anterior. Pare quando data.has_more for false.

Campos do Seguidor (data.followers[])

Seguindo do Usuário

POST https://api.scavio.dev/api/v1/tiktok/user/followings

Obter contas que um usuário segue. Mesma estrutura de requisição e parâmetros que seguidores. A resposta usa data.followings[] em vez de data.followers[].

Referência de Paginação

Notas

• Todos os campos create_time são timestamps Unix em segundos. Multiplique por 1000 para obter um objeto Date no JavaScript.
• Campos de avatar e imagem retornam um objeto com um array url_list. Use .url_list[0] para obter a URL.
• Consulte Erros para saber como lidar com 401, 429 e 502.