v0.2.0-beta

OpenAPI 3.1.0

Búsqueda en YouTube

Felo API Support

MIT

Servidor

https://openapi.felo.ai

Bibliotecas cliente

Shell Curl

YouTube Search

Search videos, channels and playlists.

YouTube Search Operaciones

get/v1/beta/youtube/search

Búsqueda en YouTube

Busca en YouTube vídeos, canales y listas de reproducción. engine=youtube y q son obligatorios. Usa gl y hl para país e idioma, o sp para paginación y filtros avanzados.

Referencia de precios

Medición: base de costo fija por solicitud exitosa.
Estimación de referencia por solicitud: USD 0.0029.
Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe de cliente ya liquidado.

Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.

Parámetros de consulta

engine
enum
constante:
youtube
obligatorio

Identificador del motor SearchApi. Usa youtube para este endpoint de YouTube.
valores
- youtube
gl
Tipo: string

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

Idioma de la interfaz
q
Tipo: string
obligatorio

Consulta de búsqueda. Obligatoria en el entorno de ejecución y en SearchApi upstream.
sp
Tipo: string

Token de filtro de YouTube (paginación o filtros avanzados)

Respuestas

200
Tipo: object · ResponseFc5Af1Fcba22_SearchResponse

Respuesta correcta
ads
Tipo: array object[] · ResponseFc5Af1Fcba22_Ad[]

Resultados de anuncios

channel
Tipo: object · ResponseFc5Af1Fcba22_AdChannel
id
Tipo: string

ID del canal

link
Tipo: string

Enlace al canal

title
Tipo: string

Nombre del canal

description
Tipo: string

Descripción del anuncio

id
Tipo: string

ID del vídeo en anuncios de vídeo

length
Tipo: string

Duración del vídeo en anuncios de vídeo

link
Tipo: string

Enlace del anuncio

position
Tipo: integer

Posición en los resultados de búsqueda

thumbnail
Tipo: string

URL de la miniatura del anuncio

title
Tipo: string

Título del anuncio

website
Tipo: string

URL del sitio web del anunciante

channels
Tipo: array object[] · ResponseFc5Af1Fcba22_Channel[]

Resultados de canales de YouTube

description
Tipo: string

Descripción del canal

id
Tipo: string

ID del canal de YouTube

is_verified
Tipo: boolean

Indica si el canal está verificado

link
Tipo: string

Enlace al canal

position
Tipo: integer

Posición en los resultados de búsqueda

subscribers
Tipo: integer

Número de suscriptores

thumbnail
Tipo: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Tipo: string

URL de la miniatura enriquecida/animada

static
Tipo: string

URL de la miniatura estática

title
Tipo: string

Nombre del canal

video_count
Tipo: integer

Número de vídeos

error
Tipo: string

Mensaje de error si la búsqueda falló

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

ID del vídeo

length
Tipo: string

Duración del vídeo

link
Tipo: string

Enlace al vídeo

subtitle
Tipo: string

Subtítulo del vídeo

title
Tipo: string

Título del vídeo

id
Tipo: string

ID del canal destacado

link
Tipo: string

Enlace al canal destacado

subtitle
Tipo: string

Subtítulo del canal destacado

title
Tipo: string

Título del canal destacado

videos
Tipo: array object[] · ResponseFc5Af1Fcba22_FeaturedVideo[]

Vídeos del canal destacado

channel
Tipo: object · ResponseFc5Af1Fcba22_FeaturedVideoChannel
id
Tipo: string

ID del canal

link
Tipo: string

Enlace al canal

title
Tipo: string

Nombre del canal

id
Tipo: string

ID del vídeo

length
Tipo: string

Duración del vídeo

link
Tipo: string

Enlace al vídeo

subtitle
Tipo: string

Subtítulo del vídeo

thumbnail
Tipo: string

URL de la miniatura del vídeo

title
Tipo: string

Título del vídeo

movies
Tipo: array object[] · ResponseFc5Af1Fcba22_Movie[]

Resultados de películas

badges
Tipo: array string[]

Insignias de la película

buttons
Tipo: array string[]

Botones de acción

channel
Tipo: object · ResponseFc5Af1Fcba22_MovieChannel
id
Tipo: string

ID del canal

is_verified
Tipo: boolean

Indica si el canal está verificado

link
Tipo: string

Enlace al canal

title
Tipo: string

Nombre del canal

description
Tipo: string

Descripción de la película

id
Tipo: string

ID del vídeo de la película

