Extremos oEmbed para contenido de Facebook insertable

oEmbed es un formato abierto diseñado para insertar contenido de un sitio web en otra página. La norma oEmbed permite insertar publicaciones y vídeos de Facebook en un sitio web.

URL de extremo

Con nuestro extremo de API puedes solicitar el código insertado de publicaciones y vídeos públicos (todas las respuestas se encuentran en formato json). Reemplaza {content-url} por la URL de la publicación o el vídeo:

Tipo URL de extremo

Publicación

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

Vídeo

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

URL de contenido

Las publicaciones y los vídeos públicos de Facebook pueden usar uno de los esquemas de URL siguientes:

  • Publicaciones:
  • 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}
  • Vídeos:
  • 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}

Nota: Nuestra plataforma evoluciona de forma constante, por lo que es posible que esta lista no esté completa.

Ejemplo

Supongamos que quieres obtener los datos oEmbed para insertar el vídeo de desarrolladores de Facebook How to Share With Just Friends. Para ello, llama a la URL de extremo: https://www.facebook.com/plugins/video/oembed.json/?url=https%3A%2F%2Fwww.facebook.com%2Ffacebook%2Fvideos%2F10153231379946729%2F

Obtendrás una respuesta json similar a la siguiente:

{
  "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 = \"//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%"
}

Parámetros

Todos los parámetros deben enviarse con codificación URL.

Parámetro Descripción

url

La URL de la publicación o el vídeo (obligatoria).

maxwidth

El ancho máximo del recurso insertado (opcional). Ten en cuenta que no se admite el parámetro maxheight. El motivo de ello es que el código de inserción es sensible a los cambios y la altura varía en función de la anchura.

callback

Una devolución de llamada JSON a invocar (opcional).

omitscript

En caso de establecerse como "true", el código de inserción no incluirá la etiqueta de script (opcional).