oEmbed API

Puedes usar la oEmbed API para devolver contenido incrustado de forma programática, como Tweets y timelines. La respuesta de la oEmbed API devolverá un fragmento HTML que se reconocerá automáticamente cuando se incluya el JavaScript de widgets de X en la página. Ten en cuenta que la API se recomienda para realizar tareas en volumen, y aconsejamos usar nuestra robusta herramienta publish.x.com para incrustar contenido.

Timelines incrustados
Tweets incrustados

El fragmento HTML devuelto se reconocerá automáticamente como un timeline incrustado cuando se incluya el JavaScript de widgets de X en la página.El endpoint oEmbed permite personalizar la apariencia final de un timeline incrustado configurando las propiedades correspondientes en el marcado HTML, que se interpreta por el JavaScript de X incluido por defecto con la respuesta HTML. El formato del marcado devuelto puede cambiar con el tiempo a medida que X añada nuevas funciones o ajuste su representación del timeline.Para un timeline de X especificado por la URL del timeline, en formato JSON compatible con oEmbed. Se admiten timelines de usuario y de lista. El marcado del timeline está pensado para que se almacene en caché en tus servidores durante el tiempo de caché sugerido especificado por la propiedad cache_age.

URL del recurso

https://publish.x.com/oembed

Información del recurso


Formatos de respuesta	JSON
¿Requiere autenticación?	No
Con límite de uso	No

Parámetros

Nombre	Descripción	Ejemplo
url	La URL del timeline de X que se va a incrustar	* https://x.com/TwitterDev *https://x.com/TwitterDev/lists/national-parks
limit	Muestra hasta N elementos, donde N es un valor entre 1 y 20 inclusive	6
maxwidth	Establece el ancho máximo del widget. Debe estar entre 180 y 1200 inclusive	300
maxheight	Establece la altura máxima del widget. Debe ser mayor que 200	400
omit_script	No incluye un elemento script en la respuesta	1
lang	Un código de idioma admitido por X	es
theme	Cuando se establece en dark, el timeline se muestra con texto claro sobre un fondo oscuro	dark
chrome	Elimina un componente de visualización del timeline con tokens separados por espacios * noheader - oculta la cabecera * nofooter - oculta el pie, si es visible * noborders - elimina todos los bordes: alrededor del widget, entre Tweets y dentro de un Tweet * noscrollbar- recorta y oculta la barra de desplazamiento del timeline, si es visible * transparent- elimina el color de fondo	noheader%20nofooter
aria_polite	Establece un valor assertive de ARIA live region politeness para los Tweets añadidos a un timeline	assertive
dnt	Cuando se establece en true, el timeline y su página incrustada en tu sitio no se utilizan con fines que incluyan sugerencias personalizadas ni anuncios personalizados	true

Solicitudes de ejemplo

curl --request GET --url 'https://publish.x.com/oembed?url=https%3A%2F%2Ftwitter.com%2FInterior%2Fstatus%2F507185938620219395'
twurl -H publish.x.com "/oembed?url=https://x.com/Interior/status/463440424141459456"

Respuesta de ejemplo

{
  "url": "https://x.com/TwitterDev",
  "title": "",
  "html": "<a class=\"twitter-timeline\" href=\"https://x.com/TwitterDev\">Tweets by TwitterDev</a>\n<script async src=\"//platform.x.com/widgets.js\" charset=\"utf-8\"></script>",
  "width": null,
  "height": null,
  "type": "rich",
  "cache_age": "3153600000",
  "provider_name": "Twitter",
  "provider_url": "https://x.com",
  "version": "1.0"
}

El fragmento HTML devuelto se reconocerá automáticamente como un Tweet incrustado cuando se incluya el JavaScript de widgets de X en la página.El endpoint oEmbed permite personalizar la apariencia final de un Tweet incrustado configurando las propiedades correspondientes en el marcado HTML, que se interpreta por el JavaScript de X incluido por defecto con la respuesta HTML. El formato del marcado devuelto puede cambiar con el tiempo a medida que X añada nuevas funciones o ajuste su representación del Tweet.El marcado de reserva del Tweet está pensado para que se almacene en caché en tus servidores durante el tiempo de caché sugerido especificado por la propiedad cache_age.

URL del recurso

https://publish.x.com/oembed

Información del recurso


Formatos de respuesta	JSON
¿Requiere autenticación?	No
Con límite de uso	No

Parámetros

