v0.2.0-beta

OpenAPI 3.1.0

Ricerca YouTube

Felo API Support

MIT

Server

https://openapi.felo.ai

Librerie client

Shell Curl

YouTube Search

Search videos, channels and playlists.

YouTube Search Operazioni

get/v1/beta/youtube/search

Ricerca YouTube

Cerca su YouTube video, canali e playlist. engine=youtube e q sono obbligatori. Usa gl e hl per paese e lingua, oppure sp per paginazione e filtri avanzati.

Riferimento prezzi

Misurazione: base di costo fissa per richiesta riuscita.
Stima di riferimento per richiesta: USD 0.0029.
Moltiplicatore di riferimento per il cliente: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.

Solo metadati di riferimento, non un preventivo dell'account né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Parametri di query

engine
enum
const:
youtube
obbligatorio

Identificatore del motore SearchApi. Usa youtube per questo endpoint YouTube.
valori
- youtube
gl
Tipo: string

Codice paese (ad es. us, jp)
hl
Tipo: string

Lingua dell'interfaccia
q
Tipo: string
obbligatorio

Query di ricerca. Obbligatoria per il runtime e per SearchApi upstream.
sp
Tipo: string

Token di filtro YouTube (paginazione o filtri avanzati)

Risposte

200
Tipo: object · ResponseFc5Af1Fcba22_SearchResponse

Risposta riuscita
ads
Tipo: array object[] · ResponseFc5Af1Fcba22_Ad[]

Risultati degli annunci

channel
Tipo: object · ResponseFc5Af1Fcba22_AdChannel
id
Tipo: string

ID del canale

link
Tipo: string

Link al canale

title
Tipo: string

Nome del canale

description
Tipo: string

Descrizione dell'annuncio

id
Tipo: string

ID video per gli annunci video

length
Tipo: string

Durata del video per gli annunci video

link
Tipo: string

Link dell'annuncio

position
Tipo: integer

Posizione nei risultati di ricerca

thumbnail
Tipo: string

URL dell'immagine in miniatura dell'annuncio

title
Tipo: string

Titolo dell'annuncio

website
Tipo: string

URL del sito web dell'inserzionista

channels
Tipo: array object[] · ResponseFc5Af1Fcba22_Channel[]

Risultati dei canali YouTube

description
Tipo: string

Descrizione del canale

id
Tipo: string

ID del canale YouTube

is_verified
Tipo: boolean

Indica se il canale è verificato

link
Tipo: string

Link al canale

position
Tipo: integer

Posizione nei risultati di ricerca

subscribers
Tipo: integer

Numero di iscritti

thumbnail
Tipo: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Tipo: string

URL dell'immagine in miniatura ricca/animata

static
Tipo: string

URL dell'immagine in miniatura statica

title
Tipo: string

Nome del canale

video_count
Tipo: integer

Numero di video

error
Tipo: string

Messaggio di errore se la ricerca non è riuscita

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

ID del video

length
Tipo: string

Durata del video

link
Tipo: string

Link al video

subtitle
Tipo: string

Sottotitolo del video

title
Tipo: string

Titolo del video

id
Tipo: string

ID del canale in evidenza

link
Tipo: string

Link al canale in evidenza

subtitle
Tipo: string

Sottotitolo del canale in evidenza

title
Tipo: string

Titolo del canale in evidenza

videos
Tipo: array object[] · ResponseFc5Af1Fcba22_FeaturedVideo[]

Video del canale in evidenza

channel
Tipo: object · ResponseFc5Af1Fcba22_FeaturedVideoChannel
id
Tipo: string

ID del canale

link
Tipo: string

Link al canale

title
Tipo: string

Nome del canale

id
Tipo: string

ID del video

length
Tipo: string

Durata del video

link
Tipo: string

Link al video

subtitle
Tipo: string

Sottotitolo del video

thumbnail
Tipo: string

URL dell'immagine in miniatura del video

title
Tipo: string

Titolo del video

movies
Tipo: array object[] · ResponseFc5Af1Fcba22_Movie[]

Risultati dei film

badges
Tipo: array string[]

Badge del film

buttons
Tipo: array string[]

Pulsanti di azione

channel
Tipo: object · ResponseFc5Af1Fcba22_MovieChannel
id
Tipo: string

ID del canale

is_verified
Tipo: boolean

Indica se il canale è verificato

