v0.2.0-beta

OpenAPI 3.1.0

Recherche YouTube

Felo API Support

MIT

Serveur

https://openapi.felo.ai

Bibliothèques clientes

Shell Curl

YouTube Search

Search videos, channels and playlists.

YouTube Search Opérations

get/v1/beta/youtube/search

Recherche YouTube

Recherche sur YouTube des vidéos, des chaînes et des playlists. engine=youtube et q sont obligatoires. Utilisez gl et hl pour le pays et la langue, ou sp pour la pagination et les filtres avancés.

Référence tarifaire

Mesure : base de coût fixe par requête réussie.
Estimation de référence par requête : USD 0.0029.
Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.

Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.

Paramètres de requête

engine
enum
constante:
youtube
obligatoire

Identifiant du moteur SearchApi. Utilisez youtube pour ce point de terminaison YouTube.
valeurs
- youtube
gl
Type: string

Code pays (par exemple, us, jp)
hl
Type: string

Langue de l'interface
q
Type: string
obligatoire

Requête de recherche. Requise par l'environnement d'exécution et par SearchApi amont.
sp
Type: string

Jeton de filtre YouTube (pagination ou filtres avancés)

Réponses

200
Type: object · ResponseFc5Af1Fcba22_SearchResponse

Réponse réussie
ads
Type: array object[] · ResponseFc5Af1Fcba22_Ad[]

Résultats d'annonces

channel
Type: object · ResponseFc5Af1Fcba22_AdChannel
id
Type: string

ID de la chaîne

link
Type: string

Lien vers la chaîne

title
Type: string

Nom de la chaîne

description
Type: string

Description de l'annonce

id
Type: string

ID de la vidéo pour les annonces vidéo

length
Type: string

Durée de la vidéo pour les annonces vidéo

link
Type: string

Lien de l'annonce

position
Type: integer

Position dans les résultats de recherche

thumbnail
Type: string

URL de la vignette de l'annonce

title
Type: string

Titre de l'annonce

website
Type: string

URL du site web de l'annonceur

channels
Type: array object[] · ResponseFc5Af1Fcba22_Channel[]

Résultats de chaînes YouTube

description
Type: string

Description de la chaîne

id
Type: string

ID de la chaîne YouTube

is_verified
Type: boolean

Indique si la chaîne est vérifiée

link
Type: string

Lien vers la chaîne

position
Type: integer

Position dans les résultats de recherche

subscribers
Type: integer

Nombre d'abonnés

thumbnail
Type: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Type: string

URL de la vignette enrichie/animée

static
Type: string

URL de la vignette statique

title
Type: string

Nom de la chaîne

video_count
Type: integer

Nombre de vidéos

error
Type: string

Message d'erreur si la recherche a échoué

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

ID de la vidéo

length
Type: string

Durée de la vidéo

link
Type: string

Lien vers la vidéo

subtitle
Type: string

Sous-titre de la vidéo

title
Type: string

Titre de la vidéo

id
Type: string

ID de la chaîne mise en avant

link
Type: string

Lien vers la chaîne mise en avant

subtitle
Type: string

Sous-titre de la chaîne mise en avant

title
Type: string

Titre de la chaîne mise en avant

videos
Type: array object[] · ResponseFc5Af1Fcba22_FeaturedVideo[]

Vidéos de la chaîne mise en avant

channel
Type: object · ResponseFc5Af1Fcba22_FeaturedVideoChannel
id
Type: string

ID de la chaîne

link
Type: string

Lien vers la chaîne

title
Type: string

Nom de la chaîne

id
Type: string

ID de la vidéo

length
Type: string

Durée de la vidéo

link
Type: string

Lien vers la vidéo

subtitle
Type: string

Sous-titre de la vidéo

thumbnail
Type: string

URL de la vignette de la vidéo

title
Type: string

Titre de la vidéo

movies
Type: array object[] · ResponseFc5Af1Fcba22_Movie[]

Résultats de films

badges
Type: array string[]

Badges du film

buttons
Type: array string[]

Boutons d'action

channel
Type: object · ResponseFc5Af1Fcba22_MovieChannel
id
Type: string

