Felo APIs

YouTube Subtitling API

Haal YouTube-ondertitels op met optionele taal- en timestamp-parameters.

GET/v2/youtube/subtitling

Authenticatie

Bearer API key

Inhoudstype

Niet vereist

Toelichting op limieten

Er kunnen limieten gelden die specifiek zijn voor het endpoint.

Web Fetch API

De YouTube Subtitling API haalt gestructureerde ondertitelgegevens op voor een YouTube-video. De API is bedoeld voor agents, tools voor contentanalyse, onderwijsproducten, zoekindexen en workflows die video-inhoud als tekst nodig hebben.

Endpoint

GET https://openapi.felo.ai/v2/youtube/subtitling

Authenticatie

Stuur je API-sleutel mee in de Authorization-header:

Authorization: Bearer YOUR_API_KEY

Zie de authenticatiehandleiding voor het aanmaken en beheren van API-sleutels.

Gebruik met AI-agents

Installeer het volledige pakket felo-ai om een agent YouTube-ondertiteling en alle andere beschikbare Felo Skills te geven. Het installatieprogramma ontdekt dynamisch elke pakketmap die SKILL.md bevat, dus het is niet afhankelijk van een vaste Skills-lijst. Installeer alle gevonden Skills in Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills of Hermes Agent ~/.hermes/skills. Gebruik de handleiding voor handmatige AI-agentconfiguratie voor platformspecifieke configuratie en verificatie van de API-sleutel.

Verzoek

Queryparameters

Parameter	Type	Verplicht	Standaard	Beschrijving
`video_code`	string	Ja	-	YouTube-video-ID, zoals `dQw4w9WgXcQ`.
`language`	string	Nee	-	Taalcode van de ondertitels, zoals `en` of `zh-CN`. Als je dit weglaat, kiest de downstreamdienst een beschikbare taal.
`with_time`	boolean	Nee	`false`	Of tijdstempelvelden (`start` en `duration`) voor elk ondertitelitem moeten worden opgenomen.

De dienst gebruikt intern de volledige modus met titel en transcript. Je hoeft geen functietype of modusparameter mee te geven.

Respons

Succesrespons

{
  "status": "ok",
  "message": null,
  "data": {
    "title": "Example Video Title",
    "contents": [
      {
        "start": 0.32,
        "duration": 14.26,
        "text": "Subtitle text"
      }
    ]
  }
}

Responsvelden

Veld	Type	Beschrijving
`status`	string	Responsstatus. Meestal `ok` bij een geslaagd verzoek.
`message`	string of null	Aanvullend bericht. Meestal `null` bij geslaagde verzoeken.
`data.title`	string	Titel van de YouTube-video.
`data.contents`	array	Lijst met ondertitelitems.
`data.contents[].start`	number	Starttijd van de ondertitel in seconden. Wordt geretourneerd wanneer tijdstempelgegevens beschikbaar zijn, vooral bij `with_time=true`.
`data.contents[].duration`	number	Duur van de ondertitel in seconden. Wordt geretourneerd wanneer tijdstempelgegevens beschikbaar zijn, vooral bij `with_time=true`.
`data.contents[].text`	string	Tekstinhoud van de ondertitel.

Foutresponsen

HTTP-status	Foutcode	Beschrijving	Voorgestelde actie
400	`YOUTUBE_SUBTITLING_FAILED`	Validatie van het verzoek is mislukt, de video bestaat niet, er zijn geen ondertitels beschikbaar of de downstreamdienst retourneerde een fout aan de clientkant.	Controleer `video_code`, de beschikbaarheid van ondertitels en `language`.
401	`UNAUTHORIZED`	API-sleutel ontbreekt, is ongeldig of ingetrokken.	Controleer je API-sleutel en de autorisatieheader.
500	`YOUTUBE_SUBTITLING_FAILED`	Interne fout in de dienst.	Probeer het verzoek opnieuw. Neem contact op met support als het probleem aanhoudt.
502	`YOUTUBE_SUBTITLING_FAILED`	De downstreamdienst voor YouTube-ondertitels is mislukt of was niet beschikbaar.	Probeer het later opnieuw.

Voorbeelden

Basisverzoek

curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ" \
  -H "Authorization: Bearer YOUR_API_KEY"

Een specifieke taal opvragen

curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ&language=en" \
  -H "Authorization: Bearer YOUR_API_KEY"

Tijdstempels toevoegen

curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ&with_time=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Tijdstempels toevoegen voor een specifieke taal

curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ&language=zh-CN&with_time=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Gebruiksscenario's

Laat een agent een YouTube-video begrijpen voordat hij vragen beantwoordt.
Bouw een doorzoekbare tekstindex voor video-inhoud.
Bereid brontekst voor voor samenvattings- of vertaalworkflows.
Koppel gegenereerde notities of citaten terug aan tijdstempels.
Analyseer educatieve of onderzoeksvideo's zonder het videobestand te downloaden.

Opmerkingen

Deze API downloadt geen video of audio.
De API retourneert bestaande ondertitels. Er worden geen ondertitels gegenereerd voor video's zonder ondertitelgegevens.
Sommige video's hebben geen ondertitels of bieden de gevraagde taal niet.
Als je language weglaat, hangt de keuze van de ondertiteltaal af van wat downstream beschikbaar is.