Die auf dieser Seite dokumentierten Endpunkte wurden am 24. Oktober 2020 eingestellt. Es wird der Fehlercode 400 ausgegeben. Verwende stattdessen bitte die neuen oEmbed-Endpunkte von Facebook.

oEmbed-Endpunkte für einbettbare Facebook-Inhalte (veraltet)

oEmbed ist ein offenes Format, mit dem Inhalte von einer Webseite in einer anderen Seite eingebettet werden können. Du kannst den oEmbed-Standard zum Einbetten von Facebook-Beiträgen und -Videos in deine Website verwenden.

Endpunkt-URLs

Du kannst unseren API-Endpunkt verwenden, um den Einbettungscode für öffentliche Beiträge und Videos anzufordern. Alle Antworten weisen das json-Format auf. Ersetze {content-url} durch die URL deines Beitrags oder Videos:

Typ Endpunkt-URL

Beitrag

https://www.facebook.com/plugins/post/oembed.json/?url={content-url}

Video

https://www.facebook.com/plugins/video/oembed.json/?url={content-url}

Inhalts-URL

Für öffentliche Facebook-Beiträge und -Videos kann eines dieser URL-Schemata verwendet werden:

  • Beiträge:
  • https://www.facebook.com/{page-name}/posts/{post-id}
  • https://www.facebook.com/{username}/posts/{post-id}
  • https://www.facebook.com/{username}/activity/{activity-id}
  • https://www.facebook.com/photo.php?fbid={photo-id}
  • https://www.facebook.com/photos/{photo-id}
  • https://www.facebook.com/permalink.php?story_fbid={post-id}
  • https://www.facebook.com/media/set?set={set-id}
  • https://www.facebook.com/questions/{question-id}
  • https://www.facebook.com/notes/{username}/{note-url}/{note-id}
  • Videos:
  • https://www.facebook.com/{page-name}/videos/{video-id}/
  • https://www.facebook.com/{username}/videos/{video-id}/
  • https://www.facebook.com/video.php?id={video-id}
  • https://www.facebook.com/video.php?v={video-id}

Hinweis: Da unsere Plattform kontinuierlich weiterentwickelt wird, ist diese Liste möglicherweise nicht vollständig.

Beispiel

Angenommen, du möchtest die oEmbed-Daten zum Einbetten des Facebook for Developers-Videos How to Share With Just Friends abrufen. Endpunkt-URL aufrufen: https://www.facebook.com/plugins/video/oembed.json/?url=https%3A%2F%2Fwww.facebook.com%2Ffacebook%2Fvideos%2F10153231379946729%2F

Die json-Antwort sollte folgendermaßen aussehen:

{
  "author_name": "Facebook",
  "author_url": "https://www.facebook.com/facebook/",
  "provider_url": "https://www.facebook.com",
  "provider_name": "Facebook",
  "success": true,
  "height": null,
  "html": "<div id=\"fb-root\"></div>\n<script>(function(d, s, id) {\n  var js, fjs = d.getElementsByTagName(s)[0];\n  if (d.getElementById(id)) return;\n  js = d.createElement(s); js.id = id;\n  js.src = \"https://connect.facebook.net/en_US/sdk.js#xfbml=1&amp;version=v2.9\";\n  fjs.parentNode.insertBefore(js, fjs);\n}(document, 'script', 'facebook-jssdk'));</script><div class=\"fb-video\" data-href=\"https://www.facebook.com/facebook/videos/10153231379946729/\"><div class=\"fb-xfbml-parse-ignore\"><blockquote cite=\"https://www.facebook.com/facebook/videos/10153231379946729/\"><a href=\"https://www.facebook.com/facebook/videos/10153231379946729/\">How to Share With Just Friends</a><p>How to share with just friends.</p>Posted by <a href=\"https://www.facebook.com/facebook/\">Facebook</a> on Friday, December 5, 2014</blockquote></div></div>",
  "type": "video",
  "version": "1.0",
  "url": "https://www.facebook.com/facebook/videos/10153231379946729/",
  "width": "100%"
}

Parameter

Alle Parameter müssen URL-codiert gesendet werden.

Parameter Beschreibung

url

Die URL des Beitrags oder Videos (erforderlich)

maxwidth

Die maximale Breite der eingebetteten Ressource (optional). Beachte, dass der Parameter maxheight nicht unterstützt wird. Dies liegt daran, dass der Einbettungscode responsiv ist und die Höhe je nach Breite variiert.

callback

Ein JSON-Rückruf, der aufgerufen werden soll (optional)

omitscript

Ist hier „true“ festgelegt, umfasst der Einbettungscode den script-Tag nicht (optional)

breaking_change

Wähle oembed aus, damit der Endpunkt mit dem Fehlercode 400 und der Meldung This endpoint is deprecated, please go to https://developers.facebook.com/docs/plugins/oembed to learn how to migrate your endpoint. reagiert.