v0.2.0-beta

OpenAPI 3.1.0

YouTube-zoekopdracht

Felo API Support

MIT

Server

https://openapi.felo.ai

Clientbibliotheken

Shell Curl

YouTube Search

Search videos, channels and playlists.

YouTube Search Operaties

get/v1/beta/youtube/search

YouTube-zoekopdracht

Doorzoekt YouTube op video's, kanalen en afspeellijsten. engine=youtube en q zijn verplicht. Gebruik gl en hl voor land en taal, of sp voor paginering en geavanceerde filters.

Prijsreferentie

Metering: Vaste kostenbasis per geslaagd verzoek.
Referentieschatting per verzoek: USD 0.0029.
Referentiemultiplier voor klanten: 1.0. Niet opnieuw toepassen op een al afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte en geen gegarandeerde prijs of bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Queryparameters

engine
enum
constante:
youtube
verplicht

SearchApi-engine-id. Gebruik youtube voor dit YouTube-endpoint.
waarden
- youtube
gl
Type: string

Landcode (bijv. us, jp)
hl
Type: string

Interfacetaal
q
Type: string
verplicht

Zoekopdracht. Vereist door de runtime en de upstream-SearchApi.
sp
Type: string

YouTube-filtertoken (paginering of geavanceerde filters)

Responsen

200
Type: object · ResponseFc5Af1Fcba22_SearchResponse

Geslaagde respons
ads
Type: array object[] · ResponseFc5Af1Fcba22_Ad[]

Advertentieresultaten

channel
Type: object · ResponseFc5Af1Fcba22_AdChannel
id
Type: string

Kanaal-ID

link
Type: string

Link naar het kanaal

title
Type: string

Kanaalnaam

description
Type: string

Advertentiebeschrijving

id
Type: string

Video-ID voor videoadvertenties

length
Type: string

Duur van de video voor videoadvertenties

link
Type: string

Advertentielink

position
Type: integer

Positie in de zoekresultaten

thumbnail
Type: string

URL van de advertentieminiatuur

title
Type: string

Advertentietitel

website
Type: string

Website-URL van de adverteerder

channels
Type: array object[] · ResponseFc5Af1Fcba22_Channel[]

Resultaten voor YouTube-kanalen

description
Type: string

Kanaalbeschrijving

id
Type: string

YouTube-kanaal-ID

is_verified
Type: boolean

Of het kanaal is geverifieerd

link
Type: string

Link naar het kanaal

position
Type: integer

Positie in de zoekresultaten

subscribers
Type: integer

Aantal abonnees

thumbnail
Type: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Type: string

URL van de rich/geanimeerde miniatuur

static
Type: string

URL van de statische miniatuur

title
Type: string

Kanaalnaam

video_count
Type: integer

Aantal video's

error
Type: string

Foutmelding als de zoekopdracht is mislukt

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

Video-ID

length
Type: string

Duur van de video

link
Type: string

Link naar de video

subtitle
Type: string

Ondertitel van de video

title
Type: string

Titel van de video

id
Type: string

ID van het uitgelichte kanaal

link
Type: string

Link naar het uitgelichte kanaal

subtitle
Type: string

Ondertitel van het uitgelichte kanaal

title
Type: string

Titel van het uitgelichte kanaal

videos
Type: array object[] · ResponseFc5Af1Fcba22_FeaturedVideo[]

Video's van het uitgelichte kanaal

channel
Type: object · ResponseFc5Af1Fcba22_FeaturedVideoChannel
id
Type: string

Kanaal-ID

link
Type: string

Link naar het kanaal

title
Type: string

Kanaalnaam

id
Type: string

Video-ID

length
Type: string

Duur van de video

link
Type: string

Link naar de video

subtitle
Type: string

Ondertitel van de video

thumbnail
Type: string

URL van de videominiatuur

title
Type: string

Titel van de video

movies
Type: array object[] · ResponseFc5Af1Fcba22_Movie[]

Filmresultaten

badges
Type: array string[]

Filmbadges

buttons
Type: array string[]

Actieknoppen

channel
Type: object · ResponseFc5Af1Fcba22_MovieChannel
id
Type: string

