Você precisa obter programaticamente o perfil e as estatísticas de seguidores de um usuário do TikTok pelo nome de usuário, e precisa que isso funcione esta semana. Ao final deste guia, você irá recuperar detalhes do usuário (ID, apelido, verificação, contagem de seguidores e mais) usando um único HTTP GET, e você saberá como encadear isso na recuperação de vídeos e detalhes de itens.
Por que esta API e o que ela retorna
A API Pública de Mídia do TikTok no Zyla API Hub expõe endpoints somente leitura para puxar dados públicos do TikTok. Com ela, você pode:
- Resolver um nome de usuário do TikTok para um perfil completo (ID, secUid, apelido, URLs de avatar, status de verificação e estatísticas de seguidores).
- Buscar os vídeos postados por um usuário via seu secUid.
- Obter informações detalhadas para um vídeo ou foto específica do TikTok por URL ou ID.
Isso é útil para painéis sociais, enriquecimento de CRM, análises de criadores, monitoramento de conteúdo e automações do lado do servidor que precisam de acesso reproduzível aos metadados públicos do TikTok.
O Zyla API Hub centraliza milhares de APIs sob uma chave e um modelo de assinatura. Você pode explorar mais de 10.000 APIs públicas em zylalabs.com e se inscrever sem gerenciar vários fornecedores.
Começando no Zyla API Hub
Para experimentar esses endpoints, abra a listagem da API Pública de Mídia do TikTok e comece um teste. Você receberá uma chave de API para colocar no cabeçalho de Autorização.
- Vá para a listagem: Comece o teste de 7 dias na API Pública de Mídia do TikTok.
- Clique em Inscrever-se ou Começar Teste Gratuito (quando disponível) para obter sua chave.
- Use Authorization: Bearer YOUR_API_KEY em cada solicitação.
A cobrança é por assinatura + cota (não por chamada). Para opções de acesso e preços atuais, sempre verifique a página da API. Você também pode navegar por outras categorias em Zyla API Hub com a mesma conta e chave.
Endpoints que você usará
1) Obter Detalhes do Usuário — resolver um nome de usuário para perfil e estatísticas
Método: GET
URL: https://zylalabs.com/api/12389/tiktok-public-media-api/23413/get-user-detail
Descrição: Recupere informações detalhadas do perfil de um usuário do TikTok usando seu nome de usuário. Retorna metadados do usuário, como contagem de seguidores, contagem de seguidos e detalhes do perfil.
Parâmetro necessário: username (string)
Exemplo com username = _ttqueen:
curl -s -X GET "https://zylalabs.com/api/12389/tiktok-public-media-api/23413/get-user-detail?username=_ttqueen" \
-H "Authorization: Bearer YOUR_API_KEY"
Exemplo de resposta oficial:
{
"data": {
"id": "6644110999556227073",
"nickname": "Quynh Truong",
"signature": "Thấy mình đáng iu thì fl mình nhé hehee
💬For work: 097.136.3242",
"hdAvatarUrlList": [
"https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-avt-0068/dcb917fff48aacab462620b08f13b4e0~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=c1870c0f&x-expires=1790154000&x-signature=nO62jhA4bUQvXuz5YAr8WEwl6ns%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a"
],
"uniqueId": "_ttqueen",
"secUid": "MS4wLjABAAAA6e26Ok_w7ReVcKXUIZoygasHXTl9ZPPvhmuTQz1GGRaMU5RLQk6-yftHzzfIfr9L",
"isVerified": false,
"statistics": {
"followerCount": 3100000,
"followingCount": 139,
"friendCount": 84,
"heartCount": 117100000,
"videoCount": 559,
"diggCount": 0
}
}
}
Campos principais que você realmente usará:
data.id: ID interno do usuário que você pode armazenar como uma chave estável.data.uniqueIdedata.nickname: identificador e nome de exibição para a interface do usuário.data.hdAvatarUrlList: URLs de avatar de alta qualidade.data.isVerified: indicador de verificação.data.statistics: contagens de seguidores/seguidos/corações/vídeos para KPIs.data.secUid: necessário para recuperar os vídeos de um usuário com o próximo endpoint.
2) Obter lista de vídeos — listar vídeos por secUid
Método: GET
URL: https://zylalabs.com/api/12389/tiktok-public-media-api/23414/get-video-list
Descrição: Recupere uma lista de vídeos postados por um usuário do TikTok usando seu secUid. Retorna metadados de vídeo, incluindo IDs, descrições e estatísticas.
Parâmetro necessário: secUid (string)
Você obtém secUid da resposta de Obter Detalhes do Usuário. Forneça-o a este endpoint para enumerar as postagens do criador.
Exemplo de formato de URL de solicitação (não se esqueça do cabeçalho de Autorização):
https://zylalabs.com/api/12389/tiktok-public-media-api/23414/get-video-list?secUid=MS4wLjABAAAA6e26Ok_w7ReVcKXUIZoygasHXTl9ZPPvhmuTQz1GGRaMU5RLQk6-yftHzzfIfr9L
3) Obter Detalhes de Vídeo ou Foto — inspecionar uma postagem específica
Método: GET
URL: https://zylalabs.com/api/12389/tiktok-public-media-api/23415/get-video-or-photo-details
Descrição: Recupere detalhes do vídeo do TikTok por ID ou URL, incluindo estatísticas de descrição, informações do autor e URLs de mídia.
Parâmetro necessário: idOrUrl (string)
Forneça uma URL de item do TikTok ou seu ID para receber metadados detalhados para aquela única postagem. Exemplo de valor de parâmetro:
https://www.tiktok.com/@khaby.lame/video/7661681676719869214?lang=en
Fluxo de trabalho: do nome de usuário aos detalhes do usuário (e além)
- Chame Obter Detalhes do Usuário com o nome de usuário alvo para resolver:
- Identidade do usuário e avatar: exibir na sua página de perfil ou registro de CRM.
- Contagens de seguidores e vídeos: preencher métricas e indicadores de saúde.
- secUid: armazene-o; você precisará dele para listar vídeos.
- Opcionalmente, chame Obter lista de vídeos com o secUid retornado para enumerar conteúdo recente para feeds ou análises.
- Opcionalmente, chame Obter Detalhes de Vídeo ou Foto com uma URL ou ID de vídeo selecionado para análises profundas (por exemplo, mostrar detalhes por postagem ao clicar).
Exemplo rápido em Python: obter detalhes do usuário e ler campos principais
Este exemplo chama Obter Detalhes do Usuário, extrai as informações básicas do perfil e as estatísticas de seguidores, e mostra como manter o secUid se você planeja buscar vídeos depois.
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
BASE_USER_DETAIL = "https://zylalabs.com/api/12389/tiktok-public-media-api/23413/get-user-detail"
def get_user_detail(username: str) -> dict:
url = f"{BASE_USER_DETAIL}?username={username}"
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, headers=headers, timeout=30)
resp.raise_for_status()
return resp.json()
if __name__ == "__main__":
username = "_ttqueen"
data = get_user_detail(username)
user = data.get("data", {})
stats = user.get("statistics", {})
print("User ID:", user.get("id"))
print("Unique ID:", user.get("uniqueId"))
print("Nickname:", user.get("nickname"))
print("Verified:", user.get("isVerified"))
print("Avatar URL:", (user.get("hdAvatarUrlList") or [None])[0])
print("Followers:", stats.get("followerCount"))
print("Following:", stats.get("followingCount"))
print("Hearts:", stats.get("heartCount"))
print("Video Count:", stats.get("videoCount"))
print("secUid (for video list):", user.get("secUid"))
Notas:
- A autorização é um cabeçalho Bearer com sua chave da listagem da API.
- Sempre verifique se há campos ausentes antes de indexar para evitar KeyError.
- Persista
idouuniqueIdcomo sua chave estrangeira local, e mantenhasecUidse você for buscar vídeos depois.
Detalhes práticos que economizam tempo
- Autenticação: Todos os endpoints requerem o cabeçalho de Autorização exatamente como Authorization: Bearer YOUR_API_KEY.
- Atualidade dos dados: Trate as contagens de seguidores e corações como valores pontuais. Se você armazenar em cache, decida sua cadência de atualização com base nas necessidades do seu produto.
- Carimbos de data/hora: Ao buscar vídeos, você verá valores numéricos
createdAt. Normalize-os em sua aplicação para seu fuso horário e formato desejados. - Identificadores: Armazene tanto
idquantouniqueIdpara resiliência;secUidé necessário para listar os vídeos de um usuário. - Tratamento de erros: Use códigos de status HTTP e a presença/ausência de campos para ramificar a lógica. Registre a URL da solicitação e o nome de usuário para tentativas.
- Limites: A API utiliza um modelo de assinatura + cota. Verifique a listagem para seus limites atuais e o teste gratuito de 7 dias disponível.
Casos de uso que você pode implementar esta semana
- Widget de pesquisa de criadores: Digite um nome de usuário, mostre instantaneamente o avatar, o crachá de verificação e a contagem de seguidores.
- Enriquecimento de CRM: Armazene IDs do TikTok e estatísticas de seguidores ao lado dos registros de influenciadores.
- Ferramentas de moderação/curadoria: Resolva um identificador, depois busque seus vídeos para construir filas de revisão ou destaques.
- Trabalhos de relatórios: Tarefas noturnas que atualizam contagens de seguidores, corações e vídeos para alimentar painéis de análise.
Chamando esta API de agentes de IA via MCP
Se você automatiza com assistentes de código ou IDEs agentes, pode chamar qualquer API Zyla via o endpoint MCP. Configure seu cliente compatível com MCP para apontar para:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Isso torna a API Pública de Mídia do TikTok chamável como uma ferramenta de clientes como Claude Code, Cursor, Windsurf e outros. Para mais informações, veja a página MCP.
Encadeando os outros endpoints (padrões opcionais)
Obter os vídeos de um usuário após resolver o perfil
Uma vez que você leia secUid de Obter Detalhes do Usuário, envie-o para:
GET https://zylalabs.com/api/12389/tiktok-public-media-api/23414/get-video-list?secUid=MS4wLjABAAAA6e26Ok_w7ReVcKXUIZoygasHXTl9ZPPvhmuTQz1GGRaMU5RLQk6-yftHzzfIfr9L
Use isso para preencher uma aba de “Uploads Recentes” ou para executar análises em itens.
Obter detalhes de um item específico
Quando um usuário clica em um vídeo na sua interface, busque detalhes profundos passando a URL ou ID do TikTok para:
GET https://zylalabs.com/api/12389/tiktok-public-media-api/23415/get-video-or-photo-details?idOrUrl=https%3A%2F%2Fwww.tiktok.com%2F%40khaby.lame%2Fvideo%2F7661681676719869214%3Flang%3Den
Isso é útil para páginas de nível de item, prévias e desdobramentos de links do lado do servidor.
Lista de verificação de verificação de um minuto
- O cabeçalho de autorização está presente e formatado corretamente.
- A string do nome de usuário está codificada em URL quando necessário.
- Armazene
id,uniqueIdesecUiddo perfil do usuário para operações subsequentes. - Trate arrays vazios como
hdAvatarUrlListde forma elegante. - Registre URLs de solicitações para relatórios de bugs reproduzíveis.
FAQ
Como autentico minhas solicitações?
Inclua Authorization: Bearer YOUR_API_KEY em cada chamada. Obtenha sua chave na listagem da API após se inscrever ou iniciar o teste.
Onde eu consigo o secUid necessário para o endpoint da lista de vídeos?
Chame Obter Detalhes do Usuário com o nome de usuário; a resposta inclui data.secUid. Use esse valor com Obter lista de vídeos.
Posso passar uma URL de vídeo do TikTok diretamente para obter detalhes?
Sim. Use Obter Detalhes de Vídeo ou Foto e defina o parâmetro idOrUrl para a URL do TikTok ou para o ID do item.
Quais são os preços e cotas?
O acesso é por assinatura + cota (não por chamada). Verifique a página da API para opções de acesso atuais. Um teste de 7 dias está disponível na listagem.
Há um Plano Gratuito?
Não há Plano Gratuito. Use o teste de 7 dias na listagem para avaliar, depois escolha uma assinatura que se adapte ao seu uso.
Pronto para implementar sua integração de detalhes do usuário? Obtenha sua chave e comece a testar com os endpoints oficiais aqui: Comece o teste de 7 dias na API Pública de Mídia do TikTok. Uma conta e uma chave funcionam em milhares de APIs no Zyla API Hub.