API del proveedor oEmbed

Cada publicación, página, adjunto y vídeo de VideoPress alojado en WordPress.com o a través de Jetpack ahora soporta el formato oEmbed a través de nuestra API pública.

oEmbed es un formato que permite una representación embebida de una URL en sitios de terceros. La API simple permite a un sitio web mostrar contenido embebido (como fotos o vídeos) cuando un usuario publica un enlace a ese recurso, sin tener que analizar el recurso directamente.

Puntos finales:

Última (actualmente v1.0): https://public-api.wordpress.com/oembed/

Las versiones anteriores de esta documentación apuntaban a https://public-api.wordpress.com/oembed/1.0/; esta estructura de URL está obsoleta.

Parámetros de cadena de consulta:

for: [necesario] por favor establece tu dominio o nombre de empresa para que podamos saber quiénes son nuestros amigos.
url: [necesario] cualquier *.wordpress.com, wp.me/*, videopress.com, y [sub]dominios asignados alojados en WordPress.com, como TechCrunch, blogs de CNN y un sinfín de sitios personales.
format: json o xml, por defecto es json.
callback: cuando se usa con json, una función de callback de javascript que quieres que envuelva la salida.
maxwidth y/o maxheight: ancho y/o alto máximo para imágenes/miniaturas, por defecto es 440x330px.
img_size: alternativa a maxwidth/maxheight, como [ancho]x[alto], por defecto es 440x330px.
as_article: true o false, activa la extensión de artículo no estándar para publicaciones/páginas (ver más abajo).

El parámetro as_article activa una salida oEmbed no estándar de tipo artículo. Cuando el contenido se sirve como_article, el contenido se puede encontrar en una propiedad body, en lugar de la propiedad estándar html. Otras propiedades no estándar, como related_topics, también están disponibles. Esta salida se hizo disponible originalmente para uno de nuestros socios, pero está disponible para todos.

Características:

en modo as_article, el contenido se despoja de etiquetas y se limita a un extracto de ~256 caracteres (tipo=artículo, con propiedad body).
en modo estándar (as_article=false), el contenido se sirve como marcado completo, o en extracto si se proporciona y según lo establecido por el autor (tipo=enlace, con propiedad html).
soporta publicaciones y páginas como enlace/html o artículo/cuerpo (ver argumento as_article).
soporta adjuntos (imágenes/media/documentos) como tipo enlace o tipo foto para imágenes (gif, jpg, jpeg, png).
miniatura para publicaciones y páginas si está presente, de la miniatura de la publicación o la primera imagen en el contenido.
imágenes locales y remotas son redimensionadas y/o recortadas a las dimensiones deseadas, para consistencia, luego se almacenan en caché (incluyendo CDN) para velocidad.
soporta datos de geolocalización, cuando son proporcionados por el autor, a través de propiedades personalizadas (geo_latitude, geo_longitude)
soporta related_topics cuando as_article=true.

Ejemplos de respuesta:

Etiquetas de cabecera:

Ahora estamos añadiendo las etiquetas de enlace relacionadas a las cabeceras de los sitios, para publicaciones, páginas y adjuntos (solo para sitios públicos) para que los sitios de terceros puedan descubrir automáticamente la representación oEmbed equivalente de tu contenido:

	&amp;amp;lt;link href=&quot;http://public-api.wordpress.com/oembed/?format=json&amp;amp;amp;url=http%3A%2F%2Ftekartist.org%2F2011%2F07%2F13%2Fyourself-truly-by-emma%2F&amp;amp;amp;for=wpcom-auto-discovery&quot; rel=&quot;alternate&quot; type=&quot;application/json+oembed&quot; /&amp;amp;gt;
	&amp;amp;lt;link href=&quot;http://public-api.wordpress.com/oembed/?format=xml&amp;amp;amp;url=http%3A%2F%2Ftekartist.org%2F2011%2F07%2F13%2Fyourself-truly-by-emma%2F&amp;amp;amp;for=wpcom-auto-discovery&quot; rel=&quot;alternate&quot; type=&quot;application/xml+oembed&quot; /&amp;amp;gt;

Última actualización: mayo 19, 2026