WordPress.com oEmbed-Anbieter

Dieser Text wurde mithilfe von KI übersetzt. Wenn Sie den Originaltext auf Englisch lesen möchten, klicken Sie hier.

Jeder Beitrag, jede Seite, jeder Anhang und jedes VideoPress-Video, das auf WordPress.com gehostet wird, unterstützt das oEmbed-Format über unsere öffentliche oEmbed-API.

Was ist das oEmbed-Format?

Das oEmbed-Format ermöglicht das Einbetten einer Darstellung einer URL auf Drittanbieter-Websites. Die WordPress.com oEmbed-API erlaubt es jeder Website, eingebettete Inhalte (wie Fotos oder Videos) von WordPress.com anzuzeigen, wenn ein Benutzer einen Link zu dieser Ressource postet, ohne die Ressource direkt parsen zu müssen.

oEmbed-Endpunkt

Der WordPress.com oEmbed-API-Endpunkt ist verfügbar unter: https://public-api.wordpress.com/oembed/

Query-String-Parameter

Die WordPress.com oEmbed-API unterstützt die folgenden Query-String-Parameter:

for (erforderlich): die anfragende Domain oder der Firmenname
url (erforderlich): die URL der angeforderten Ressource. Kann jede auf WordPress.com gehostete URL sein, einschließlich wordpress.com-, wp.me-, videopress.com-Domains und -Subdomains oder jede Top-Level-Domain, die bei WordPress.com gehostet wird, zum Beispiel TechCrunch, CNN Press Room usw.
format: json oder xml, Standardwert ist json.
callback: bei Verwendung mit json eine JavaScript-Callback-Funktion, die um die Ausgabe gewrappt werden soll.
maxwidth: maximale Breite für Bilder/Thumbnails, Standardwert ist 440px
maxheight: maximale Höhe für Bilder/Thumbnails, Standardwert ist 330px.
img_size: Alternative zum Setzen von maxwidth und/oder maxheight, Angabe als [Breite]x[Höhe], Standardwert ist 440x330px.
as_article: true oder false, löst die nicht-standardmäßige Artikel-Erweiterung für Beiträge/Seiten aus.

Der Parameter as_article löst eine nicht-standardmäßige oEmbed-Ausgabe vom Typ type: article aus. Wenn Inhalte als as_article ausgeliefert werden, befindet sich der Artikelinhalt in einer body-Eigenschaft anstelle der standardmäßigen html-Eigenschaft. Weitere nicht-standardmäßige Eigenschaften wie related_topics sind ebenfalls verfügbar.

Funktionen

Im as_article-Modus wird der Inhalt von Tags befreit und auf einen Auszug von ca. 256 Zeichen begrenzt.
Im Standardmodus (d. h. as_article=false) wird der Inhalt vollständig als Markup ausgeliefert oder als Auszug, sofern vom Autor bereitgestellt und so festgelegt.
Unterstützt Beiträge und Seiten als Link/HTML oder Artikel/Body (siehe Argument as_article).
Unterstützt Anhänge (Bilder/Medien/Dokumente) als Typ Link oder Typ Photo für Bilder (gif, jpg, jpeg, png).
Das Vorschaubild für Beiträge und Seiten wird als thumbnail_url verwendet, falls vorhanden. Andernfalls wird das erste Bild im Inhalt zurückgegeben.
Lokale und entfernte Bilder werden auf die gewünschten Abmessungen skaliert und/oder neu zugeschnitten, um Konsistenz zu gewährleisten, und anschließend für schnellere Ladezeiten zwischengespeichert (einschließlich CDN).
Unterstützt Geolokalisierungsdaten, sofern vom Autor bereitgestellt, über benutzerdefinierte Eigenschaften (geo_latitude, geo_longitude).
Unterstützt related_topics im as_article-Modus (as_article=true).

Antwortbeispiele

Basic-Anfrage, nur erforderliche Parameter übergeben:

https://public-api.wordpress.com/oembed/?for=develop.wordpress.com&url=https://wordpress.com/blog/2025/06/13/wordcamp-europe-2025-recap-connecting-and-learning-in-basel-switzerland/

Antwort:

{
  "version": "1.0",
  "provider_name": "WordPress.com News",
  "provider_url": "http://en.blog.wordpress.com",
  "author_name": "Nick Schäferhoff",
  "author_url": "https://en.blog.wordpress.com/author/nschaeferhoff/",
  "title": "WordCamp Europe 2025 Recap: Connecting and Learning in Basel, Switzerland",
  "html": "<blockquote class="wp-embedded-content" data-secret="g3Lu0xsMqa"><a href="https://en.blog.wordpress.com/2025/06/13/wordcamp-europe-2025-recap-connecting-and-learning-in-basel-switzerland/">WordCamp Europe 2025 Recap: Connecting and Learning in Basel, Switzerland</a></blockquote>https://en.blog.wordpress.com/2025/06/13/wordcamp-europe-2025-recap-connecting-and-learning-in-basel-switzerland/embed/#?secret=g3Lu0xsMqa<script type="text/javascript">n/* <![CDATA[ */n/*! This file is auto-generated */n!function(d,l){"use strict";l.querySelector&&d.addEventListener&&"undefined"!=typeof URL&&(d.wp=d.wp||{},d.wp.receiveEmbedMessage||(d.wp.receiveEmbedMessage=function(e){var t=e.data;if((t||t.secret||t.message||t.value)&&!/[^a-zA-Z0-9]/.test(t.secret)){for(var s,r,n,a=l.querySelectorAll('iframe[data-secret="'+t.secret+'"]'),o=l.querySelectorAll('blockquote[data-secret="'+t.secret+'"]'),c=new RegExp("^https?:$","i"),i=0;i<o.length;i++)o[i].style.display="none";for(i=0;i<a.length;i++)s=a[i],e.source===s.contentWindow&&(s.removeAttribute("style"),"height"===t.message?(1e3<(r=parseInt(t.value,10))?r=1e3:~~r<200&&(r=200),s.height=r):"link"===t.message&&(r=new URL(s.getAttribute("src")),n=new URL(t.value),c.test(n.protocol))&&n.host===r.host&&l.activeElement===s&&(d.top.location.href=t.value))}},d.addEventListener("message",d.wp.receiveEmbedMessage,!1),l.addEventListener("DOMContentLoaded",function(){for(var e,t,s=l.querySelectorAll("iframe.wp-embedded-content"),r=0;r<s.length;r++)(t=(e=s[r]).getAttribute("data-secret"))||(t=Math.random().toString(36).substring(2,12),e.src+="#?secret="+t,e.setAttribute("data-secret",t)),e.contentWindow.postMessage({message:"ready",secret:t},"*")},!1)))}(window,document);n/* ]]> */n</script>n",
  "type": "rich",
  "thumbnail_url": "https://en-blog.files.wordpress.com/2025/06/wceu-2025-recap-header.jpg?fit=440%2C330",
  "thumbnail_width": null,
  "thumbnail_height": null
}

{
  "version": "1.0",
  "provider_name": "WordPress.com News",
  "provider_url": "http://en.blog.wordpress.com",
  "author_name": "Nick Schäferhoff",
  "author_url": "https://en.blog.wordpress.com/author/nschaeferhoff/",
  "title": "WordCamp Europe 2025 Recap: Connecting and Learning in Basel, Switzerland",
  "html": "<blockquote class="wp-embedded-content" data-secret="g3Lu0xsMqa"><a href="https://en.blog.wordpress.com/2025/06/13/wordcamp-europe-2025-recap-connecting-and-learning-in-basel-switzerland/">WordCamp Europe 2025 Recap: Connecting and Learning in Basel, Switzerland</a></blockquote>https://en.blog.wordpress.com/2025/06/13/wordcamp-europe-2025-recap-connecting-and-learning-in-basel-switzerland/embed/#?secret=g3Lu0xsMqa<script type="text/javascript">n/* <![CDATA[ */n/*! This file is auto-generated */n!function(d,l){"use strict";l.querySelector&&d.addEventListener&&"undefined"!=typeof URL&&(d.wp=d.wp||{},d.wp.receiveEmbedMessage||(d.wp.receiveEmbedMessage=function(e){var t=e.data;if((t||t.secret||t.message||t.value)&&!/[^a-zA-Z0-9]/.test(t.secret)){for(var s,r,n,a=l.querySelectorAll('iframe[data-secret="'+t.secret+'"]'),o=l.querySelectorAll('blockquote[data-secret="'+t.secret+'"]'),c=new RegExp("^https?:$","i"),i=0;i<o.length;i++)o[i].style.display="none";for(i=0;i<a.length;i++)s=a[i],e.source===s.contentWindow&&(s.removeAttribute("style"),"height"===t.message?(1e3<(r=parseInt(t.value,10))?r=1e3:~~r<200&&(r=200),s.height=r):"link"===t.message&&(r=new URL(s.getAttribute("src")),n=new URL(t.value),c.test(n.protocol))&&n.host===r.host&&l.activeElement===s&&(d.top.location.href=t.value))}},d.addEventListener("message",d.wp.receiveEmbedMessage,!1),l.addEventListener("DOMContentLoaded",function(){for(var e,t,s=l.querySelectorAll("iframe.wp-embedded-content"),r=0;r<s.length;r++)(t=(e=s[r]).getAttribute("data-secret"))||(t=Math.random().toString(36).substring(2,12),e.src+="#?secret="+t,e.setAttribute("data-secret",t)),e.contentWindow.postMessage({message:"ready",secret:t},"*")},!1)))}(window,document);n/* ]]> */n</script>n",
  "type": "rich",
  "thumbnail_url": "https://en-blog.files.wordpress.com/2025/06/wceu-2025-recap-header.jpg?fit=440%2C330",
  "thumbnail_width": null,
  "thumbnail_height": null
}