link
Tipo: string

Link al canale

title
Tipo: string

Nome del canale

description
Tipo: string

Descrizione del film

id
Tipo: string

ID video del film

length
Tipo: string

Durata del film

link
Tipo: string

Link al film

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

Elementi di metadati in basso

top
Tipo: array string[]

Elementi di metadati in alto

position
Tipo: integer

Posizione nei risultati di ricerca

thumbnail
Tipo: string

URL dell'immagine in miniatura del film

title
Tipo: string

Titolo del film

pagination
Tipo: object · ResponseFc5Af1Fcba22_Pagination
next_page_token
Tipo: string

Token per recuperare la pagina successiva dei risultati

people_also_search_for
Tipo: array object[] · ResponseFc5Af1Fcba22_PeopleAlsoSearchFor[]

Suggerimenti di ricerca correlati

link
Tipo: string

Link per eseguire la ricerca

query
Tipo: string

Query di ricerca suggerita

thumbnail
Tipo: string

Miniatura per il suggerimento

playlists
Tipo: array object[] · ResponseFc5Af1Fcba22_Playlist[]

Risultati delle playlist

channel
Tipo: object · ResponseFc5Af1Fcba22_PlaylistChannel
id
Tipo: string

ID del canale

is_verified
Tipo: boolean

Indica se il canale è verificato

link
Tipo: string

Link al canale

title
Tipo: string

Nome del canale

id
Tipo: string

ID della playlist

link
Tipo: string

Link alla playlist

position
Tipo: integer

Posizione nei risultati di ricerca

published_time
Tipo: string

Tempo trascorso dalla pubblicazione

thumbnail
Tipo: string

URL dell'immagine in miniatura della playlist

title
Tipo: string

Titolo della playlist

video_count
Tipo: integer

Numero di video nella playlist

videos
Tipo: array object[] · ResponseFc5Af1Fcba22_PlaylistVideo[]

Video nella playlist

id
Tipo: string

ID del video

length
Tipo: string

Durata del video

link
Tipo: string

Link al video

title
Tipo: string

Titolo del video

posts
Tipo: array object[] · ResponseFc5Af1Fcba22_Posts[]

Risultati dei post della community

items
Tipo: array object[] · ResponseFc5Af1Fcba22_Post[]

Post della community

channel
Tipo: object · ResponseFc5Af1Fcba22_PostChannel
id
Tipo: string

ID del canale

is_verified
Tipo: boolean

Indica se il canale è verificato

link
Tipo: string

Link al canale

thumbnail
Tipo: string

URL dell'immagine in miniatura del canale

title
Tipo: string

Nome del canale

comments
Tipo: string

Numero di commenti come testo

extracted_comments
Tipo: integer

Numero di commenti come intero

extracted_likes
Tipo: integer

Numero di like come intero

id
Tipo: string

ID del post

likes
Tipo: string

Numero di like come testo

link
Tipo: string

Link al post

position
Tipo: integer

Posizione nella sezione dei post

published_time
Tipo: string

Tempo trascorso dalla pubblicazione

text
Tipo: string

Contenuto testuale del post

thumbnail
Tipo: string

URL dell'immagine in miniatura del post

position
Tipo: integer

Posizione nei risultati di ricerca

section_title
Tipo: string

Titolo della sezione per i post

search_information
Tipo: object · ResponseFc5Af1Fcba22_SearchInformation
corrected_query
Tipo: string

Query corretta se è stata applicata una correzione ortografica

original_query
Tipo: string

Query originale prima della correzione

original_query_sp
Tipo: string

Parametro SP per la query originale

state
Tipo: string

Stato della correzione della query, se applicabile

total_results
Tipo: integer

Numero totale di risultati trovati

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

Timestamp di creazione della ricerca

id
Tipo: string
obbligatorio

Identificatore univoco per la richiesta di ricerca

status
Tipo: string
obbligatorio

Stato della richiesta di ricerca

html_url
Tipo: string

URL per visualizzare i risultati HTML

json_url
Tipo: string

URL per visualizzare i risultati JSON

parsing_time_taken
Tipo: number

Tempo impiegato per analizzare i risultati in secondi

request_time_taken
Tipo: number

Tempo impiegato per effettuare la richiesta in secondi

request_url
Tipo: string

URL YouTube per questa ricerca

total_time_taken
Tipo: number