length
Tipo: string

Duración de la película

link
Tipo: string

Enlace a la película

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

Elementos de metadatos inferiores

top
Tipo: array string[]

Elementos de metadatos superiores

position
Tipo: integer

Posición en los resultados de búsqueda

thumbnail
Tipo: string

URL de la miniatura de la película

title
Tipo: string

Título de la película

pagination
Tipo: object · ResponseFc5Af1Fcba22_Pagination
next_page_token
Tipo: string

Token para obtener la siguiente página de resultados

people_also_search_for
Tipo: array object[] · ResponseFc5Af1Fcba22_PeopleAlsoSearchFor[]

Sugerencias de búsqueda relacionadas

link
Tipo: string

Enlace para realizar la búsqueda

query
Tipo: string

Consulta de búsqueda sugerida

thumbnail
Tipo: string

Miniatura de la sugerencia

playlists
Tipo: array object[] · ResponseFc5Af1Fcba22_Playlist[]

Resultados de listas de reproducción

channel
Tipo: object · ResponseFc5Af1Fcba22_PlaylistChannel
id
Tipo: string

ID del canal

is_verified
Tipo: boolean

Indica si el canal está verificado

link
Tipo: string

Enlace al canal

title
Tipo: string

Nombre del canal

id
Tipo: string

ID de la lista de reproducción

link
Tipo: string

Enlace a la lista de reproducción

position
Tipo: integer

Posición en los resultados de búsqueda

published_time
Tipo: string

Tiempo desde la publicación

thumbnail
Tipo: string

URL de la miniatura de la lista de reproducción

title
Tipo: string

Título de la lista de reproducción

video_count
Tipo: integer

Número de vídeos de la lista de reproducción

videos
Tipo: array object[] · ResponseFc5Af1Fcba22_PlaylistVideo[]

Vídeos de la lista de reproducción

id
Tipo: string

ID del vídeo

length
Tipo: string

Duración del vídeo

link
Tipo: string

Enlace al vídeo

title
Tipo: string

Título del vídeo

posts
Tipo: array object[] · ResponseFc5Af1Fcba22_Posts[]

Resultados de publicaciones de la comunidad

items
Tipo: array object[] · ResponseFc5Af1Fcba22_Post[]

Publicaciones de la comunidad

channel
Tipo: object · ResponseFc5Af1Fcba22_PostChannel
id
Tipo: string

ID del canal

is_verified
Tipo: boolean

Indica si el canal está verificado

link
Tipo: string

Enlace al canal

thumbnail
Tipo: string

URL de la miniatura del canal

title
Tipo: string

Nombre del canal

comments
Tipo: string

Número de comentarios (texto)

extracted_comments
Tipo: integer

Número de comentarios como entero

extracted_likes
Tipo: integer

Número de me gusta como entero

id
Tipo: string

ID de la publicación

likes
Tipo: string

Número de me gusta (texto)

link
Tipo: string

Enlace a la publicación

position
Tipo: integer

Posición en la sección de publicaciones

published_time
Tipo: string

Tiempo desde la publicación

text
Tipo: string

Contenido de texto de la publicación

thumbnail
Tipo: string

URL de la miniatura de la publicación

position
Tipo: integer

Posición en los resultados de búsqueda

section_title
Tipo: string

Título de la sección de publicaciones

search_information
Tipo: object · ResponseFc5Af1Fcba22_SearchInformation
corrected_query
Tipo: string

Consulta corregida si se aplicó una corrección ortográfica

original_query
Tipo: string

Consulta original antes de la corrección

original_query_sp
Tipo: string

Parámetro SP de la consulta original

state
Tipo: string

Estado de la corrección de la consulta, si corresponde

total_results
Tipo: integer

Número total de resultados encontrados

search_metadata
Tipo: object · ResponseFc5Af1Fcba22_SearchMetadata
created_at
Tipo: string Formato: date-time
obligatorio

Marca de tiempo de creación de la búsqueda

id
Tipo: string
obligatorio

Identificador exclusivo de la solicitud de búsqueda

status
Tipo: string
obligatorio

Estado de la solicitud de búsqueda

html_url
Tipo: string

URL para ver los resultados en HTML

json_url
Tipo: string

URL para ver los resultados en JSON

parsing_time_taken
Tipo: number

Tiempo empleado en analizar los resultados, en segundos

request_time_taken
Tipo: number

Tiempo empleado en realizar la solicitud, en segundos

request_url
Tipo: string

