v0.2.0-beta

OpenAPI 3.1.0

Pesquisa no YouTube

Felo API Support

MIT

Servidor

https://openapi.felo.ai

Bibliotecas Cliente

Shell Curl

YouTube Search

Search videos, channels and playlists.

YouTube Search Operações

get/v1/beta/youtube/search

Pesquisa no YouTube

Pesquisa no YouTube por vídeos, canais e playlists. engine=youtube e q são obrigatórios. Use gl e hl para país e idioma, ou sp para paginação e filtros avançados.

Referência de preços

Medição: base de custo fixa por requisição bem-sucedida.
Estimativa de referência por requisição: USD 0.0029.
Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.

Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.

Parâmetros de Consulta

engine
enum
const:
youtube
obrigatório

Identificador do mecanismo SearchApi. Use youtube para este endpoint do YouTube.
valores
- youtube
gl
Tipo: string

Código do país (por exemplo, us, jp)
hl
Tipo: string

Idioma da interface
q
Tipo: string
obrigatório

Consulta de pesquisa. Obrigatória no runtime e no SearchApi upstream.
sp
Tipo: string

Token de filtro do YouTube (paginação ou filtros avançados)

Respostas

200
Tipo: object · ResponseFc5Af1Fcba22_SearchResponse

Resposta bem-sucedida
ads
Tipo: array object[] · ResponseFc5Af1Fcba22_Ad[]

Resultados de anúncios

channel
Tipo: object · ResponseFc5Af1Fcba22_AdChannel
id
Tipo: string

ID do canal

link
Tipo: string

Link para o canal

title
Tipo: string

Nome do canal

description
Tipo: string

Descrição do anúncio

id
Tipo: string

ID do vídeo em anúncios de vídeo

length
Tipo: string

Duração do vídeo em anúncios de vídeo

link
Tipo: string

Link do anúncio

position
Tipo: integer

Posição nos resultados de pesquisa

thumbnail
Tipo: string

URL da miniatura do anúncio

title
Tipo: string

Título do anúncio

website
Tipo: string

URL do site do anunciante

channels
Tipo: array object[] · ResponseFc5Af1Fcba22_Channel[]

Resultados de canais do YouTube

description
Tipo: string

Descrição do canal

id
Tipo: string

ID do canal do YouTube

is_verified
Tipo: boolean

Indica se o canal é verificado

link
Tipo: string

Link para o canal

position
Tipo: integer

Posição nos resultados de pesquisa

subscribers
Tipo: integer

Número de inscritos

thumbnail
Tipo: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Tipo: string

URL da miniatura rica/animada

static
Tipo: string

URL da miniatura estática

title
Tipo: string

Nome do canal

video_count
Tipo: integer

Número de vídeos

error
Tipo: string

Mensagem de erro se a pesquisa falhou

featured_channel
Tipo: object · ResponseFc5Af1Fcba22_FeaturedChannel
highlighted_video
Tipo: object · ResponseFc5Af1Fcba22_HighlightedVideo
id
Tipo: string

ID do vídeo

length
Tipo: string

Duração do vídeo

link
Tipo: string

Link para o vídeo

subtitle
Tipo: string

Subtítulo do vídeo

title
Tipo: string

Título do vídeo

id
Tipo: string

ID do canal em destaque

link
Tipo: string

Link para o canal em destaque

subtitle
Tipo: string

Subtítulo do canal em destaque

title
Tipo: string

Título do canal em destaque

videos
Tipo: array object[] · ResponseFc5Af1Fcba22_FeaturedVideo[]

Vídeos do canal em destaque

channel
Tipo: object · ResponseFc5Af1Fcba22_FeaturedVideoChannel
id
Tipo: string

ID do canal

link
Tipo: string

Link para o canal

title
Tipo: string

Nome do canal

id
Tipo: string

ID do vídeo

length
Tipo: string

Duração do vídeo

link
Tipo: string

Link para o vídeo

subtitle
Tipo: string

Subtítulo do vídeo

thumbnail
Tipo: string

URL da miniatura do vídeo

title
Tipo: string

Título do vídeo

movies
Tipo: array object[] · ResponseFc5Af1Fcba22_Movie[]

Resultados de filmes

badges
Tipo: array string[]

Selos do filme

buttons
Tipo: array string[]

Botões de ação

channel
Tipo: object · ResponseFc5Af1Fcba22_MovieChannel
id
Tipo: string

