v0.2.0-beta

OpenAPI 3.1.0

YouTube-Suche

Felo API Support

MIT

Server

https://openapi.felo.ai

Client-Bibliotheken

Shell Curl

YouTube Search

Search videos, channels and playlists.

YouTube Search Operationen

get/v1/beta/youtube/search

YouTube-Suche

Durchsucht YouTube nach Videos, Kanälen und Playlists. engine=youtube und q sind erforderlich. Verwenden Sie gl und hl für Land und Sprache oder sp für Paginierung und erweiterte Filter.

Preisreferenz

Abrechnung: Feste Kostenbasis pro erfolgreicher Anfrage.
Referenzschätzung pro Anfrage: USD 0.0029.
Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf bereits abgerechnete Kundenbeträge anwenden.

Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Query-Parameter

engine
enum
Konstante:
youtube
erforderlich

SearchApi-Engine-Kennung. Verwenden Sie youtube für diesen YouTube-Endpunkt.
Werte
- youtube
gl
Typ: string

Ländercode (z. B. us, jp)
hl
Typ: string

Sprache der Benutzeroberfläche
q
Typ: string
erforderlich

Suchanfrage. Erforderlich für die Laufzeit und die Upstream-SearchApi.
sp
Typ: string

YouTube-Filtertoken (Paginierung oder erweiterte Filter)

Antworten

200
Typ: object · ResponseFc5Af1Fcba22_SearchResponse

Erfolgreiche Antwort
ads
Typ: array object[] · ResponseFc5Af1Fcba22_Ad[]

Anzeigenergebnisse

channel
Typ: object · ResponseFc5Af1Fcba22_AdChannel
id
Typ: string

Kanal-ID

link
Typ: string

Link zum Kanal

title
Typ: string

Kanalname

description
Typ: string

Anzeigenbeschreibung

id
Typ: string

Video-ID für Videoanzeigen

length
Typ: string

Videodauer für Videoanzeigen

link
Typ: string

Anzeigenlink

position
Typ: integer

Position in den Suchergebnissen

thumbnail
Typ: string

Vorschaubild-URL der Anzeige

title
Typ: string

Anzeigentitel

website
Typ: string

Website-URL des Werbetreibenden

channels
Typ: array object[] · ResponseFc5Af1Fcba22_Channel[]

Ergebnisse für YouTube-Kanäle

description
Typ: string

Kanalbeschreibung

id
Typ: string

YouTube-Kanal-ID

is_verified
Typ: boolean

Gibt an, ob der Kanal verifiziert ist

link
Typ: string

Link zum Kanal

position
Typ: integer

Position in den Suchergebnissen

subscribers
Typ: integer

Anzahl der Abonnenten

thumbnail
Typ: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Typ: string

Vorschaubild-URL (Rich/animiert)

static
Typ: string

Statische Vorschaubild-URL

title
Typ: string

Kanalname

video_count
Typ: integer

Anzahl der Videos

error
Typ: string

Fehlermeldung, wenn die Suche fehlgeschlagen ist

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

Video-ID

length
Typ: string

Videodauer

link
Typ: string

Link zum Video

subtitle
Typ: string

Videountertitel

title
Typ: string

Videotitel

id
Typ: string

ID des hervorgehobenen Kanals

link
Typ: string

Link zum hervorgehobenen Kanal

subtitle
Typ: string

Untertitel des hervorgehobenen Kanals

title
Typ: string

Titel des hervorgehobenen Kanals

videos
Typ: array object[] · ResponseFc5Af1Fcba22_FeaturedVideo[]

Videos des hervorgehobenen Kanals

channel
Typ: object · ResponseFc5Af1Fcba22_FeaturedVideoChannel
id
Typ: string

Kanal-ID

link
Typ: string

Link zum Kanal

title
Typ: string

Kanalname

id
Typ: string

Video-ID

length
Typ: string

Videodauer

link
Typ: string

Link zum Video

subtitle
Typ: string

Videountertitel

thumbnail
Typ: string

Vorschaubild-URL des Videos

title
Typ: string

Videotitel

movies
Typ: array object[] · ResponseFc5Af1Fcba22_Movie[]

Filmergebnisse

badges
Typ: array string[]

Film-Badges

buttons
Typ: array string[]

Aktionsschaltflächen

channel
Typ: object · ResponseFc5Af1Fcba22_MovieChannel
id
Typ: string

Kanal-ID

is_verified
Typ: boolean

