Quatro cartões de imagem têm marcas de X vermelhas. Um cartão maior se conecta, por ícones de documento e pessoa, a um cartão com uma marca de verificação.

Comece com uma pequena busca manual. Você precisa de evidências de que a pessoa procurada participa, de que o vídeo é um episódio completo e de que sua data tem o significado que você afirma. Um vídeo publicado recentemente pode ser um corte de uma conversa antiga.

Este guia abrange vídeos públicos do YouTube. Ele não pesquisa todos os serviços de podcast nem identifica todas as participações de um convidado. O resultado é uma tabela de episódios verificados, com links das fontes, evidências de identidade, tipos de vídeo e datas separadas.

1. Defina o convidado e os limites da busca

A dúvida do leitor é como “buscar um convidado específico”. Uma pergunta pública fornecida como fonte pede uma forma de fazer isso em aplicativos e sites de podcast. Essa pergunta demonstra a necessidade de buscar convidados. Ela não determina o volume da demanda nem mostra que uma busca no YouTube abrange outros serviços. Pergunta pública de um leitor, publicada em 6 de março de 2025; observada em 25 de outubro de 2026; apenas uma pergunta.

Antes de buscar, anote:

  1. O nome público do convidado.
  2. As variações conhecidas da grafia do nome, obtidas em uma biografia pública oficial ou na página de um programa.
  3. As informações públicas que ajudam a identificar a pessoa, como seu trabalho ou o título de um livro.
  4. Os programas conhecidos dos quais a pessoa pode ter participado.
  5. A data da busca e o período que você quer verificar.
  6. Um limite para a quantidade de resultados que você vai examinar.
  7. O tipo de data que você vai usar para comparar os episódios.

Use as informações de identidade para distinguir pessoas com o mesmo nome. Não transforme esse trabalho em uma lista de contatos. Você não precisa de dados privados nem de uma coleção de perfis em redes sociais.

Defina o que significa “recente” antes de revisar os resultados. Você pode escolher um intervalo fixo de datas ou procurar o episódio confirmado mais recente entre os candidatos que examinar. As duas opções exigem limites claros para a busca. Um pequeno conjunto de resultados não permite determinar a participação mais recente em toda a internet.

Defina também o que você quer contar. Aqui, um episódio completo com o convidado conta como uma participação. Um corte desse episódio é material de apoio, não outra participação em episódio completo. Resultados de busca repetidos para o mesmo vídeo não geram mais participações.

2. Faça buscas manuais e mantenha o registro

Prepare um pequeno conjunto de buscas. Use o nome do convidado junto com podcast, entrevista e nomes de programas conhecidos. Acrescente variações verificadas da grafia quando necessário. Registre a expressão exata de cada busca, a data da busca e todas as configurações de ordenação ou data que usar.

Para cada busca:

  1. Examine os resultados até o limite que você escolheu.
  2. Salve o link e o ID de cada vídeo candidato.
  3. Registre qual busca encontrou o vídeo.
  4. Abra o título, a descrição, a página de quem publicou o vídeo e a página oficial do episódio indicada no link.
  5. Marque o candidato para verificar a identidade.

O ID do vídeo é o identificador de um vídeo específico do YouTube. Use esse ID para reunir os resultados repetidos desse vídeo. Mantenha o registro de todas as buscas que o encontraram. Dois vídeos publicados separadamente continuam como registros distintos até que você tenha evidências sobre a relação entre eles.

Não aceite um resultado só porque o título contém o nome do convidado. O vídeo pode falar sobre essa pessoa, apresentar alguém com o mesmo nome ou conter apenas um trecho curto.

Consulte a página oficial do episódio de um programa conhecido ou sua playlist de podcast no YouTube, quando disponível. O YouTube descreve um programa de podcast como uma playlist e seus episódios como vídeos dessa playlist. Suas orientações também separam episódios completos de cortes e Shorts. O contexto da playlist ajuda na revisão, mas você ainda precisa verificar o convidado e o tipo de vídeo. Ajuda do YouTube, verificada em 25 de outubro de 2026; orientações oficiais sobre o formato de podcast.

Se precisar encontrar canais por assunto primeiro, use o guia para encontrar canais do YouTube por tema. Depois, volte aqui para verificar cada episódio com o convidado. Uma lista de canais não é uma lista de episódios.

3. Use o Search Scraper quando precisar salvar candidatos

Um Actor é um programa hospedado que coleta dados. O YouTube Search Scraper da Chronometrica, contrato público verificado em 25 de outubro de 2026; nenhuma execução paga pesquisa resultados públicos de vídeos do YouTube. Ele pode salvar candidatos e o contexto da busca necessário para uma revisão posterior.

