Chronometrica vs API Dojo: dados de perfis do TikTok sem coletar publicações

Comece pelo resultado de que seu aplicativo precisa

Uma pergunta pública de um desenvolvedor sobre a coleta de dados do TikTok descreve um aplicativo que precisa de informações de perfis públicos após os métodos anteriores de coleta pararem de funcionar. Isso sustenta uma pergunta prática: qual serviço atende a uma lista conhecida de perfis? Não estabelece qual serviço continuará mais confiável.

Defina por escrito o resultado exigido antes de escolher um Actor. Para uma lista de perfis, esse resultado pode conter um identificador estável da conta, um nome de exibição, uma contagem de seguidores e o horário da observação. Um identificador é um valor usado para associar um registro a uma conta. O horário da observação informa quando os dados foram verificados.

A necessidade de publicações muda a tarefa. Se seu aplicativo precisa mostrar legendas recentes, comparar publicações ou aplicar controles de data das publicações, uma linha de perfil não fornece as evidências exigidas. Uma contagem total de vídeos não contém os vídeos nem seus textos.

Essa distinção também ajuda a escrever uma regra de aceitação clara. Você pode verificar se um perfil retornado contém os campos de que seu aplicativo precisa. Não é necessário avaliar o resultado pelo número total de campos retornados.

Para o caso de coleta exclusiva de perfis, defina o sucesso como uma conta com a identidade confirmada e os dados exigidos. Reserve um lugar para cada entrada não resolvida. Um resultado ausente deve continuar visível para que o aplicativo possa informar os limites dos dados atuais.

Como os contratos dos 2 Actors atendem a cada necessidade

A Chronometrica aceita URLs ou nomes de usuário de perfis públicos do TikTok por meio de `startUrls`. Ela documenta 1 resultado plano, com a identidade confirmada, para cada entrada única. Um resultado plano armazena os campos do perfil juntos em 1 linha. O Actor não coleta vídeos nem listas de seguidores. Esse contrato específico atende a uma lista de perfis fornecida. Contrato da Chronometrica, esquema de entrada.

O API Dojo TikTok Profile Scraper retorna dados de perfis em um fluxo de trabalho voltado a publicações. Suas regras de uso publicadas pedem perfis com pelo menos 10 publicações e alertam contra limites de resultados muito baixos ou uma data de corte muito próxima. Trate essas regras como condições de adequação. Elas não provam que toda execução com um perfil vazio falha. Contrato da API Dojo.

Essas são diferenças de contrato, não diferenças de desempenho medidas. Confira o esquema de entrada da Chronometrica e o esquema de entrada da API Dojo atuais antes de configurar uma tarefa.

Escolha os campos do perfil que tornam uma linha útil

Os campos documentados da Chronometrica abrangem identidade, alguns dados públicos e o estado da observação. Entre os campos relevantes estão `input`, `channelId`, `secUid`, `channelUrl`, `handle`, `displayName`, `description`, `bioLink`, `followersCount`, `followingCount`, `likesCount`, `videosCount`, `countPrecision`, `status`, `statusReason` e `observedAt`. Valores ausentes permanecem como `null`, o que significa que não há valor disponível. Contrato da Chronometrica.

Dê uma finalidade clara a cada campo obrigatório. Por exemplo, seu aplicativo pode usar um identificador da conta para associar registros, `displayName` para identificar visualmente um perfil e `followersCount` para mostrar sua contagem pública. O aplicativo pode armazenar outros dados sem torná-los condições para uma linha útil.

Mantenha a identidade separada dos nomes exibidos. Um nome de exibição ajuda a pessoa a ler a lista. Ele não confirma a identidade da conta. Um nome de usuário pode mudar. Confira os campos de identidade retornados antes de associar novos dados a um registro existente no aplicativo.

Guarde também a entrada original. Ela permite associar a linha retornada ao nome de usuário ou à URL que iniciou a verificação. Isso é relevante quando um nome retornado difere do nome que seu aplicativo armazenou antes. Não aceite essa diferença em silêncio sem conferir a correspondência da conta.