Gibt an, ob der Kanal verifiziert ist

link
Typ: string

Link zum Kanal

title
Typ: string

Kanalname

description
Typ: string

Filmbeschreibung

id
Typ: string

Video-ID des Films

length
Typ: string

Filmdauer

link
Typ: string

Link zum Film

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

Untere Metadateneinträge

top
Typ: array string[]

Obere Metadateneinträge

position
Typ: integer

Position in den Suchergebnissen

thumbnail
Typ: string

Vorschaubild-URL des Films

title
Typ: string

Filmtitel

pagination
Typ: object · ResponseFc5Af1Fcba22_Pagination
next_page_token
Typ: string

Token zum Abrufen der nächsten Ergebnisseite

people_also_search_for
Typ: array object[] · ResponseFc5Af1Fcba22_PeopleAlsoSearchFor[]

Verwandte Suchvorschläge

link
Typ: string

Link zum Ausführen der Suche

query
Typ: string

Vorgeschlagene Suchanfrage

thumbnail
Typ: string

Vorschaubild für den Vorschlag

playlists
Typ: array object[] · ResponseFc5Af1Fcba22_Playlist[]

Playlist-Ergebnisse

channel
Typ: object · ResponseFc5Af1Fcba22_PlaylistChannel
id
Typ: string

Kanal-ID

is_verified
Typ: boolean

Gibt an, ob der Kanal verifiziert ist

link
Typ: string

Link zum Kanal

title
Typ: string

Kanalname

id
Typ: string

Playlist-ID

link
Typ: string

Link zur Playlist

position
Typ: integer

Position in den Suchergebnissen

published_time
Typ: string

Zeit seit der Veröffentlichung

thumbnail
Typ: string

Vorschaubild-URL der Playlist

title
Typ: string

Playlist-Titel

video_count
Typ: integer

Anzahl der Videos in der Playlist

videos
Typ: array object[] · ResponseFc5Af1Fcba22_PlaylistVideo[]

Videos in der Playlist

id
Typ: string

Video-ID

length
Typ: string

Videodauer

link
Typ: string

Link zum Video

title
Typ: string

Videotitel

posts
Typ: array object[] · ResponseFc5Af1Fcba22_Posts[]

Ergebnisse für Community-Beiträge

items
Typ: array object[] · ResponseFc5Af1Fcba22_Post[]

Community-Beiträge

channel
Typ: object · ResponseFc5Af1Fcba22_PostChannel
id
Typ: string

Kanal-ID

is_verified
Typ: boolean

Gibt an, ob der Kanal verifiziert ist

link
Typ: string

Link zum Kanal

thumbnail
Typ: string

Vorschaubild-URL des Kanals

title
Typ: string

Kanalname

comments
Typ: string

Anzahl der Kommentare als Text

extracted_comments
Typ: integer

Anzahl der Kommentare als Ganzzahl

extracted_likes
Typ: integer

Anzahl der Likes als Ganzzahl

id
Typ: string

Beitrags-ID

likes
Typ: string

Anzahl der Likes als Text

link
Typ: string

Link zum Beitrag

position
Typ: integer

Position im Bereich „Beiträge“

published_time
Typ: string

Zeit seit der Veröffentlichung

text
Typ: string

Textinhalt des Beitrags

thumbnail
Typ: string

Vorschaubild-URL des Beitrags

position
Typ: integer

Position in den Suchergebnissen

section_title
Typ: string

Bereichstitel für Beiträge

search_information
Typ: object · ResponseFc5Af1Fcba22_SearchInformation
corrected_query
Typ: string

Korrigierte Suchanfrage, falls eine Rechtschreibkorrektur angewendet wurde

original_query
Typ: string

Ursprüngliche Suchanfrage vor der Korrektur

original_query_sp
Typ: string

SP-Parameter für die ursprüngliche Suchanfrage

state
Typ: string

Status der Suchanfragenkorrektur, falls zutreffend

total_results
Typ: integer

Gesamtzahl der gefundenen Ergebnisse

search_metadata
Typ: object · ResponseFc5Af1Fcba22_SearchMetadata
created_at
Typ: string Format: date-time
erforderlich

Zeitstempel der Erstellung der Suche

id
Typ: string
erforderlich

Eindeutige Kennung für die Suchanfrage

status
Typ: string
erforderlich

Status der Suchanfrage

html_url
Typ: string

URL zum Anzeigen der HTML-Ergebnisse

json_url
Typ: string

