order_by
Define como os vídeos são ordenados na busca.
relevance
date
viewCount
rating
title
Recomendado: relevance — evita que grandes canais já estabelecidos dominem os resultados.
video_duration
Filtra vídeos pelo tempo de duração.
any
short <4min
medium 4–20min
long >20min
relevance_language
Código ISO 639-1 do idioma preferido nos resultados. Não é um filtro rígido — o YouTube ainda pode retornar vídeos em outros idiomas se forem relevantes.
Ex: en, pt, es, de
video_caption
Filtra vídeos pela presença de legendas.
any
closedCaption
none
Útil para garantir que o vídeo tem transcrição disponível para extração futura.
video_definition
Filtra pela qualidade do vídeo.
any
hd
standard
video_embeddable
Retorna apenas vídeos que podem ser incorporados em outros sites.
any
true
video_type
Filtra pelo tipo de conteúdo do vídeo.
any
episode
movie
video_license
Filtra pela licença do vídeo.
any
creativeCommon
youtube
creativeCommon — licença Creative Commons, pode ser reutilizado. youtube — licença padrão do YouTube.
safe_search
Controla o nível de filtragem de conteúdo restrito.
moderate
none
strict
video_category_id
ID numérico de uma categoria do YouTube. Deixe vazio para não filtrar.
Exemplos: 1 Film & Animation · 2 Autos & Vehicles · 10 Music · 17 Sports · 20 Gaming · 22 People & Blogs · 23 Comedy · 24 Entertainment · 25 News & Politics · 26 Howto & Style · 27 Education · 28 Science & Technology