Interprete as contagens dentro de seus limites. Uma contagem de seguidores não identifica os seguidores nem mede a qualidade do público. Uma contagem de vídeos não mostra a qualidade das publicações nem a adequação do criador. Se usar `accountRegion`, trate esse campo como um sinal público da conta. Ele não comprova onde uma pessoa mora. Contrato da Chronometrica.

Defina exigências apenas para os dados que seu aplicativo pode usar. Se o aplicativo precisa de identidade e contagem de seguidores, a ausência de uma biografia não precisa tornar a linha inutilizável. Sua regra de aceitação deve declarar isso antes do início da coleta.

Configure a entrada para coletar apenas perfis

O esquema público atual da Chronometrica tem 1 campo de entrada: `startUrls`. Ele aceita URLs ou nomes de usuário dos perfis públicos a verificar. Não é necessário adicionar um limite de publicações, um filtro de data ou uma opção para coletar apenas perfis. O contrato do Actor já prevê a coleta exclusiva de perfis. Esquema de entrada da Chronometrica.

Este exemplo mínimo passou em uma verificação do esquema. Ele não foi executado, e a disponibilidade atual do perfil de exemplo não foi testada. Substitua a URL por um perfil público que seu aplicativo precisa verificar.

{
  "startUrls": [
    "https://www.tiktok.com/@mrbeast"
  ]
}

A Task TikTok Profile Data API Dataset fornece uma configuração de entrada salva. Uma Task é uma configuração de entrada salva para um Actor. Inspecione a entrada antes de usar a Task para garantir que ela contenha os perfis que você pretende verificar.

Entradas exatamente iguais são verificadas 1 vez. Considere essa regra quando a lista do seu aplicativo tiver entradas repetidas. Decida se o aplicativo mede a cobertura por perfis únicos ou pelos registros da própria lista. Depois, deixe essa escolha clara nos relatórios. Contrato da Chronometrica.

Use um método simples de aceitação

Use o método a seguir para transformar os dados retornados em um registro útil para o aplicativo. O método começa pelo resultado exigido e termina com uma decisão sobre cada perfil fornecido.

1. Declare os campos obrigatórios e a necessidade de publicações. Escreva uma regra curta que outra pessoa possa aplicar ao mesmo resultado. Por exemplo, exija a confirmação da identidade da conta e uma contagem de seguidores disponível. Informe se são necessários texto, histórico ou datas de publicações. Isso determina se um Actor que coleta apenas perfis pode atender à tarefa.
2. Mantenha cada entrada fornecida associada ao seu registro no aplicativo. Salve o nome de usuário ou a URL original antes da coleta. Preserve o identificador de registro do próprio aplicativo, se houver. Não use o nome de exibição retornado como a única forma de associar os dados à lista. Resolva as entradas repetidas sem perder os registros da lista que dependem delas.
3. Confira a identidade antes de associar os dados. Compare os campos de identidade retornados com o que seu aplicativo já sabe. Use identificadores estáveis da conta quando estiverem disponíveis. Se não puder confirmar uma correspondência, mantenha o registro como não resolvido. Um nome plausível, sozinho, não basta para associar uma nova contagem a uma conta existente.
4. Leia os campos de observação em conjunto. Inspecione `status`, `statusReason`, `countPrecision` e `observedAt`. Esses campos ajudam a avaliar os dados retornados e seus limites. Não invente significados para valores que você não verificou. Decida se a precisão disponível da contagem atende à regra do seu aplicativo. Mantenha as entradas não resolvidas na lista, com o estado de fato retornado. Contrato da Chronometrica.
5. Separe 0, dados ausentes e elegibilidade. Um 0 explícito é uma contagem. Uma contagem ausente não tem valor disponível. Elegibilidade é a decisão do seu aplicativo sobre se a linha atende à regra. Esses conceitos são diferentes. Nunca preencha uma contagem de seguidores ausente com 0 apenas para facilitar um cálculo ou a construção de uma tela.
6. Salve os dados com o horário da observação. Uma contagem atual sustenta uma afirmação sobre a observação atual. Ela não estabelece uma contagem passada. Salve as observações posteriores separadamente se seu aplicativo precisa comparar contagens ao longo do tempo. Se mantiver um valor antigo após uma falha de atualização, preserve seu horário original para que o aplicativo não o apresente como recente.
7. Revise a escolha da coleta quando os requisitos mudarem. Mesmo uma linha de perfil útil pode não ter as evidências necessárias para um novo recurso. Se um recurso precisa do texto ou do desempenho das publicações, defina esses campos obrigatórios e escolha um coletor de publicações. Não deduza as evidências ausentes a partir dos totais do perfil.