Tempo totale impiegato per la ricerca in secondi

search_parameters
Tipo: object · ResponseFc5Af1Fcba22_SearchParameters
engine
Tipo: string

Motore di ricerca utilizzato

gl
Tipo: string

Codice paese utilizzato

hl
Tipo: string

Lingua dell'interfaccia utilizzata

q
Tipo: string

Query di ricerca utilizzata

sp
Tipo: string

Parametro di filtro/paginazione utilizzato

sections
Tipo: array object[] · ResponseFc5Af1Fcba22_Section[]

Risultati delle sezioni

items
Tipo: array object[] · ResponseFc5Af1Fcba22_SectionItem[]

Elementi nella sezione

channel
Tipo: object · ResponseFc5Af1Fcba22_SectionChannel
id
Tipo: string

ID del canale

link
Tipo: string

Link al canale

title
Tipo: string

Nome del canale

id
Tipo: string

ID dell'elemento

length
Tipo: string

Durata dell'elemento

link
Tipo: string

Link all'elemento

published_time
Tipo: string

Tempo trascorso dalla pubblicazione

thumbnail
Tipo: string

URL dell'immagine in miniatura dell'elemento

title
Tipo: string

Titolo dell'elemento

views
Tipo: integer

Numero di visualizzazioni

position
Tipo: integer

Posizione nei risultati di ricerca

section_title
Tipo: string

Titolo della sezione

shorts
Tipo: array object[] · ResponseFc5Af1Fcba22_Shorts[]

Risultati di YouTube Shorts

items
Tipo: array object[] · ResponseFc5Af1Fcba22_Short[]

Video brevi

duration
Tipo: string

Durata dello short

id
Tipo: string

ID video dello short

link
Tipo: string

Link allo short

position
Tipo: integer

Posizione nella sezione degli short

thumbnail
Tipo: string

URL dell'immagine in miniatura dello short

title
Tipo: string

Titolo dello short

views
Tipo: integer

Numero di visualizzazioni

position
Tipo: integer

Posizione nei risultati di ricerca

section_title
Tipo: string

Titolo della sezione per gli short

suggestions
Tipo: array string[]

Suggerimenti per le query di ricerca

videos
Tipo: array object[] · ResponseFc5Af1Fcba22_Video[]

Risultati della ricerca video

badges
Tipo: array string[]

Badge del video

channel
Tipo: object · ResponseFc5Af1Fcba22_VideoChannel
id
Tipo: string

ID del canale

is_verified
Tipo: boolean

Indica se il canale è verificato

link
Tipo: string

Link al canale

thumbnail
Tipo: string

URL dell'immagine in miniatura del canale

title
Tipo: string

Nome del canale

description
Tipo: string

Estratto della descrizione del video

id
Tipo: string

ID del video YouTube

is_live
Tipo: boolean

Indica se il video è attualmente in diretta

key_moments
Tipo: array object[] · ResponseFc5Af1Fcba22_KeyMoment[]

Momenti chiave nel video

start_seconds
Tipo: integer

Ora di inizio del momento in secondi

thumbnail
Tipo: string

URL dell'immagine in miniatura del momento chiave

title
Tipo: string

Titolo del momento chiave

length
Tipo: string

Durata del video

link
Tipo: string

Link al video

position
Tipo: integer

Posizione nei risultati di ricerca

published_time
Tipo: string

Tempo trascorso dalla pubblicazione

thumbnail
Tipo: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Tipo: string

URL dell'immagine in miniatura ricca/animata

static
Tipo: string

URL dell'immagine in miniatura statica

title
Tipo: string

Titolo del video

views
Tipo: integer

Numero di visualizzazioni
application/json
400

Impossibile elaborare la richiesta. Controlla i parametri della richiesta.
401

È richiesta una chiave API Felo valida.
402

Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.
403

L'account non è autorizzato a eseguire questa operazione.
429

È stato raggiunto un limite di richieste o di spesa.
502

Il servizio non è riuscito a completare la richiesta.
503

L'API o il servizio di fatturazione è temporaneamente non disponibile.
504

Si è verificato un timeout durante l'elaborazione della richiesta.
default

Risposta di errore; le risposte passthrough upstream possono usare formati del provider

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'

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

Risposta riuscita

Ricerca YouTube

AutenticazioneRequired

YouTube Search

Ricerca YouTube

Riferimento prezzi