A documentação mostra que ele é adequado para coletar candidatos. O Actor não determina a identidade do convidado, não verifica o episódio de origem de um corte nem decide qual data de lançamento responde à sua pergunta. Essas verificações continuam sendo parte da sua revisão.

O pequeno conjunto de dados de entrada a seguir passou por uma verificação de conformidade com o esquema público de entrada fornecido. Um esquema define as configurações e os tipos de valor aceitos. Essa entrada não foi executada.

json
{
  "enableQueryExpansion": false,
  "enrichWithVideoMetrics": false,
  "includeShorts": false,
  "maxPagesPerQuery": 1,
  "maxResults": 3,
  "queries": [
    "How can I find recent YouTube podcast appearances by one guest?"
  ],
  "resultsPerQuery": 3,
  "searchDistribution": "balanced"
}
3. Use o Search Scraper quando precisar salvar candidatos

Substitua a pergunta genérica em `queries` por buscas sobre o convidado. Uma consulta é uma expressão de busca. Combine o nome do convidado com podcast, entrevista e nomes de programas conhecidos. Não espere que a pergunta de exemplo identifique um convidado cujo nome não foi informado.

As configurações controlam a coleta da seguinte forma:

  • `enableQueryExpansion: false` impede a inclusão de sugestões do preenchimento automático do YouTube.
  • `enrichWithVideoMetrics: false` desativa a etapa de coleta de métricas públicas mais detalhadas.
  • `includeShorts: false` exclui os cartões de busca no formato Shorts abrangidos por esse controle. Isso não prova que todos os vídeos restantes sejam episódios completos.
  • `maxPagesPerQuery: 1` limita as páginas de continuação da busca que o programa tenta acessar para cada consulta.
  • `maxResults: 3` limita a execução a três vídeos candidatos únicos no total de todas as consultas.
  • `resultsPerQuery: 3` é um limite por consulta no modo sequencial. O modo balanceado alterna entre as consultas até atingir o limite global ou os limites da fonte e de páginas.
  • `searchDistribution: "balanced"` seleciona esse método de coleta alternada.

Adicionar mais consultas não cria uma cota separada de três vídeos para cada consulta. Considere sempre o limite global. A fonte seleciona os resultados retornados, e as configurações limitam esses resultados. O contrato não promete cobertura completa nem correspondência exata com a expressão de busca. Versão padrão 1.0.34 do Search Scraper, verificada em 25 de outubro de 2026; configurações documentadas, sem teste de execução.

Confira também as configurações omitidas. No esquema verificado, o valor padrão de `enrichMissingChannelFields` é `true`. Com as métricas mais detalhadas desativadas, essa opção pode solicitar dados públicos básicos para preencher campos ausentes de canal, duração ou publicação. Portanto, o exemplo não desativa todas as solicitações opcionais de detalhes.

Uma Task é uma configuração de entrada salva para um Actor. A Task pública youtube-competitor-video-research, presença verificada em 25 de outubro de 2026; entrada salva e execução não verificadas é um ponto de partida que você pode examinar. Substitua as buscas de exemplo e confira os limites antes de usar. Sua presença pública não prova que as configurações correspondam a este exemplo nem que ela tenha sido executada com sucesso.

4. Confirme o convidado com as evidências do episódio

Revise cada vídeo único. Comece pela apresentação inicial e pelas notas oficiais do programa. Verifique se elas identificam a pessoa procurada com base nas informações públicas que você registrou.

Ouça a apresentação relevante. Examine as evidências visuais e sonoras disponíveis. Salve uma marca de tempo e uma nota curta que explique a decisão sobre a identidade. Uma página oficial do episódio pode fornecer outra fonte para a identidade do convidado.

Use três estados de decisão criados por você:

4. Confirme o convidado com as evidências do episódio
Estado da identidadeSignificado
ConfirmadaAs evidências verificadas do episódio identificam o convidado procurado
ExcluídaAs evidências verificadas identificam outra pessoa ou mostram que não há participação que atenda aos critérios
Não resolvidaAs evidências disponíveis não permitem identificar o convidado procurado

Esses são rótulos da revisão, não valores de saída do Actor.

As legendas disponíveis podem ajudar a localizar uma apresentação ou um trecho relevante. Elas não confirmam a pessoa por si só. Um nome no texto das legendas ainda exige a revisão da fonte. Se você não conseguir examinar evidências suficientes, mantenha a identidade como não resolvida.