ID do canal

is_verified
Tipo: boolean

Indica se o canal é verificado

link
Tipo: string

Link para o canal

title
Tipo: string

Nome do canal

description
Tipo: string

Descrição do filme

id
Tipo: string

ID do vídeo do filme

length
Tipo: string

Duração do filme

link
Tipo: string

Link para o filme

metadata_items
Tipo: object · ResponseFc5Af1Fcba22_MetadataItems
bottom
Tipo: array string[]

Itens de metadados inferiores

top
Tipo: array string[]

Itens de metadados superiores

position
Tipo: integer

Posição nos resultados de pesquisa

thumbnail
Tipo: string

URL da miniatura do filme

title
Tipo: string

Título do filme

pagination
Tipo: object · ResponseFc5Af1Fcba22_Pagination
next_page_token
Tipo: string

Token para buscar a próxima página de resultados

people_also_search_for
Tipo: array object[] · ResponseFc5Af1Fcba22_PeopleAlsoSearchFor[]

Sugestões de pesquisa relacionadas

link
Tipo: string

Link para executar a pesquisa

query
Tipo: string

Consulta de pesquisa sugerida

thumbnail
Tipo: string

Miniatura da sugestão

playlists
Tipo: array object[] · ResponseFc5Af1Fcba22_Playlist[]

Resultados de playlists

channel
Tipo: object · ResponseFc5Af1Fcba22_PlaylistChannel
id
Tipo: string

ID do canal

is_verified
Tipo: boolean

Indica se o canal é verificado

link
Tipo: string

Link para o canal

title
Tipo: string

Nome do canal

id
Tipo: string

ID da playlist

link
Tipo: string

Link para a playlist

position
Tipo: integer

Posição nos resultados de pesquisa

published_time
Tipo: string

Tempo desde a publicação

thumbnail
Tipo: string

URL da miniatura da playlist

title
Tipo: string

Título da playlist

video_count
Tipo: integer

Número de vídeos na playlist

videos
Tipo: array object[] · ResponseFc5Af1Fcba22_PlaylistVideo[]

Vídeos na playlist

id
Tipo: string

ID do vídeo

length
Tipo: string

Duração do vídeo

link
Tipo: string

Link para o vídeo

title
Tipo: string

Título do vídeo

posts
Tipo: array object[] · ResponseFc5Af1Fcba22_Posts[]

Resultados de posts da comunidade

items
Tipo: array object[] · ResponseFc5Af1Fcba22_Post[]

Posts da comunidade

channel
Tipo: object · ResponseFc5Af1Fcba22_PostChannel
id
Tipo: string

ID do canal

is_verified
Tipo: boolean

Indica se o canal é verificado

link
Tipo: string

Link para o canal

thumbnail
Tipo: string

URL da miniatura do canal

title
Tipo: string

Nome do canal

comments
Tipo: string

Número de comentários (texto)

extracted_comments
Tipo: integer

Número de comentários como inteiro

extracted_likes
Tipo: integer

Número de curtidas como inteiro

id
Tipo: string

ID do post

likes
Tipo: string

Número de curtidas (texto)

link
Tipo: string

Link para o post

position
Tipo: integer

Posição na seção de posts

published_time
Tipo: string

Tempo desde a publicação

text
Tipo: string

Conteúdo de texto do post

thumbnail
Tipo: string

URL da miniatura do post

position
Tipo: integer

Posição nos resultados de pesquisa

section_title
Tipo: string

Título da seção de posts

search_information
Tipo: object · ResponseFc5Af1Fcba22_SearchInformation
corrected_query
Tipo: string

Consulta corrigida, se uma correção ortográfica foi aplicada

original_query
Tipo: string

Consulta original antes da correção

original_query_sp
Tipo: string

Parâmetro SP da consulta original

state
Tipo: string

Estado da correção da consulta, se aplicável

total_results
Tipo: integer

Número total de resultados encontrados

search_metadata
Tipo: object · ResponseFc5Af1Fcba22_SearchMetadata
created_at
Tipo: string Formato: date-time
obrigatório

Timestamp de criação da pesquisa

id
Tipo: string
obrigatório

Identificador exclusivo da solicitação de pesquisa

status
Tipo: string
obrigatório

Status da solicitação de pesquisa

html_url
Tipo: string

URL para ver os resultados em HTML

json_url
Tipo: string

URL para ver os resultados em JSON

