Documentos    YouTube

Criar um feed de pesquisa do YouTube

Última atualização por Manuel Escobar15 de setembro de 2026

Gostaria que o seu feed do YouTube mostrasse vídeos que correspondam a uma pesquisa, em vez de todos os vídeos de um único canal?

Neste guia, vamos criar um feed de pesquisa e, em seguida, filtrá-lo. Isso significa escolher como os resultados são ordenados, a duração dos vídeos, a data de publicação e muito mais.

Requisitos: Os feeds de pesquisa requerem uma versão paga do YouTube Feed e uma chave da API do YouTube. Cada pesquisa que o plugin executa é enviada com a sua chave; por isso, sem ela, o feed permanece vazio.

Antes de começar, certifique-se de que o YouTube Feed está instalado e ativado e de que já adicionou a sua chave API.

Nota: Já está no construtor e está a ver o campo «Termo de pesquisa »? O que deve escrever nesse campo é explicado na secção «Como funciona o campo «Termo de pesquisa» ». Os passos abaixo explicam como criar um feed de pesquisa a partir do zero.

Criar o seu feed de pesquisa

Para começar, aceda a «Feed do YouTube» » «Todos os feeds » no seu painel de controlo do WordPress.

O menu de administração do WordPress com a opção «Feed do YouTube» e, em seguida, «Todos os feeds» selecionados

Em seguida, clique em «Adicionar novo».

O ecrã «Todos os feeds» com uma seta a apontar para o botão «Adicionar novo»

Em seguida, selecione «Pesquisa» como tipo de feed.

Nota: O canal já vem selecionado. Para criar o seu feed apenas a partir da pesquisa, clique nele para o desmarcar.

A etapa «Selecionar tipo de feed», com a opção «Pesquisar» selecionada e um sinal de verificação no canto

Agora, escreva o que pretende encontrar no campo «Termo de pesquisa ». Para este exemplo, vamos usar «latte art ». Em seguida, clique em «Seguinte».

O campo «Termo de pesquisa» com «latte art» introduzido e uma seta a apontar para o botão «Seguinte»

Em seguida, escolha um modelo para a disposição dos vídeos. Qualquer um deles funciona com um feed de pesquisa e pode alterá-lo mais tarde.

Vamos utilizar o «Cards». Em seguida, clique em «Seguinte» para concluir.

A etapa do modelo com a opção «Cartões» selecionada e uma seta a apontar para o botão «Seguinte»

O teu feed é criado e começa imediatamente a encher-se com vídeos relevantes. Eis o aspeto que assume depois de o adicionares a uma página.

Uma página publicada que mostra o feed finalizado sob a forma de uma grelha de vídeos de latte art com títulos e nomes de canais

Para alterar a pesquisa num feed que já criou, abra o feed e aceda a Definições » Tipo de feed. Encontrará aí o mesmo campo «Termo de pesquisa ».

Em seguida, escreva o seu novo termo. Para o guardar, clique em «Guardar».

O editor de feeds, apresentando o campo «Termo de pesquisa» na secção «Tipo de feed», com uma seta a apontar para o botão «Guardar»

Nota: O botão «Atualizar», ao lado do campo, atualiza a pré-visualização, para que possa ver quais os vídeos que o novo termo apresenta antes de o confirmar. Ao clicar em «Guardar», a alteração fica guardada de qualquer forma.

Como funciona o campo «Termo de pesquisa»?

Esse campo é a pesquisa na sua totalidade, por isso vale a pena saber o que ele faz com o que escreves.

  • Pode usar espaços. A «latte art» deve ser introduzida exatamente como a escreveria na própria barra de pesquisa do YouTube.
  • Uma vírgula dá início a uma segunda pesquisa. «latte art, flat white» gera duas pesquisas em vez de uma única. É isso que a própria sugestão do campo quer dizer ao separar os termos com vírgulas. Os vídeos do primeiro termo preenchem o feed. Os do segundo termo surgem a seguir.
  • O sinal de menos exclui os vídeos. A pesquisa «latte art -tutorial» encontra vídeos sobre latte art que não mencionam tutoriais.
  • Um cachimbo pode referir-se a qualquer um dos dois. «latte art» | «coffee art» correspondem a vídeos sobre qualquer um deles.
  • As aspas são removidas. A expressão «latte art» é pesquisada como duas palavras separadas, pelo que uma frase entre aspas corresponde aos mesmos vídeos que a frase sem aspas.