as_article-Modus (as_article=true):

https://public-api.wordpress.com/oembed/?for=develop.wordpress.com&url=https://wordpress.com/blog/2025/06/13/wordcamp-europe-2025-recap-connecting-and-learning-in-basel-switzerland/&as_article=true

Antwort:

{
  "version": "1.0",
  "provider_name": "WordPress.com News",
  "provider_url": "http://en.blog.wordpress.com",
  "author_name": "Nick Schäferhoff",
  "author_url": "https://en.blog.wordpress.com/author/nschaeferhoff/",
  "title": "WordCamp Europe 2025 Recap: Connecting and Learning in Basel, Switzerland",
  "type": "article",
  "body": "Couldn't make it to WordCamp Europe 2025? Don't worry. While nothing beats the experience of actually being there, this post will give you a detailed summary of some of the most important and meaningful presentations held at the conference.",
  "related_topics": "News",
  "thumbnail_url": "https://en-blog.files.wordpress.com/2025/06/wceu-2025-recap-header.jpg?fit=440%2C330",
  "thumbnail_width": null,
  "thumbnail_height": null
}

Anforderung einer bestimmten Bildgröße und des XML-Formats

https://public-api.wordpress.com/oembed/?for=develop.wordpress.com&url=https://wordpress.com/blog/2025/06/13/wordcamp-europe-2025-recap-connecting-and-learning-in-basel-switzerland/&as_article=true&img_size=880x660&format=xml

Antwort:

<oembed>
    <version>
        <![CDATA[ 1.0 ]]>
    </version>
    <provider_name>
        <![CDATA[ WordPress.com News ]]>
    </provider_name>
    <provider_url>
        <![CDATA[ https://en.blog.wordpress.com ]]>
    </provider_url>
    <author_name>
        <![CDATA[ Nick Schäferhoff ]]>
    </author_name>
    <author_url>
        <![CDATA[ https://en.blog.wordpress.com/author/nschaeferhoff/ ]]>
    </author_url>
    <title>
        <![CDATA[ WordCamp Europe 2025 Recap: Connecting and Learning in Basel, Switzerland ]]>
    </title>
    <type>
        <![CDATA[ article ]]>
    </type>
    <body>
        <![CDATA[ Couldn't make it to WordCamp Europe 2025? Don't worry. While nothing beats the experience of actually being there, this post will give you a detailed summary of some of the most important and meaningful presentations held at the conference. ]]>
    </body>
    <related_topics>
        <![CDATA[ News ]]>
    </related_topics>
    <thumbnail_url>
        <![CDATA[ https://en-blog.files.wordpress.com/2025/06/wceu-2025-recap-header.jpg?fit=880%2C660 ]]>
    </thumbnail_url>
    <thumbnail_width>
        <![CDATA[ ]]>
    </thumbnail_width>
    <thumbnail_height>
        <![CDATA[ ]]>
    </thumbnail_height>
</oembed>

Header-Tags

WordPress.com fügt außerdem die zugehörigen Link-Tags zu den Website-Headern hinzu – für Beiträge, Seiten und Anhänge (nur bei öffentlichen Websites) –, damit Drittanbieter-Websites die oEmbed-Darstellung Ihrer Inhalte automatisch erkennen können:

<link href="http://public-api.wordpress.com/oembed/?format=json&url=http:%2F%2Ftekartist.org%2F2011%2F07%2F13%2Fyourself-truly-by-emma%2F&for=wpcom-auto-discovery" rel="alternate" type="application/json+oembed" />
<link href="http://public-api.wordpress.com/oembed/?format=xml&url=http:%2F%2Ftekartist.org%2F2011%2F07%2F13%2Fyourself-truly-by-emma%2F&for=wpcom-auto-discovery" rel="alternate" type="application/xml+oembed" />

Zuletzt aktualisiert: Juni 19, 2026