TikTok Date Extractor

Propósito e Intenção do Usuário: Esta ferramenta resolve a necessidade de obter uma data de publicação exata para um vídeo do TikTok quando os metadados estão incompletos ou são inconsistentes. Usuários-alvo: analistas de mídias sociais, estrategistas de conteúdo, pesquisadores e arquivistas que precisam de carimbos de data confiáveis para análise de tendências, relatórios e planejamento. A ferramenta aceita uma URL do TikTok ou um ID de vídeo e retorna uma data única e padronizada no ISO 8601, com fuso horário opcional.
Lógica Central e Funcionalidades: O backend trabalha com metadados públicos, aplica regras determinísticas para selecionar o campo de data mais confiável (postDate, createTime ou publishedAt) e usa valores de fallback razoáveis quando campos primários faltam. Suporta uma entrada por solicitação e fornece saída legível para máquina para pipelines.
Entradas e Saídas: Entrada: url_or_id (string, obrigatória). Saída: posting_date (string, ISO 8601), timezone (string, nome IANA, opcional), source (URL). Validação garante que a entrada seja uma URL ou ID TikTok; entradas inválidas produzem erros de nível de domínio.
Algoritmos e Cálculos: O sistema prioriza campos de data explícitos, deriva datas de timestamps relacionados se necessário e converte o resultado para o fuso horário solicitado usando o banco de dados IANA. Se várias fontes existirem, aplica uma ordem de prioridade consistente para reprodutibilidade.
Erros e Casos Limites: Se a URL for privada ou a plataforma bloquear o acesso, a ferramenta retorna um código de erro definido e pode tentar uma estimativa de melhor esforço. Dados ausentes resultam em null com justificativa. Rate limiting ou alterações de endpoints são relatados como condições re-tentáveis.
Indústria, Região e Localização: ISO 8601 é padrão; fusos horários seguem identificadores IANA; saída suporta UTC e fusos horários regionais. Localização limitada a descrições em inglês; sem dados de moeda ou regionais. Suposições e Exclusões: assume URLs de vídeo públicas; não exige login nem acesso a contas privadas; processamento em lote está fora do escopo de uma única solicitação.