Uma pesquisa simples apresenta-lhe o que o YouTube considera mais relevante. Para ser mais específico, adicione filtros a seguir às palavras de pesquisa, no mesmo campo.

Cada filtro é composto por um símbolo «&», um nome, um sinal de igual e um valor, sem espaços à sua volta. Assim, para mostrar os vídeos de latte art mais vistos, em vez dos mais relevantes, o campo fica assim:

latte art&order=viewCount

Os filtros acumulam-se e a sua ordem não tem importância. Este filtro procura os vídeos mais vistos que tenham também uma duração entre 4 e 20 minutos:

latte art&order=viewCount&videoDuration=medium

Estes são os filtros que vale a pena conhecer:

  • ordem — date por ordem de data, do mais recente para o mais antigo, viewCount para os mais vistos, rating para os mais bem classificados, ou title para ordenação alfabética. Sem esta opção, o YouTube ordena os resultados por relevância, o que é adequado para a maioria das pesquisas temáticas.
  • duração do vídeo — short durante menos de 4 minutos, medium para 4 a 20, long há mais de 20.
  • publicado em e publicado antes — um momento no tempo, expresso como data, um T, a hora e um Z, tudo numa única cadeia de caracteres: 2026-01-01T00:00:00Z. Por si só, publishedAfter dá-te tudo desde esse momento.
  • channelId — restringe a pesquisa a um canal. Este é o ID do canal, que começa por UC, e não o seu @nome de utilizador. Quando combinado com palavras-chave, apenas encontra vídeos nesse canal que correspondam a essas palavras, o que, num canal pequeno, muitas vezes não resulta em nada.
  • tipo de evento — live para as transmissões que estão a decorrer neste momento, upcoming no caso dos agendados, completed para os que já estão prontos.
  • videoDefinição — high apenas para HD.
  • legenda do vídeo — closedCaption para vídeos que tenham legendas.
  • vídeo incorporável — true para vídeos que podem ser reproduzidos fora do YouTube. Os feeds reproduzem os vídeos diretamente na página, pelo que isto exclui aqueles que não o permitem.
  • videoLicense — creativeCommon apenas para vídeos sob licença Creative Commons.
  • código da região e relevânciaIdioma — um código de país ou de língua de duas letras, como, por exemplo, regionCode=GB ou relevanceLanguage=es, para ver os resultados de acordo com a sua classificação para esse público.

Nota: O Feed do YouTube define sempre type e maxResults para ti, por isso não é necessário adicionar nenhum dos dois. Se adicionares um, esse parâmetro é enviado duas vezes. O número de vídeos que o teu feed mostra é uma configuração do próprio feed.

Crie o seu termo de pesquisa

Em vez de compor o texto manualmente, pode escolher o que gostaria que o feed mostrasse e copiar o resultado. Tudo o que se segue é executado no seu navegador, pelo que nada do que escrever é enviado para lado nenhum.

O que procurar

Corresponde ao título, à descrição e às etiquetas do vídeo.
Separe com vírgulas aqui. Um vídeo que corresponda a qualquer um deles é válido.
Separe com vírgulas aqui.
O ID do canal, e não o seu @handle nem a URL. Começa por UC.

Restringir a pesquisa

Mais filtros
Código de país de duas letras.
Código de idioma de duas letras.

O seu termo de pesquisa

O termo de pesquisa aparece aqui.

Cola isto no feed do Termo de pesquisa campo. Omita type e maxResults, que o plugin define automaticamente.

Pesquisas que pode copiar

Cada uma destas expressões deve ser inserida tal como está no campo «Termo de pesquisa ». Substitua as palavras pelas suas próprias.

  • Os vídeos mais recentes sobre um tema — latte art&order=date
  • Os vídeos mais populares sobre um determinado tema — latte art&order=viewCount
  • Apenas vídeos que possam ser reproduzidos no teu feed — latte art&videoEmbeddable=true
  • Vídeos curtos, os mais recentes em primeiro lugar — latte art&videoDuration=short&order=date
  • Os vídeos mais recentes de um canal — &channelId=UCxxxxxxxxxxxxxxxxxxxxxx&order=date
    Este é o único caso que começa com &: como não há palavras de pesquisa, o campo abre diretamente num filtro.
  • Um feed que abrange 2 temas — latte art,flat white
    Cada termo é pesquisado separadamente. Os vídeos do primeiro termo aparecem em primeiro lugar. Para incluir também o segundo termo, aumente o número de vídeos que o feed apresenta.
  • Vídeos publicados após uma data à sua escolha — latte art&publishedAfter=2026-01-01T00:00:00Z
  • Transmissões em direto a decorrer neste momento — latte art&eventType=live
    Isto depende de haver alguém a fazer uma transmissão sobre o teu tema nesse momento, pelo que uma pesquisa de nicho permanece vazia até que alguém comece.
  • Vídeos Creative Commons que pode reutilizar — latte art&videoLicense=creativeCommon