Kanaal-ID

is_verified
Type: boolean

Of het kanaal is geverifieerd

link
Type: string

Link naar het kanaal

title
Type: string

Kanaalnaam

description
Type: string

Beschrijving van de film

id
Type: string

Video-ID van de film

length
Type: string

Duur van de film

link
Type: string

Link naar de film

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

Metagegevens onderaan

top
Type: array string[]

Metagegevens bovenaan

position
Type: integer

Positie in de zoekresultaten

thumbnail
Type: string

URL van de filmminiatuur

title
Type: string

Titel van de film

pagination
Type: object · ResponseFc5Af1Fcba22_Pagination
next_page_token
Type: string

Token om de volgende pagina met resultaten op te halen

people_also_search_for
Type: array object[] · ResponseFc5Af1Fcba22_PeopleAlsoSearchFor[]

Gerelateerde zoeksuggesties

link
Type: string

Link om de zoekopdracht uit te voeren

query
Type: string

Voorgestelde zoekopdracht

thumbnail
Type: string

Miniatuur voor de suggestie

playlists
Type: array object[] · ResponseFc5Af1Fcba22_Playlist[]

Playlistresultaten

channel
Type: object · ResponseFc5Af1Fcba22_PlaylistChannel
id
Type: string

Kanaal-ID

is_verified
Type: boolean

Of het kanaal is geverifieerd

link
Type: string

Link naar het kanaal

title
Type: string

Kanaalnaam

id
Type: string

Playlist-ID

link
Type: string

Link naar de playlist

position
Type: integer

Positie in de zoekresultaten

published_time
Type: string

Tijd sinds publicatie

thumbnail
Type: string

URL van de playlistminiatuur

title
Type: string

Titel van de playlist

video_count
Type: integer

Aantal video's in de playlist

videos
Type: array object[] · ResponseFc5Af1Fcba22_PlaylistVideo[]

Video's in de playlist

id
Type: string

Video-ID

length
Type: string

Duur van de video

link
Type: string

Link naar de video

title
Type: string

Titel van de video

posts
Type: array object[] · ResponseFc5Af1Fcba22_Posts[]

Resultaten van communityberichten

items
Type: array object[] · ResponseFc5Af1Fcba22_Post[]

Communityberichten

channel
Type: object · ResponseFc5Af1Fcba22_PostChannel
id
Type: string

Kanaal-ID

is_verified
Type: boolean

Of het kanaal is geverifieerd

link
Type: string

Link naar het kanaal

thumbnail
Type: string

URL van de kanaalminiatuur

title
Type: string

Kanaalnaam

comments
Type: string

Aantal reacties als tekst

extracted_comments
Type: integer

Aantal reacties als geheel getal

extracted_likes
Type: integer

Aantal likes als geheel getal

id
Type: string

Post-ID

likes
Type: string

Aantal likes als tekst

link
Type: string

Link naar de post

position
Type: integer

Positie binnen de sectie berichten

published_time
Type: string

Tijd sinds publicatie

text
Type: string

Tekstinhoud van de post

thumbnail
Type: string

URL van de postminiatuur

position
Type: integer

Positie in de zoekresultaten

section_title
Type: string

Sectietitel voor berichten

search_information
Type: object · ResponseFc5Af1Fcba22_SearchInformation
corrected_query
Type: string

Gecorrigeerde zoekopdracht als een spellingcorrectie is toegepast

original_query
Type: string

Oorspronkelijke zoekopdracht vóór de correctie

original_query_sp
Type: string

SP-parameter voor de oorspronkelijke zoekopdracht

state
Type: string

Status van de correctie van de zoekopdracht, indien van toepassing

total_results
Type: integer

Totaal aantal gevonden resultaten

search_metadata
Type: object · ResponseFc5Af1Fcba22_SearchMetadata
created_at
Type: string Formaat: date-time
verplicht

Tijdstempel waarop de zoekopdracht is gemaakt

id
Type: string
verplicht

Unieke identificatie voor het zoekverzoek

status
Type: string
verplicht

Status van het zoekverzoek

html_url
Type: string

URL om de HTML-resultaten te bekijken

json_url
Type: string