Se a próxima tarefa exigir uma coleção salva de textos de legendas, use o guia para criar um corpus de transcrições do YouTube. Coletar legendas é outra tarefa. O Search Scraper não fornece textos de legendas, textos de comentários, downloads de mídia nem análises privadas do YouTube Studio. Contrato público do Search Scraper, verificado em 25 de outubro de 2026; escopo documentado, nenhuma execução paga.

5. Separe episódios completos, cortes e republicações

Após verificar a identidade, classifique o vídeo. Use episódio completo, corte, trailer, compilação, republicação ou desconhecido. Registre o motivo e a fonte.

Um vídeo curto pode confirmar que o convidado aparece naquele vídeo. Isso não comprova um episódio completo separado. Da mesma forma, uma duração longa, por si só, não prova que o vídeo contenha um episódio completo de podcast.

Vincule um corte ao episódio de origem somente quando as evidências da fonte comprovarem essa relação. Por exemplo, as notas oficiais do programa ou a descrição do corte podem ter um link direto para o episódio completo. Salve esse link e uma nota que explique a conexão.

Se a relação continuar incerta, mantenha-a como não resolvida. Não una dois vídeos publicados separadamente só porque têm o mesmo título ou nome de convidado. Não conte cada republicação como uma nova conversa.

Mantenha dois níveis na tabela: o vídeo de origem e o episódio revisado. Vários vídeos de origem podem servir de evidência para um único episódio confirmado. Isso permite manter cortes úteis sem aumentar a contagem de participações em episódios completos.

6. Separe as datas de publicação do vídeo, lançamento do episódio e observação

“Mais recente” exige uma data definida. Mantenha estes fatos separados:

6. Separe as datas de publicação do vídeo, lançamento do episódio e observação
DataO que descreve
Data de publicação do vídeoQuando aquele vídeo foi publicado no YouTube
Data de lançamento informada para o episódioQuando uma fonte oficial informa que o episódio foi lançado
Data de observaçãoQuando você coletou ou revisou as evidências

Um corte publicado nesta semana pode vir de um episódio lançado meses antes. A data de observação mostra quando você fez a verificação. Nenhuma dessas datas indica automaticamente a data de lançamento do episódio.

Mantenha o valor de `publishedAt` do Actor como foi fornecido. Confira seu significado no vídeo e na fonte oficial do episódio. Registre qualquer data oficial de lançamento separadamente, com a respectiva fonte.

Normalize uma data somente quando as evidências permitirem. Normalizar significa colocar uma data conhecida em um formato uniforme. Uma data que informa apenas o dia não deve receber um horário exato inventado. Se dois episódios tiverem a mesma data e não houver uma ordem comprovada, informe um empate ou uma ordem não resolvida.

Escolha um único campo de data para a comparação final. Para uma afirmação sobre o lançamento de episódios, compare episódios completos confirmados com datas de lançamento comprovadas. Para uma afirmação sobre a publicação no YouTube, compare episódios completos confirmados pelas datas de publicação verificadas e identifique o resultado de acordo com esse critério.

Mantenha as datas desconhecidas fora da ordenação. Não atribua zero, não use a data de observação nem deduza que algo é recente pela posição nos resultados de busca. Um episódio confirmado sem data permanece na tabela, com sua posição na ordem cronológica não resolvida.

7. Salve as evidências e os estados de falha

Mantenha os registros originais coletados junto da tabela de revisão. Preserve `rootQuery`, `query`, `querySource`, `pageIndex` e `pageRank`. Esses campos mantêm o caminho da busca e a posição retornada. A posição não comprova a identidade nem que o vídeo seja recente.

Salve os seguintes campos:

7. Salve as evidências e os estados de falha
Grupo de camposDetalhes a manter
Limites da buscaExpressões de busca, configurações, limites de resultados, data e hora da busca
Identificação do vídeo`postId`, `postUrl`, título, responsável pela publicação, identificação disponível do canal
Contexto da busca`rootQuery`, `query`, `querySource`, `pageIndex`, `pageRank`
Resultado da coleta`status`, `statusReason`, `observedAt`
Revisão do convidadoEstado da identidade, marca de tempo da apresentação, link da fonte, motivo, data e hora da revisão
Tipo de vídeoEpisódio completo, corte, trailer, compilação, republicação ou desconhecido
Relação com o episódioLink do episódio de origem, evidências da relação, questão não resolvida
Datas`publishedAt` original, data de publicação do vídeo verificada, data de lançamento informada, fontes das datas
Decisão finalEpisódio incluído, vídeo de apoio, candidato excluído ou candidato não resolvido

