Acompanhe o Crescimento de Seguidores no TikTok com Capturas de Perfil

TL;DR:

• O rastreamento do crescimento de seguidores do TikTok começa quando a coleta começa. O ator do perfil retorna uma contagem pública atual, não uma série histórica.
• Cada observação precisa de um status de coleta. Uma coleta falhada e uma contagem de seguidores inalterada são desfechos diferentes.
• A identidade da conta deve sobreviver a mudanças de nome. Armazene account_id, sec_uid e o observado unique_id juntos.
• O crescimento é uma diferença entre instantâneas comparáveis. Subtraia contagens válidas consecutivas para a mesma conta e mantenha ambos os timestamps.
• O crescimento de seguidores não identifica sua causa. Uma mudança não pode ser atribuída a um vídeo ou campanha sem evidências separadas.
• Gratuito para começar. Novas contas do Scrapeless incluem crédito gratuito através do Painel do Scrapeless.

Introdução: uma contagem de perfil se torna útil após a segunda observação

Uma contagem pública de seguidores é uma instantânea. Ela se torna um registro de crescimento apenas depois que a mesma conta é coletada novamente e as duas observações válidas são comparadas.

Este tutorial constrói um pequeno pipeline de rastreamento de crescimento de seguidores do TikTok com o ator de perfil Scrapeless, Python e SQLite. Ele preserva identificadores de conta, salva estados de coleta bem-sucedidos e falhados separadamente, calcula mudanças a partir de instantâneas válidas consecutivas e produz linhas para um painel de crescimento de criadores.

Os campos de perfil subjacentes e as chaves de identidade são abordados no tutorial do raspador de perfil do TikTok.

Pipeline em um Relance

O pipeline cria um histórico desde o dia em que começa a coletar. Ele não reconstrói contagens de seguidores de datas anteriores à primeira observação armazenada.

Pré-requisitos

• Uma conta Scrapeless e token de API do Painel do Scrapeless
• Uma lista mantida pelo usuário de nomes de usuários públicos do TikTok
• Um cronograma de coleta apropriado para a necessidade de relatório
• Um token ao vivo em SCRAPELESS_API_KEY para o bloco de API abaixo

O exemplo completo tem uma lacuna de pré-requisito porque o leitor deve fornecer uma credencial ao vivo e uma lista de contas. O artigo não incorpora credenciais ou apresenta respostas de perfil fabricadas.

Etapa 1: Definir a Lista de Contas

Uma lista deve conter uma chave interna estável, o nome de usuário atual, a razão comercial para rastreá-lo e se o registro permanece ativo. Nomes de usuário são entradas convenientes para solicitações, mas não devem se tornar a única chave de banco de dados.

O ator scraper.tiktok.user.detail aceita unique_id sem o @ inicial. Sua resposta pode incluir account_id, unique_id, sec_uid, campos de perfil público, flags de conta e um objeto statistics contendo contagens de seguidores, seguindo, amigo, curtidas, vídeo e vídeos curtidos.

Mantenha IDs de conta com aparência numérica como strings. Preserve todos os três identificadores para que uma mudança futura de nome não crie silenciosamente uma nova série de histórico.

Etapa 2: Capturar uma Instantânea de Perfil com Timestamp

Cada tentativa de coleta precisa de um timestamp de aplicação e um status. Uma linha bem-sucedida armazena os identificadores e estatísticas retornados. Uma tentativa falhada armazena a chave da conta, horário da tentativa e um estado de erro conciso, sem copiar contagens ausentes como zero.

A documentação de datetime do Python descreve timestamps cientes de fuso horário. Use um padrão de fuso horário em armazenamento e aplique fusos horários de exibição apenas na camada de relatório.

A documentação oficial de informações do usuário do TikTok também trata os campos de usuário como uma resposta atual em vez de um feed de histórico de conta. O pipeline do Scrapeless, portanto, constrói seu próprio histórico de observações.