Nombre	Predeterminado	Descripción
`url`obligatorio String		La URL del Tweet que se va a incrustar
`maxwidth` Int `[220..550]`	`325`	El ancho máximo de un Tweet renderizado en píxeles enteros. Un valor proporcionado por debajo o por encima del rango permitido se devolverá como el ancho mínimo o máximo admitido respectivamente; el valor de ancho reajustado se reflejará en la propiedad `width` devuelta. Ten en cuenta que X no admite el parámetro oEmbed `maxheight`. Los Tweets son fundamentalmente texto y, por tanto, tienen una altura impredecible que no puede escalarse como una imagen o un vídeo. En relación con esto, la respuesta oEmbed no proporcionará un valor para `height`. Las implementaciones que necesiten alturas consistentes para los Tweets deben consultar los parámetros `hide_thread` y `hide_media` a continuación.
`hide_media` Boolean, String o Int	`false`	Cuando se establece en `true`, `"t"` o `1`, los enlaces en un Tweet no se expanden a vistas previas de foto, vídeo o enlace.
`hide_thread` Boolean, String o Int	`false`	Cuando se establece en `true`, `"t"` o `1`, no se mostrará una versión contraída del Tweet anterior en un hilo de conversación cuando el Tweet solicitado sea una respuesta a otro Tweet.
`omit_script` Boolean, String o Int	`false`	Cuando se establece en `true`, `"t"` o `1`, no se devolverá el `<script>` responsable de cargar `widgets.js`. Tus páginas web deben incluir su propia referencia a `widgets.js` para su uso en todos los widgets de X, incluidos los Tweets incrustados.
`align` Enum `{left,right,center,none}`	`none`	Especifica si el Tweet incrustado debe flotar a la izquierda, derecha o centro en la página respecto al elemento padre.
`lang` Enum(Idioma)	`en`	Solicita el HTML devuelto y un Tweet renderizado en el idioma de X admitido por los Tweets incrustados especificado.
`theme` Enum `{light, dark}`	`light`	Cuando se establece en `dark`, el Tweet se muestra con texto claro sobre un fondo oscuro.
`dnt` Boolean	`false`	Cuando se establece en `true`, el Tweet y su página incrustada en tu sitio no se utilizan con fines que incluyan sugerencias personalizadas ni anuncios personalizados.

Solicitudes de ejemplo

curl --request GET --url 'https://publish.x.com/oembed?url=https%3A%2F%2Ftwitter.com%2Ftwiterdev'
twurl -H publish.x.com "/oembed?url=https://x.com/TwitterDev"

Respuesta de ejemplo

{
  "url": "https:\/\/twitter.com\/Interior\/status\/463440424141459456",
  "author_name": "US Department of the Interior",
  "author_url": "https:\/\/twitter.com\/Interior",
  "html": "<blockquote class=\"twitter-tweet\"><p lang=\"en\" dir=\"ltr\">Sunsets don&#39;t get much better than this one over <a href=\"https:\/\/twitter.com\/GrandTetonNPS?ref_src=twsrc%5Etfw\">@GrandTetonNPS<\/a>. <a href=\"https:\/\/twitter.com\/hashtag\/nature?src=hash&amp;ref_src=twsrc%5Etfw\">#nature<\/a> <a href=\"https:\/\/twitter.com\/hashtag\/sunset?src=hash&amp;ref_src=twsrc%5Etfw\">#sunset<\/a> <a href=\"http:\/\/t.co\/YuKy2rcjyU\">pic.x.com\/YuKy2rcjyU<\/a><\/p>&mdash; US Department of the Interior (@Interior) <a href=\"https:\/\/twitter.com\/Interior\/status\/463440424141459456?ref_src=twsrc%5Etfw\">May 5, 2014<\/a><\/blockquote>\n<script async src=\"https:\/\/platform.x.com\/widgets.js\" charset=\"utf-8\"><\/script>\n",
  "width": 550,
  "height": null,
  "type": "rich",
  "cache_age": "3153600000",
  "provider_name": "Twitter",
  "provider_url": "https:\/\/twitter.com",
  "version": "1.0"
}

Getting Started

Products

Fundamentals

Partners & Customers

Resources

oEmbed API

URL del recurso

Información del recurso

Parámetros

Solicitudes de ejemplo

Respuesta de ejemplo

URL del recurso

Información del recurso

Parámetros

Solicitudes de ejemplo

Respuesta de ejemplo

​URL del recurso

​Información del recurso

​Parámetros

​Solicitudes de ejemplo

​Respuesta de ejemplo

​URL del recurso

​Información del recurso

​Parámetros

​Solicitudes de ejemplo

​Respuesta de ejemplo

URL del recurso

Información del recurso

Parámetros

Solicitudes de ejemplo

Respuesta de ejemplo

URL del recurso

Información del recurso

Parámetros

Solicitudes de ejemplo

Respuesta de ejemplo