Os campos de coleta vêm do contrato documentado do Actor. Os campos de revisão são colunas que você cria. Contrato de saída do Search Scraper, verificado em 25 de outubro de 2026; campos disponíveis, sem teste de execução.

Registre os estados de falha de forma específica. Uma falha de coleta significa que a tentativa de coleta falhou. Isso não significa que o convidado estava ausente. Uma apresentação inacessível deixa a identidade não resolvida. Um convidado confirmado em um vídeo de tipo desconhecido ainda não comprova uma participação em episódio completo. Um episódio completo confirmado com data desconhecida não permite afirmar que ele seja o “mais recente” com base em datas.

Valores ausentes continuam ausentes. Uma data ausente não é uma data com valor zero. Uma contagem pública ausente não significa zero visualizações. Você não precisa de métricas públicas para determinar a identidade do convidado.

8. Acompanhe um exemplo de ficção original

Tudo neste exemplo é ficção original. A convidada, as buscas, os vídeos, as datas e os resultados da revisão são inventados. Não houve busca real por um convidado nem execução do Actor. As duas buscas manuais abaixo são separadas da entrada do Actor com três candidatos apresentada acima.

Suponha que você procure episódios de podcast com a convidada fictícia Mira Vale. Uma suposta biografia oficial a identifica como autora de um determinado livro.

A primeira busca manual encontra os vídeos A, B e C. Uma segunda busca encontra A e B novamente. O cálculo é:

`3 search hits + 2 search hits = 5 search hits`

`5 search hits − 2 repeated hits = 3 unique videos`

Essas são contagens de vídeos. Não são contagens de pessoas nem de participações em episódios completos.

8. Acompanhe um exemplo de ficção original
VídeoEvidências revisadasTipo e relaçãoDatasDecisão
AA apresentação identifica Mira e seu livroCorte; as notas oficiais têm um link para BPublicação do vídeo: 22 de outubro de 2026; data de lançamento separada desconhecidaCorte de apoio confirmado
BA apresentação identifica a mesma convidadaEpisódio completo; a página oficial do programa dá suporte à identificação do episódioPublicação do vídeo: 18 de setembro de 2026; lançamento informado: 16 de setembro de 2026Uma participação confirmada em episódio completo
CO título usa o mesmo nome; a abertura não permite identificar a pessoa procuradaPossível entrevista; identidade não resolvidaDatas de publicação do vídeo e de lançamento desconhecidasManter para revisão posterior

O vídeo A tem a data de publicação mais recente entre as conhecidas. Isso não comprova uma conversa mais recente. As evidências oficiais da relação o vinculam a B.

O resultado após a revisão é:

`1 confirmed full episode + 1 supporting clip + 1 unresolved candidate = 3 unique videos`

`1 confirmed full episode + 0 additional full episodes from its clip = 1 confirmed full appearance`

O zero significa que A não acrescenta uma participação separada em episódio completo. Isso não significa que C tenha sido descartado por evidências. C continua não resolvido, e suas datas permanecem desconhecidas.

Com base nas datas de lançamento informadas para os episódios, o resultado sustentado pelas evidências é: “A participação mais recente confirmada neste conjunto de resultados de busca é o episódio B, lançado em 16 de setembro de 2026.” A tabela ainda deve mostrar C e os limites da busca. Este exemplo não identifica todas as participações de Mira Vale.

9. Confira o resultado antes de usá-lo

Antes de exportar a lista, verifique se cada participação confirmada tem evidências de identidade. Verifique se cada episódio completo aceito tem uma decisão sobre o tipo de vídeo. Revise a relação de cada corte com seu episódio de origem e mantenha a fonte que a comprova.

Confira se as contagens correspondem aos registros. Cada candidato único precisa de uma decisão, inclusive os excluídos e os não resolvidos. Cada episódio incluído precisa dos links dos vídeos que servem de evidência. Os resultados repetidos devem manter seu contexto de busca sem aumentar a contagem de episódios.

Depois, confira a afirmação sobre a data. Informe qual campo de data determina a ordem. Mantenha as datas desconhecidas visíveis. Confirme que nenhuma data de publicação de corte substituiu a data de lançamento do episódio de origem.

Apresente os limites da busca ao lado do resultado. Inclua a data da busca, as expressões, os limites e os registros não resolvidos. Se a busca dentro desses limites encontrar zero episódios confirmados, informe zero episódios confirmados naquele conjunto verificado. Não afirme que o convidado nunca participou de um podcast.

Fontes e leituras adicionais

Por Chronometrica · Atualizado

Voltar ao topo ↑