Três pequenos erros impedem que uma pesquisa funcione, e nenhum deles apresenta uma mensagem de erro. Cada um tem o seu próprio sintoma, por isso comece pelo que corresponde ao que está a observar.

Um feed vazio, proveniente de uma pesquisa que começa com &q=. O campo já contém o termo de pesquisa. Escrever &q=latte art envia uma pesquisa vazia e outra verdadeira, e o YouTube não apresenta nenhum resultado.

As instruções mais antigas utilizavam exatamente esse formato, por isso vale a pena verificar qualquer pesquisa que tenha copiado de outro sítio. As suas palavras vêm primeiro, sozinhas.

Um filtro que não faz nada, por ter sido escrito a seguir a uma vírgula. Como uma vírgula dá início a uma segunda pesquisa, um filtro colocado a seguir a uma vírgula é interpretado como palavras de pesquisa. latte art,order=date pesquisas sobre latte art e, em seguida, pelas palavras «order=date». Nada está ordenado por data.

Os filtros vêm a seguir ao símbolo «&», por isso latte art&order=date é a versão que funciona.

Uma correspondência aproximada de palavras-chave, obtida através de aspas à volta de uma frase. As aspas são removidas antes da pesquisa ser executada, pelo que as palavras entre elas são comparadas separadamente. Os resultados são os mesmos que se a pesquisa fosse feita sem as aspas.

Para refinar os resultados, adicione uma palavra mais específica ou exclua uma palavra utilizando o sinal de menos, como em latte art -tutorial.

É isso mesmo! Agora já sabes como criar um feed de pesquisa do YouTube e definir exatamente quais os vídeos que este apresenta. A seguir, consulta o nosso guia sobre como apresentar o teu feed com um shortcode para o adicionares a outras páginas do teu site.

Perguntas mais frequentes

A seguir, respondemos a algumas das perguntas mais frequentes sobre os feeds de pesquisa do YouTube.

Por que é que o meu feed de pesquisa está vazio?

A maioria dos feeds de pesquisa vazios deve-se a duas causas. A primeira é a falta de uma chave API, uma vez que todas as pesquisas são enviadas com ela. A segunda é um termo de pesquisa escrito como &q=your words, que envia uma pesquisa vazia juntamente com a verdadeira. Para resolver o problema, remova o &q= para que as tuas palavras se destaquem por si só.

Por que é que o meu feed mostra vídeos que não têm nada a ver com a minha pesquisa?

Comece por procurar uma vírgula no campo «Termo de pesquisa». Tudo o que vier a seguir à vírgula passa a constituir uma segunda pesquisa, separada. Os resultados desta são adicionados após os do primeiro termo. Aparecem no final, quando o feed mostrar mais vídeos do que os encontrados na primeira pesquisa. Se o texto após a vírgula se destinava a servir de filtro, deve ser colocado após o símbolo «&», como em latte art&order=date.

Posso fazer uma pesquisa apenas num canal?

Sim. Adicionar &channelId= seguido pelo ID do canal, que começa com UC. Um @handle ou um URL de canal não funcionam nesse contexto.

Como posso pesquisar uma frase exata?

As aspas são removidas antes de a pesquisa ser executada, pelo que "latte art" e latte art apresentar os mesmos vídeos. Para restringir uma expressão abrangente, adicione uma palavra que a torne mais específica ou exclua uma com o sinal de menos, como em latte art -tutorial.

Posso ordenar os resultados da pesquisa da forma que quiser?

Pode ordenar por data, número de visualizações, classificação ou título utilizando o order filtro. Tudo o que for além desses 4 é decidido pelo próprio sistema de classificação por relevância do YouTube, que é o que aparece quando se sai order fora. A ordenação ocorre dentro da própria pesquisa, por isso order=date é o que solicita ao YouTube os vídeos mais recentes que correspondem à pesquisa. Num feed de pesquisa, a opção de ordenação «Mais recentes» do próprio feed mantém a ordem em que a pesquisa apresentou os resultados.

apoio

Não encontrou a sua resposta nos documentos?

Apoio ao contacto

Categorias