ID de la chaîne

is_verified
Type: boolean

Indique si la chaîne est vérifiée

link
Type: string

Lien vers la chaîne

title
Type: string

Nom de la chaîne

description
Type: string

Description du film

id
Type: string

ID de la vidéo du film

length
Type: string

Durée du film

link
Type: string

Lien vers le film

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

Éléments de métadonnées du bas

top
Type: array string[]

Éléments de métadonnées du haut

position
Type: integer

Position dans les résultats de recherche

thumbnail
Type: string

URL de la vignette du film

title
Type: string

Titre du film

pagination
Type: object · ResponseFc5Af1Fcba22_Pagination
next_page_token
Type: string

Jeton pour récupérer la page de résultats suivante

people_also_search_for
Type: array object[] · ResponseFc5Af1Fcba22_PeopleAlsoSearchFor[]

Suggestions de recherche associées

link
Type: string

Lien pour effectuer la recherche

query
Type: string

Requête de recherche suggérée

thumbnail
Type: string

Vignette de la suggestion

playlists
Type: array object[] · ResponseFc5Af1Fcba22_Playlist[]

Résultats de playlists

channel
Type: object · ResponseFc5Af1Fcba22_PlaylistChannel
id
Type: string

ID de la chaîne

is_verified
Type: boolean

Indique si la chaîne est vérifiée

link
Type: string

Lien vers la chaîne

title
Type: string

Nom de la chaîne

id
Type: string

ID de la playlist

link
Type: string

Lien vers la playlist

position
Type: integer

Position dans les résultats de recherche

published_time
Type: string

Temps écoulé depuis la publication

thumbnail
Type: string

URL de la vignette de la playlist

title
Type: string

Titre de la playlist

video_count
Type: integer

Nombre de vidéos dans la playlist

videos
Type: array object[] · ResponseFc5Af1Fcba22_PlaylistVideo[]

Vidéos de la playlist

id
Type: string

ID de la vidéo

length
Type: string

Durée de la vidéo

link
Type: string

Lien vers la vidéo

title
Type: string

Titre de la vidéo

posts
Type: array object[] · ResponseFc5Af1Fcba22_Posts[]

Résultats de publications de la communauté

items
Type: array object[] · ResponseFc5Af1Fcba22_Post[]

Publications de la communauté

channel
Type: object · ResponseFc5Af1Fcba22_PostChannel
id
Type: string

ID de la chaîne

is_verified
Type: boolean

Indique si la chaîne est vérifiée

link
Type: string

Lien vers la chaîne

thumbnail
Type: string

URL de la vignette de la chaîne

title
Type: string

Nom de la chaîne

comments
Type: string

Nombre de commentaires (texte)

extracted_comments
Type: integer

Nombre de commentaires sous forme d'entier

extracted_likes
Type: integer

Nombre de J'aime sous forme d'entier

id
Type: string

ID de la publication

likes
Type: string

Nombre de J'aime (texte)

link
Type: string

Lien vers la publication

position
Type: integer

Position dans la section des publications

published_time
Type: string

Temps écoulé depuis la publication

text
Type: string

Contenu textuel de la publication

thumbnail
Type: string

URL de la vignette de la publication

position
Type: integer

Position dans les résultats de recherche

section_title
Type: string

Titre de la section des publications

search_information
Type: object · ResponseFc5Af1Fcba22_SearchInformation
corrected_query
Type: string

Requête corrigée si une correction orthographique a été appliquée

original_query
Type: string

Requête d'origine avant correction

original_query_sp
Type: string

Paramètre SP de la requête d'origine

state
Type: string

État de la correction de la requête, le cas échéant

total_results
Type: integer

Nombre total de résultats trouvés

search_metadata
Type: object · ResponseFc5Af1Fcba22_SearchMetadata
created_at
Type: string Format: date-time
obligatoire

Horodatage de création de la recherche

id
Type: string
obligatoire

Identifiant unique de la requête de recherche

status
Type: string
obligatoire

Statut de la requête de recherche

html_url
Type: string

URL pour consulter les résultats HTML

json_url
Type: string

URL pour consulter les résultats JSON