Comece a Raspagem com Scrapeless

Potencialize seu fluxo de trabalho de raspagem da web e automação com o Scrapeless!
Inscreva-se hoje e obtenha $5 em crédito gratuito — sem cartão de crédito necessário.

Reivindique seu crédito gratuito agora no Painel do Scrapeless.

Etapa 3: Armazenar Sucessos e Lacunas de Coleta Separadamente

O SQLite suporta uma tabela de snapshot compacta somente para anexação. A documentação de restrição de tabela SQLite explica a chave composta usada para prevenir observações duplicadas.

Nota: O código abaixo requer um token de API Scrapeless ativo em SCRAPELESS_API_KEY e nomes de usuário públicos separados por vírgulas em TIKTOK_USERNAMES.

import json
import os
import sqlite3
from datetime import datetime, timezone
from urllib.error import HTTPError
from urllib.request import Request, urlopen

ENDPOINT = "https://api.scrapeless.com/api/v1/scraper/request"
TOKEN = os.environ["SCRAPELESS_API_KEY"]
USERNAMES = [v.strip().lstrip("@") for v in os.environ["TIKTOK_USERNAMES"].split(",") if v.strip()]


def get_profile(username):
    body = json.dumps({
        "actor": "scraper.tiktok.user.detail",
        "input": {"unique_id": username},
    }).encode()
    request = Request(
        ENDPOINT,
        data=body,
        headers={"x-api-token": TOKEN, "content-type": "application/json"},
        method="POST",
    )
    with urlopen(request, timeout=60) as response:
        return json.load(response)


database = sqlite3.connect("tiktok-profile-history.sqlite3")
database.execute("""
CREATE TABLE IF NOT EXISTS profile_snapshots (
    roster_username TEXT NOT NULL,
    collected_at TEXT NOT NULL,
    collection_status TEXT NOT NULL,
    account_id TEXT,
    unique_id TEXT,
    sec_uid TEXT,
    followers INTEGER,
    following INTEGER,
    likes INTEGER,
    videos INTEGER,
    error_code TEXT,
    raw_json TEXT,
    PRIMARY KEY (roster_username, collected_at)
)
""")

for username in USERNAMES:
    collected_at = datetime.now(timezone.utc).isoformat()
    try:
        profile = get_profile(username)
        statistics = profile.get("statistics") or {}
        database.execute(
            "INSERT INTO profile_snapshots VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)",
            (
                username, collected_at, "success",
                str(profile.get("account_id") or ""), profile.get("unique_id"),
                profile.get("sec_uid"), statistics.get("followers"),
                statistics.get("following"), statistics.get("likes"),
                statistics.get("videos"), None,
                json.dumps(profile, ensure_ascii=False),
            ),
        )
    except HTTPError as error:
        database.execute(
            "INSERT INTO profile_snapshots VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)",
            (username, collected_at, "failed", None, None, None, None, None, None, None,
             str(error.code), None),
        )

database.commit()
database.close()

A coluna collection_status mantém um intervalo visível. Ela impede que uma consulta de relatório trate uma observação indisponível como se não houvesse alteração de seguidores.

Etapa 4: Calcular Crescimento a partir de Snapshots Válidos Consecutivos

O crescimento de seguidores é a contagem válida mais recente menos a contagem válida anterior para o mesmo account_id. Mantenha os timestamps de início e fim, ambas as contagens de origem, a diferença e a duração decorrido.

Use a identidade da conta antes do nome de usuário ao juntar. Se um nome de usuário observado mudar enquanto account_id permanecer estável, mantenha uma série e conserve o identificador registrado em cada snapshot. Se os campos de identidade entrarem em conflito, pare a junção e envie a linha para revisão.

As funções de janela SQL podem emparelhar linhas de sucesso sem sobrescrever as observações originais:

SELECT
  account_id,
  unique_id,
  collected_at,
  followers,
  followers - LAG(followers) OVER (
    PARTITION BY account_id ORDER BY collected_at
  ) AS follower_change
FROM profile_snapshots
WHERE collection_status = 'success' AND followers IS NOT NULL;

O resultado mede a mudança entre as observações armazenadas. Não é uma taxa de crescimento diária, a menos que as observações estejam separadas pelo intervalo exato que o relatório rotula.

Etapa 5: Construir o Painel de Crescimento do Criador

Um painel útil mostra a qualidade dos dados ao lado do crescimento:

• Contagem de seguidores válida mais recente e seu horário de coleta
• Mudança desde o snapshot válido anterior
• Mudança dentro de um intervalo de relatório claramente rotulado
• Número de observações bem-sucedidas e lacunas de coleta
• Nome de usuário observado atual mais ID de conta estável
• Data da primeira observação armazenada, que define o limite da história

Plote o nível de seguidores e a mudança de seguidores separadamente. Um gráfico de nível mostra a série acumulada; um gráfico de mudança facilita a revisão de lacunas de coleta e diferenças repentinas.

Lidar com Dados de Perfil de Forma Responsável

Estatísticas de perfil público ainda podem ser dados pessoais. Limite o elenco de contas ao propósito declarado, restrinja o acesso à resposta bruta e defina quando os snapshots antigos devem ser removidos. A Estrutura de Privacidade NIST fornece uma estrutura para identificar e gerenciar riscos de coleta.

Não infira demografia de audiência, identidades de seguidores ou a causa do crescimento a partir da resposta do perfil. Uma mudança de contagem pode coincidir com uma campanha ou postagem, mas a coincidência não é atribuição.

Scrapeless expõe o ator do perfil através da Scraping API. Verifique a página de preços atual antes de definir a contagem de contas e a programação.

Conclusão: a história começa com uma linha de base registrada

O rastreamento de crescimento de seguidores do TikTok precisa de uma identidade de conta estável, contagens válidas com timestamp e lacunas de coleta explícitas. Uma vez que a linha de base exista, snapshots consecutivos podem suportar uma curva de crescimento sem reivindicar um histórico de plataforma indisponível ou atribuir a mudança a um único conteúdo.

Pronto para Construir um Rastreador de Estatísticas de Perfil?

Junte-se ao Discord do Scrapeless ou à comunidade Telegram para comparar esquemas de snapshot. Crie uma conta no Painel do Scrapeless quando o elenco de contas estiver pronto.

FAQ

P: Um rastreador de seguidores do TikTok pode recuperar contagens históricas?

O fluxo de trabalho não pode recuperar contagens de antes do início da coleta. Sua primeira observação bem-sucedida torna-se a linha de base para comparações posteriores.

P: Qual é a diferença entre não crescimento e uma falha de coleta?

Não crescimento significa que dois snapshots válidos contêm a mesma contagem de seguidores. Uma falha de coleta significa que a contagem mais recente é desconhecida e nenhuma diferença deve ser calculada.

P: O crescimento de seguidores pode ser atribuído a um vídeo do TikTok?

O crescimento de seguidores não pode ser atribuído a um vídeo apenas com base nos snapshots do perfil. A atribuição requer um experimento separado ou evidência de campanha de primeira parte.

P: O fluxo de trabalho expõe identidades de seguidores ou demografia?

O ator do perfil retorna estatísticas de conta públicas, não listas de seguidores ou demografia de audiência.

P: Eu preciso gerenciar um proxy ou um parser de página de perfil?

O ator gerencia sua superfície de coleta atrás da solicitação da API. O chamador gerencia o elenco, a programação, o armazenamento, as comparações e os relatórios.

P: A coleta de contagens públicas de seguidores é legal?
A legalidade depende da jurisdição, propósito, método de acesso, dados e termos aplicáveis. Minimize a coleta, documente o propósito e obtenha aconselhamento jurídico para o uso específico.