{"openapi":"3.0.0","info":{"description":"YouTube oEmbed API on youtubeoembed.googleapis.com: the oEmbed open-standard endpoint for YouTube. One public GET /oembed turns a YouTube URL (watch page, youtu.be link, playlist, live or embed URL) into the resource title, author, thumbnail and the ready-to-paste iframe embed-player HTML, in JSON or XML, with maxwidth/maxheight sizing. No authentication required; the response is byte-identical to the canonical www.youtube.com/oembed endpoint. Complements googleyoutube (Data API v3) — different host and surface.","version":[{"name":"v1","value":"v1"}]},"servers":[{"description":"YouTube oEmbed API on youtubeoembed.googleapis.com: the oEmbed open-standard endpoint for YouTube. One public GET /oembed turns a YouTube URL (watch page, youtu.be link, playlist, live or embed URL) into the resource title, author, thumbnail and the ready-to-paste iframe embed-player HTML, in JSON or XML, with maxwidth/maxheight sizing. No authentication required; the response is byte-identical to the canonical www.youtube.com/oembed endpoint. Complements googleyoutube (Data API v3) — different host and surface.","url":"https://api.apirails.com/googleyoutubeoembed"}],"paths":{"/oembed":{"get":{"tags":["Video Embeds"],"parameters":[{"name":"url","in":"query","description":"Required. The URL of the YouTube resource to embed — accepted schemes per the oEmbed provider registry: https://*.youtube.com/watch*, https://youtu.be/*, https://*.youtube.com/playlist?list=*, https://*.youtube.com/live*, https://*.youtube.com/embed*, https://*.youtube.com/v/*. Non-YouTube URLs answer 404 Not Found.","required":true,"schema":{"type":"string","example":""}},{"name":"format","in":"query","description":"Response format of the oEmbed payload: json (default) or xml.","required":false,"schema":{"type":"string","example":""}},{"name":"maxwidth","in":"query","description":"Maximum width of the embedded player in px; the response width/html iframe honor it (e.g. 400).","required":false,"schema":{"type":"integer","example":""}},{"name":"maxheight","in":"query","description":"Maximum height of the embedded player in px; the response height/html iframe honor it (e.g. 225).","required":false,"schema":{"type":"integer","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://oembed.com/","api_endpoint":"https://youtubeoembed.googleapis.com/oembed"},"summary":"Fetch a YouTube video embed code (oEmbed) — Oembed (get)","description":"Returns embed data for a YouTube video or playlist per the oEmbed open standard: given a YouTube URL (watch page, youtu.be short link, playlist, /live/ or /embed/ form), responds with the resource title, author, thumbnail and the ready-to-paste <iframe> embed-player HTML (src https://www.youtube.com/embed/{id}?feature=oembed) sized to maxwidth/maxheight when provided. JSON by default, XML with format=xml. Public endpoint — no credentials required (a presented API key is still validated; junk keys 400 API_KEY_INVALID with metadata.service youtubeoembed.googleapis.com). Byte-identical to the canonical www.youtube.com/oembed wire.","security":[{"bearerAuth":[]}]}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}