parsing_time_taken
Type: number

Temps nécessaire pour analyser les résultats, en secondes

request_time_taken
Type: number

Temps nécessaire pour effectuer la requête, en secondes

request_url
Type: string

URL YouTube de cette recherche

total_time_taken
Type: number

Temps total de la recherche, en secondes

search_parameters
Type: object · ResponseFc5Af1Fcba22_SearchParameters
engine
Type: string

Moteur de recherche utilisé

gl
Type: string

Code pays utilisé

hl
Type: string

Langue de l'interface utilisée

q
Type: string

Requête de recherche utilisée

sp
Type: string

Paramètre de filtre/pagination utilisé

sections
Type: array object[] · ResponseFc5Af1Fcba22_Section[]

Résultats de sections

items
Type: array object[] · ResponseFc5Af1Fcba22_SectionItem[]

Éléments de la section

channel
Type: object · ResponseFc5Af1Fcba22_SectionChannel
id
Type: string

ID de la chaîne

link
Type: string

Lien vers la chaîne

title
Type: string

Nom de la chaîne

id
Type: string

ID de l'élément

length
Type: string

Durée de l'élément

link
Type: string

Lien vers l'élément

published_time
Type: string

Temps écoulé depuis la publication

thumbnail
Type: string

URL de la vignette de l'élément

title
Type: string

Titre de l'élément

views
Type: integer

Nombre de vues

position
Type: integer

Position dans les résultats de recherche

section_title
Type: string

Titre de la section

shorts
Type: array object[] · ResponseFc5Af1Fcba22_Shorts[]

Résultats YouTube Shorts

items
Type: array object[] · ResponseFc5Af1Fcba22_Short[]

Vidéos Shorts

duration
Type: string

Durée du Short

id
Type: string

ID de la vidéo Short

link
Type: string

Lien vers le Short

position
Type: integer

Position dans la section des Shorts

thumbnail
Type: string

URL de la vignette du Short

title
Type: string

Titre du Short

views
Type: integer

Nombre de vues

position
Type: integer

Position dans les résultats de recherche

section_title
Type: string

Titre de la section des Shorts

suggestions
Type: array string[]

Suggestions de requête de recherche

videos
Type: array object[] · ResponseFc5Af1Fcba22_Video[]

Résultats de recherche de vidéos

badges
Type: array string[]

Badges de la vidéo

channel
Type: object · ResponseFc5Af1Fcba22_VideoChannel
id
Type: string

ID de la chaîne

is_verified
Type: boolean

Indique si la chaîne est vérifiée

link
Type: string

Lien vers la chaîne

thumbnail
Type: string

URL de la vignette de la chaîne

title
Type: string

Nom de la chaîne

description
Type: string

Extrait de la description de la vidéo

id
Type: string

ID de la vidéo YouTube

is_live
Type: boolean

Indique si la vidéo est actuellement en direct

key_moments
Type: array object[] · ResponseFc5Af1Fcba22_KeyMoment[]

Moments clés de la vidéo

start_seconds
Type: integer

Heure de début du moment, en secondes

thumbnail
Type: string

URL de la vignette du moment clé

title
Type: string

Titre du moment clé

length
Type: string

Durée de la vidéo

link
Type: string

Lien vers la vidéo

position
Type: integer

Position dans les résultats de recherche

published_time
Type: string

Temps écoulé depuis la publication

thumbnail
Type: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Type: string

URL de la vignette enrichie/animée

static
Type: string

URL de la vignette statique

title
Type: string

Titre de la vidéo

views
Type: integer

Nombre de vues
application/json
400

La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
401

Une clé API Felo valide est requise.
402

La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
403

Le compte n'est pas autorisé à effectuer cette opération.
429

Une limite de requêtes ou de dépenses a été atteinte.
502

Le service n'a pas pu terminer la requête.
503

L'API ou le service de facturation est temporairement indisponible.
504

Le service a expiré lors du traitement de la requête.
default

Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur

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'

Afficher le schéma

{
  "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"
}

Réponse réussie

Recherche YouTube

AuthentificationRequired

YouTube Search

Recherche YouTube

Référence tarifaire