Los extremos que se señalan en esta página se retiraron el 24 de octubre de 2020 y ahora devuelven el código de error 400. Utiliza los nuevos extremos de oEmbed de Facebook en su lugar.

Extremos de oEmbed para contenido de Facebook que se puede insertar (heredados)

oEmbed es un formato abierto diseñado para permitir la inserción de contenido desde un sitio web en otra página. Puedes utilizar el estándar de oEmbed para insertar publicaciones y vídeos de Facebook en tu sitio web.

URL del extremo

Puedes usar el extremo de nuestra API para solicitar el código de inserción de publicaciones y vídeos públicos; todas las respuestas están en formato json. Sustituye {content-url} por la URL de la publicación o el vídeo:

Tipo URL del 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 utilizar uno de estos 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}
  • 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: Como nuestra plataforma evoluciona constantemente, es posible que esta lista no esté completa.

Ejemplo

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

La respuesta json debería tener este aspecto:

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

Parámetros

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

Parámetro Descripción

url

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

maxwidth

Anchura máxima del recurso insertado (opcional). Ten en cuenta que el parámetro maxheight no se admite. Esto se debe a que el código de inserción tiene capacidad de respuesta y su altura varía según la anchura.

callback

Devolución de llamada JSON que se va a invocar (opcional).

omitscript

Si se establece en verdadero, la inserción no incluye la etiqueta de script (opcional).

breaking_change

Se establece en oembed para que el extremo responda con el código de error 400 y el siguiente mensaje: This endpoint is deprecated, please go to https://developers.facebook.com/docs/plugins/oembed to learn how to migrate your endpoint.