URL om de JSON-resultaten te bekijken

parsing_time_taken
Type: number

Benodigde tijd om de resultaten te parseren in seconden

request_time_taken
Type: number

Benodigde tijd voor het verzoek in seconden

request_url
Type: string

YouTube-URL voor deze zoekopdracht

total_time_taken
Type: number

Totale tijd voor de zoekopdracht in seconden

search_parameters
Type: object · ResponseFc5Af1Fcba22_SearchParameters
engine
Type: string

Gebruikte zoekmachine

gl
Type: string

Gebruikte landcode

hl
Type: string

Gebruikte interfacetaal

q
Type: string

Gebruikte zoekopdracht

sp
Type: string

Gebruikte filter-/paginaparameter

sections
Type: array object[] · ResponseFc5Af1Fcba22_Section[]

Sectieresultaten

items
Type: array object[] · ResponseFc5Af1Fcba22_SectionItem[]

Items in de sectie

channel
Type: object · ResponseFc5Af1Fcba22_SectionChannel
id
Type: string

Kanaal-ID

link
Type: string

Link naar het kanaal

title
Type: string

Kanaalnaam

id
Type: string

Item-ID

length
Type: string

Duur van het item

link
Type: string

Link naar het item

published_time
Type: string

Tijd sinds publicatie

thumbnail
Type: string

URL van de itemminiatuur

title
Type: string

Titel van het item

views
Type: integer

Aantal weergaven

position
Type: integer

Positie in de zoekresultaten

section_title
Type: string

Sectietitel

shorts
Type: array object[] · ResponseFc5Af1Fcba22_Shorts[]

YouTube Shorts-resultaten

items
Type: array object[] · ResponseFc5Af1Fcba22_Short[]

Korte video's

duration
Type: string

Duur van de short

id
Type: string

Video-ID van de short

link
Type: string

Link naar de short

position
Type: integer

Positie binnen de shorts-sectie

thumbnail
Type: string

URL van de shortminiatuur

title
Type: string

Titel van de short

views
Type: integer

Aantal weergaven

position
Type: integer

Positie in de zoekresultaten

section_title
Type: string

Sectietitel voor shorts

suggestions
Type: array string[]

Suggesties voor zoekopdrachten

videos
Type: array object[] · ResponseFc5Af1Fcba22_Video[]

Videozoekresultaten

badges
Type: array string[]

Videobadges

channel
Type: object · ResponseFc5Af1Fcba22_VideoChannel
id
Type: string

Kanaal-ID

is_verified
Type: boolean

Of het kanaal is geverifieerd

link
Type: string

Link naar het kanaal

thumbnail
Type: string

URL van de kanaalminiatuur

title
Type: string

Kanaalnaam

description
Type: string

Fragment van de videobeschrijving

id
Type: string

YouTube-video-ID

is_live
Type: boolean

Of de video momenteel live is

key_moments
Type: array object[] · ResponseFc5Af1Fcba22_KeyMoment[]

Sleutelmomenten in de video

start_seconds
Type: integer

Starttijd van het moment in seconden

thumbnail
Type: string

URL van de miniatuur van het sleutelmoment

title
Type: string

Titel van het sleutelmoment

length
Type: string

Duur van de video

link
Type: string

Link naar de video

position
Type: integer

Positie in de zoekresultaten

published_time
Type: string

Tijd sinds publicatie

thumbnail
Type: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Type: string

URL van de rich/geanimeerde miniatuur

static
Type: string

URL van de statische miniatuur

title
Type: string

Titel van de video

views
Type: integer

Aantal weergaven
application/json
400

Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.
401

Een geldige Felo-API-sleutel is vereist.
402

Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.
403

Het account mag deze bewerking niet uitvoeren.
429

Een verzoek- of bestedingslimiet is bereikt.
502

De dienst kon het verzoek niet voltooien.
503

De API of factureringsdienst is tijdelijk niet beschikbaar.
504

Er is een time-out opgetreden bij het verwerken van het verzoek.
default

Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

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'

Schema tonen

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

Geslaagde respons

YouTube-zoekopdracht

AuthenticatieRequired

YouTube Search

YouTube-zoekopdracht

Prijsreferentie