URL de YouTube para esta búsqueda

total_time_taken
Tipo: number

Tiempo total de la búsqueda, en segundos

search_parameters
Tipo: object · ResponseFc5Af1Fcba22_SearchParameters
engine
Tipo: string

Motor de búsqueda utilizado

gl
Tipo: string

Código de país utilizado

hl
Tipo: string

Idioma de la interfaz utilizado

q
Tipo: string

Consulta de búsqueda utilizada

sp
Tipo: string

Parámetro de filtro/paginación utilizado

sections
Tipo: array object[] · ResponseFc5Af1Fcba22_Section[]

Resultados de secciones

items
Tipo: array object[] · ResponseFc5Af1Fcba22_SectionItem[]

Elementos de la sección

channel
Tipo: object · ResponseFc5Af1Fcba22_SectionChannel
id
Tipo: string

ID del canal

link
Tipo: string

Enlace al canal

title
Tipo: string

Nombre del canal

id
Tipo: string

ID del elemento

length
Tipo: string

Duración del elemento

link
Tipo: string

Enlace al elemento

published_time
Tipo: string

Tiempo desde la publicación

thumbnail
Tipo: string

URL de la miniatura del elemento

title
Tipo: string

Título del elemento

views
Tipo: integer

Número de visualizaciones

position
Tipo: integer

Posición en los resultados de búsqueda

section_title
Tipo: string

Título de la sección

shorts
Tipo: array object[] · ResponseFc5Af1Fcba22_Shorts[]

Resultados de YouTube Shorts

items
Tipo: array object[] · ResponseFc5Af1Fcba22_Short[]

Vídeos Shorts

duration
Tipo: string

Duración del Short

id
Tipo: string

ID del vídeo Short

link
Tipo: string

Enlace al Short

position
Tipo: integer

Posición en la sección de Shorts

thumbnail
Tipo: string

URL de la miniatura del Short

title
Tipo: string

Título del Short

views
Tipo: integer

Número de visualizaciones

position
Tipo: integer

Posición en los resultados de búsqueda

section_title
Tipo: string

Título de la sección de Shorts

suggestions
Tipo: array string[]

Sugerencias de consulta de búsqueda

videos
Tipo: array object[] · ResponseFc5Af1Fcba22_Video[]

Resultados de búsqueda de vídeos

badges
Tipo: array string[]

Insignias del vídeo

channel
Tipo: object · ResponseFc5Af1Fcba22_VideoChannel
id
Tipo: string

ID del canal

is_verified
Tipo: boolean

Indica si el canal está verificado

link
Tipo: string

Enlace al canal

thumbnail
Tipo: string

URL de la miniatura del canal

title
Tipo: string

Nombre del canal

description
Tipo: string

Fragmento de la descripción del vídeo

id
Tipo: string

ID del vídeo de YouTube

is_live
Tipo: boolean

Indica si el vídeo está actualmente en directo

key_moments
Tipo: array object[] · ResponseFc5Af1Fcba22_KeyMoment[]

Momentos clave del vídeo

start_seconds
Tipo: integer

Hora de inicio del momento, en segundos

thumbnail
Tipo: string

URL de la miniatura del momento clave

title
Tipo: string

Título del momento clave

length
Tipo: string

Duración del vídeo

link
Tipo: string

Enlace al vídeo

position
Tipo: integer

Posición en los resultados de búsqueda

published_time
Tipo: string

Tiempo desde la publicación

thumbnail
Tipo: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Tipo: string

URL de la miniatura enriquecida/animada

static
Tipo: string

URL de la miniatura estática

title
Tipo: string

Título del vídeo

views
Tipo: integer

Número de visualizaciones
application/json
400

No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.
401

Se requiere una clave de API de Felo válida.
402

La solicitud no puede continuar porque no se cumple un requisito de facturación.
403

La cuenta no tiene permiso para realizar esta operación.
429

Se ha alcanzado un límite de solicitudes o de gasto.
502

El servicio no pudo completar la solicitud.
503

La API o el servicio de facturación no están disponibles temporalmente.
504

El servicio agotó el tiempo de espera al procesar la solicitud.
default

Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor

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 esquema

{
  "search_metadata": {
    "id": "string",
    "status": "string",
    "created_at": "2026-10-26T08:08:16.678Z",
    "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"
}

Respuesta correcta

Búsqueda en YouTube

AutenticaciónRequired

YouTube Search

Búsqueda en YouTube

Referencia de precios