Los puntos de conexión documentados en esta página quedaron obsoletos a partir del 24 de octubre de 2020 y devuelven el código de error 400. En su lugar, usa los puntos de conexión oEmbed de Facebook nuevos.

Puntos de conexión oEmbed para contenido de Facebook que se puede insertar (heredado)

oEmbed es un formato abierto diseñado para insertar contenido de un sitio web en otra página. Puedes usar la estándar oEmbed para insertar publicaciones y videos de Facebook en tu sitio web.

URL de punto de conexión

Puedes usar el punto de conexión de nuestra API para solicitar el código de inserción de publicaciones y videos públicos; todas las respuestas están en formato json. Reemplaza {content-url} por la URL de tu publicación o video:

Tipo URL de punto de conexión

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 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}
  • 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: Como nuestra plataforma evoluciona de manera constante, es posible que la lista esté incompleta.

Ejemplo:

Si quieres obtener los datos de oEmbed para insertar el video de Facebook Developers Cómo compartir solo con amigos, llama a la URL del punto de conexión: https://www.facebook.com/plugins/video/oembed.json/?url=https%3A%2F%2Fwww.facebook.com%2Ffacebook%2Fvideos%2F10153231379946729%2F

La respuesta de json debería tener el siguiente 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 URL cifrada.

Parámetro Descripción

url

La URL de la publicación o el video (obligatorio)

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 es ajustable y la altura varía según el ancho.

callback

Una devolución de llamada JSON para invocar (opcional)

omitscript

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

breaking_change

Configúralo como oembed para que el punto de conexión 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.