parsing_time_taken
Tipo: number

Tempo gasto para analisar os resultados, em segundos

request_time_taken
Tipo: number

Tempo gasto para fazer a solicitação, em segundos

request_url
Tipo: string

URL do YouTube para esta pesquisa

total_time_taken
Tipo: number

Tempo total da pesquisa, em segundos

search_parameters
Tipo: object · ResponseFc5Af1Fcba22_SearchParameters
engine
Tipo: string

Mecanismo de pesquisa usado

gl
Tipo: string

Código de país usado

hl
Tipo: string

Idioma da interface usado

q
Tipo: string

Consulta de pesquisa usada

sp
Tipo: string

Parâmetro de filtro/paginação usado

sections
Tipo: array object[] · ResponseFc5Af1Fcba22_Section[]

Resultados de seções

items
Tipo: array object[] · ResponseFc5Af1Fcba22_SectionItem[]

Itens na seção

channel
Tipo: object · ResponseFc5Af1Fcba22_SectionChannel
id
Tipo: string

ID do canal

link
Tipo: string

Link para o canal

title
Tipo: string

Nome do canal

id
Tipo: string

ID do item

length
Tipo: string

Duração do item

link
Tipo: string

Link para o item

published_time
Tipo: string

Tempo desde a publicação

thumbnail
Tipo: string

URL da miniatura do item

title
Tipo: string

Título do item

views
Tipo: integer

Número de visualizações

position
Tipo: integer

Posição nos resultados de pesquisa

section_title
Tipo: string

Título da seção

shorts
Tipo: array object[] · ResponseFc5Af1Fcba22_Shorts[]

Resultados do YouTube Shorts

items
Tipo: array object[] · ResponseFc5Af1Fcba22_Short[]

Vídeos Shorts

duration
Tipo: string

Duração do Short

id
Tipo: string

ID do vídeo Short

link
Tipo: string

Link para o Short

position
Tipo: integer

Posição na seção de Shorts

thumbnail
Tipo: string

URL da miniatura do Short

title
Tipo: string

Título do Short

views
Tipo: integer

Número de visualizações

position
Tipo: integer

Posição nos resultados de pesquisa

section_title
Tipo: string

Título da seção de Shorts

suggestions
Tipo: array string[]

Sugestões de consulta de pesquisa

videos
Tipo: array object[] · ResponseFc5Af1Fcba22_Video[]

Resultados de pesquisa de vídeos

badges
Tipo: array string[]

Selos do vídeo

channel
Tipo: object · ResponseFc5Af1Fcba22_VideoChannel
id
Tipo: string

ID do canal

is_verified
Tipo: boolean

Indica se o canal é verificado

link
Tipo: string

Link para o canal

thumbnail
Tipo: string

URL da miniatura do canal

title
Tipo: string

Nome do canal

description
Tipo: string

Trecho da descrição do vídeo

id
Tipo: string

ID do vídeo do YouTube

is_live
Tipo: boolean

Indica se o vídeo está ao vivo no momento

key_moments
Tipo: array object[] · ResponseFc5Af1Fcba22_KeyMoment[]

Momentos-chave do vídeo

start_seconds
Tipo: integer

Horário de início do momento, em segundos

thumbnail
Tipo: string

URL da miniatura do momento-chave

title
Tipo: string

Título do momento-chave

length
Tipo: string

Duração do vídeo

link
Tipo: string

Link para o vídeo

position
Tipo: integer

Posição nos resultados de pesquisa

published_time
Tipo: string

Tempo desde a publicação

thumbnail
Tipo: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Tipo: string

URL da miniatura rica/animada

static
Tipo: string

URL da miniatura estática

title
Tipo: string

Título do vídeo

views
Tipo: integer

Número de visualizações
application/json
400

Não foi possível processar a requisição. Verifique os parâmetros da requisição.
401

É necessária uma chave de API da Felo válida.
402

A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.
403

A conta não tem permissão para realizar esta operação.
429

Um limite de requisições ou de gastos foi atingido.
502

O serviço não pôde concluir a requisição.
503

A API ou o serviço de cobrança está temporariamente indisponível.
504

O serviço atingiu o tempo limite ao processar a requisição.
default

Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor

application/json

get/v1/beta/youtube/search

curl 'https://openapi.felo.ai/v1/beta/youtube/search?engine=youtube&q=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Mostrar Schema

