Extremos oEmbed para contenido de Facebook que se puede insertar

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 videos de Facebook en un sitio web.

URL de extremo

Con nuestro extremo de API puedes solicitar el código de inserción de publicaciones y videos públicos (todas las respuestas se encuentran en formato json). Reemplaza {content-url} con la URL de la publicación o el video:

Tipo URL de extremo

Publicación

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

Video

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

URL de contenido

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

  • 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}
  • 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}

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 video de desarrolladores de Facebook How to Share With Just Friends. 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

URL de la publicación o el video (obligatoria)

maxwidth

El ancho máximo del recurso insertado (opcional). Ten en cuenta que no se admite el parámetro maxheight. Esto se debe a que el código de inserción está activo y la altura varía según el ancho.

callback

Invocación de una devolución de llamada de JSON (opcional)

omitscript

Si se configura en "true", el código de inserción no incluye la etiqueta de script (opcional).