URL zum Anzeigen der JSON-Ergebnisse

parsing_time_taken
Typ: number

Benötigte Zeit zum Parsen der Ergebnisse in Sekunden

request_time_taken
Typ: number

Benötigte Zeit für die Anfrage in Sekunden

request_url
Typ: string

YouTube-URL für diese Suche

total_time_taken
Typ: number

Gesamtzeit der Suche in Sekunden

search_parameters
Typ: object · ResponseFc5Af1Fcba22_SearchParameters
engine
Typ: string

Verwendete Suchmaschine

gl
Typ: string

Verwendeter Ländercode

hl
Typ: string

Verwendete Oberflächensprache

q
Typ: string

Verwendete Suchanfrage

sp
Typ: string

Verwendeter Filter-/Paginierungsparameter

sections
Typ: array object[] · ResponseFc5Af1Fcba22_Section[]

Bereichsergebnisse

items
Typ: array object[] · ResponseFc5Af1Fcba22_SectionItem[]

Einträge im Bereich

channel
Typ: object · ResponseFc5Af1Fcba22_SectionChannel
id
Typ: string

Kanal-ID

link
Typ: string

Link zum Kanal

title
Typ: string

Kanalname

id
Typ: string

Element-ID

length
Typ: string

Dauer des Elements

link
Typ: string

Link zum Element

published_time
Typ: string

Zeit seit der Veröffentlichung

thumbnail
Typ: string

Vorschaubild-URL des Elements

title
Typ: string

Titel des Elements

views
Typ: integer

Anzahl der Aufrufe

position
Typ: integer

Position in den Suchergebnissen

section_title
Typ: string

Bereichstitel

shorts
Typ: array object[] · ResponseFc5Af1Fcba22_Shorts[]

YouTube-Shorts-Ergebnisse

items
Typ: array object[] · ResponseFc5Af1Fcba22_Short[]

Kurzvideos

duration
Typ: string

Dauer des Shorts

id
Typ: string

Video-ID des Shorts

link
Typ: string

Link zum Short

position
Typ: integer

Position im Shorts-Bereich

thumbnail
Typ: string

Vorschaubild-URL des Shorts

title
Typ: string

Titel des Shorts

views
Typ: integer

Anzahl der Aufrufe

position
Typ: integer

Position in den Suchergebnissen

section_title
Typ: string

Bereichstitel für Shorts

suggestions
Typ: array string[]

Suchanfragenvorschläge

videos
Typ: array object[] · ResponseFc5Af1Fcba22_Video[]

Videosuchergebnisse

badges
Typ: array string[]

Video-Badges

channel
Typ: object · ResponseFc5Af1Fcba22_VideoChannel
id
Typ: string

Kanal-ID

is_verified
Typ: boolean

Gibt an, ob der Kanal verifiziert ist

link
Typ: string

Link zum Kanal

thumbnail
Typ: string

Vorschaubild-URL des Kanals

title
Typ: string

Kanalname

description
Typ: string

Ausschnitt der Videobeschreibung

id
Typ: string

YouTube-Video-ID

is_live
Typ: boolean

Gibt an, ob das Video aktuell live ist

key_moments
Typ: array object[] · ResponseFc5Af1Fcba22_KeyMoment[]

Schlüsselmomente im Video

start_seconds
Typ: integer

Startzeit des Moments in Sekunden

thumbnail
Typ: string

Vorschaubild-URL des Schlüsselmoments

title
Typ: string

Titel des Schlüsselmoments

length
Typ: string

Videodauer

link
Typ: string

Link zum Video

position
Typ: integer

Position in den Suchergebnissen

published_time
Typ: string

Zeit seit der Veröffentlichung

thumbnail
Typ: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Typ: string

Vorschaubild-URL (Rich/animiert)

static
Typ: string

Statische Vorschaubild-URL

title
Typ: string

Videotitel

views
Typ: integer

Anzahl der Aufrufe
application/json
400

Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.
401

Ein gültiger Felo-API-Schlüssel ist erforderlich.
402

Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.
403

Das Konto ist für diesen Vorgang nicht berechtigt.
429

Ein Anfrage- oder Ausgabenlimit wurde erreicht.
502

Der Dienst konnte die Anfrage nicht abschließen.
503

Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.
504

Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.
default

Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

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 anzeigen

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

Erfolgreiche Antwort

YouTube-Suche

AuthentifizierungRequired

YouTube Search

YouTube-Suche

Preisreferenz