{
  "search_metadata": {
    "id": "string",
    "status": "string",
    "created_at": "2026-10-26T08:08:16.601Z",
    "request_time_taken": 1,
    "parsing_time_taken": 1,
    "total_time_taken": 1,
    "request_url": "string",
    "html_url": "string",
    "json_url": "string"
  },
  "search_parameters": {
    "engine": "string",
    "q": "string",
    "sp": "string",
    "hl": "string",
    "gl": "string"
  },
  "search_information": {
    "total_results": 1,
    "state": "string",
    "original_query": "string",
    "original_query_sp": "string",
    "corrected_query": "string"
  },
  "suggestions": [
    "string"
  ],
  "ads": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "description": "string",
      "website": "string",
      "channel": {
        "id": "string",
        "title": "string",
        "link": "string"
      },
      "length": "string",
      "thumbnail": "string"
    }
  ],
  "channels": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "description": "string",
      "is_verified": true,
      "video_count": 1,
      "subscribers": 1,
      "thumbnail": {
        "static": "string",
        "rich": "string"
      }
    }
  ],
  "movies": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "description": "string",
      "channel": {
        "id": "string",
        "title": "string",
        "link": "string",
        "is_verified": true
      },
      "length": "string",
      "metadata_items": {
        "top": [
          "string"
        ],
        "bottom": [
          "string"
        ]
      },
      "badges": [
        "string"
      ],
      "buttons": [
        "string"
      ],
      "thumbnail": "string"
    }
  ],
  "videos": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "description": "string",
      "views": 1,
      "is_live": true,
      "channel": {
        "id": "string",
        "title": "string",
        "link": "string",
        "is_verified": true,
        "thumbnail": "string"
      },
      "length": "string",
      "published_time": "string",
      "badges": [
        "string"
      ],
      "thumbnail": {
        "static": "string",
        "rich": "string"
      },
      "key_moments": [
        {
          "title": "string",
          "start_seconds": 1,
          "thumbnail": "string"
        }
      ]
    }
  ],
  "playlists": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "video_count": 1,
      "channel": {
        "id": "string",
        "title": "string",
        "is_verified": true,
        "link": "string"
      },
      "published_time": "string",
      "videos": [
        {
          "id": "string",
          "title": "string",
          "link": "string",
          "length": "string"
        }
      ],
      "thumbnail": "string"
    }
  ],
  "sections": [
    {
      "section_title": "string",
      "position": 1,
      "items": [
        {
          "id": "string",
          "title": "string",
          "link": "string",
          "channel": {
            "id": "string",
            "title": "string",
            "link": "string"
          },
          "views": 1,
          "published_time": "string",
          "length": "string",
          "thumbnail": "string"
        }
      ]
    }
  ],
  "shorts": [
    {
      "section_title": "string",
      "position": 1,
      "items": [
        {
          "position": 1,
          "id": "string",
          "title": "string",
          "link": "string",
          "duration": "string",
          "views": 1,
          "thumbnail": "string"
        }
      ]
    }
  ],
  "posts": [
    {
      "section_title": "string",
      "position": 1,
      "items": [
        {
          "position": 1,
          "id": "string",
          "link": "string",
          "text": "string",
          "likes": "string",
          "extracted_likes": 1,
          "comments": "string",
          "extracted_comments": 1,
          "channel": {
            "id": "string",
            "title": "string",
            "link": "string",
            "is_verified": true,
            "thumbnail": "string"
          },
          "published_time": "string",
          "thumbnail": "string"
        }
      ]
    }
  ],
  "people_also_search_for": [
    {
      "query": "string",
      "link": "string",
      "thumbnail": "string"
    }
  ],
  "featured_channel": {
    "id": "string",
    "title": "string",
    "subtitle": "string",
    "link": "string",
    "highlighted_video": {
      "id": "string",
      "title": "string",
      "subtitle": "string",
      "link": "string",
      "length": "string"
    },
    "videos": [
      {
        "id": "string",
        "title": "string",
        "subtitle": "string",
        "link": "string",
        "length": "string",
        "channel": {
          "id": "string",
          "title": "string",
          "link": "string"
        },
        "thumbnail": "string"
      }
    ]
  },
  "pagination": {
    "next_page_token": "string"
  },
  "error": "string"
}

Resposta bem-sucedida

Pesquisa no YouTube

AutenticaçãoRequired

YouTube Search

Pesquisa no YouTube

Referência de preços