Mantenha a primeira verificação pequena o suficiente para uma inspeção manual. Compare os campos de fato retornados com a regra de aceitação. Se um campo obrigatório estiver ausente, registre esse resultado antes de adicionar mais entradas. Uma lista maior não resolve uma regra de aceitação pouco clara.

Para saber mais sobre os estados de dados ausentes e indisponíveis, use o guia de status de acesso a perfis do TikTok. Aqui, a decisão central continua sendo se o aplicativo precisa de dados de perfis ou de publicações.

Analise uma lista fictícia de perfis de um aplicativo

Todo o exemplo desta seção é fictício. Ele descreve uma lista de perfis fornecida a um aplicativo. Não é uma execução de Actor, um teste comparativo nem um resultado de cliente. Ele não demonstra que é possível coletar dados de uma conta vazia específica.

O aplicativo fictício tem 3 perfis fornecidos: A, B e C. Sua regra declarada exige a confirmação da identidade da conta e uma contagem de seguidores disponível. Ela não exige texto de publicações nem um número mínimo de publicações.

O perfil A tem um identificador estável com correspondência confirmada, um nome, uma contagem de seguidores disponível e 60 publicações públicas. Ele atende à regra do aplicativo porque sua identidade foi confirmada e a contagem exigida está disponível.

O perfil B tem um identificador estável com correspondência confirmada, um nome, uma contagem de seguidores disponível e uma contagem observada de 0 vídeos. Ele também atende à regra. O aplicativo não exigiu publicações, portanto a contagem de 0 vídeos não o desqualifica.

Não é possível resolver o perfil C. O aplicativo não tem uma contagem recente de seguidores que possa justificar para esse perfil. C permanece na lista como não resolvido. O aplicativo não deve classificar C como um perfil vazio nem atribuir 0 seguidores a ele.

Dos 3 perfis fornecidos, 2 atendem à regra do aplicativo. Portanto, a cobertura elegível da lista é:

`2 / 3 × 100 = 66.67%`

Aqui, lista significa a lista de perfis fornecida ao aplicativo. Cobertura significa a parcela dessa lista que atende à regra declarada. A porcentagem é um exemplo de dados de aplicativo. Ela não é uma taxa de sucesso do coletor.

O denominador inclui C porque C fazia parte da lista original. Se o aplicativo removesse os perfis não resolvidos antes do cálculo, informaria a cobertura em relação a uma lista menor. Isso esconderia a lacuna na lista fornecida.

O contrato da Chronometrica para coleta exclusiva de perfis atende a esse requisito fictício. B mostra por que 0 publicações e dados de perfil ausentes devem continuar distintos. Ele não prova que uma nova consulta a um perfil vazio real funcionará. Cada entrada real precisa ter seu próprio resultado registrado.

Mude a escolha quando as evidências exigidas mudarem

Suponha que o aplicativo fictício passe a precisar das legendas das 10 publicações mais recentes. O resultado exigido mudou. O fluxo de trabalho da API Dojo voltado a publicações passa a ser relevante. Revise o contrato atual e as configurações de entrada conforme o novo requisito. Contrato da API Dojo, esquema de entrada.

Mantenha os campos de perfil de que você já precisa, mas acrescente um requisito claro para as publicações. Informe quais dados das publicações o recurso deve receber e quais controles de data são relevantes. Depois, avalie um coletor conforme esse resultado.

Uma contagem de vídeos armazenada não responde a uma pergunta sobre legendas. Uma contagem atual de seguidores não estabelece o crescimento de seguidores anterior à primeira observação salva. Escolha o método de coleta a partir das evidências de que o recurso precisa, em vez do número de campos que um Actor lista.

Para a tarefa original de coleta exclusiva de perfis, o contrato específico continua sendo um forte motivo para escolher a Chronometrica. Ele corresponde diretamente à unidade de trabalho exigida: uma linha de perfil com a identidade confirmada para uma entrada conhecida.