> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

# oEmbed API

> Devuelve un HTML de inserción sencillo para un timeline de X especificado por la URL del timeline, en un formato JSON compatible con oEmbed. Se admiten timelines de usuario, lista, likes y colección.

Devuelve un HTML de inserción sencillo para un timeline de X especificado por la URL del timeline, en formato JSON compatible con [oEmbed](https://oembed.com/). Se admiten timelines de usuario, lista, likes y colección.

El marcado del timeline está pensado para almacenarse 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

| Característica           | Valor |
| ------------------------ | ----- |
| 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/XDevelopers`<br />`https://x.com/XDevelopers/lists/national-parks` |
| `widget_type`  | Solo timelines de colección. Establece en `grid` para mostrar los Posts en un diseño de cuadrícula                                                                                                                                                                                                                                                                                                                                  | `grid`                                                                            |
| `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 incluir un elemento `<script>` en la respuesta                                                                                                                                                                                                                                                                                                                                                                                   | `1`                                                                               |
| `lang`         | Un [código de idioma admitido por X](/x-for-websites/supported-languages)                                                                                                                                                                                                                                                                                                                                                           | `es`                                                                              |
| `related`      | Sugiere nombres de usuario de X adicionales relacionados con el widget como valores separados por comas. X podría sugerir estas cuentas para seguir después de que el usuario dé like a un Post mostrado. Puedes proporcionar una breve descripción de cómo se relaciona la cuenta con el Post con una coma codificada en URL y texto tras el screen name                                                                           | `x%3AX%20News,xapi%3AX%20API%20News`                                              |
| `theme`        | Cuando se establece en `dark`, el timeline se muestra con texto claro sobre un fondo oscuro                                                                                                                                                                                                                                                                                                                                         | `dark`                                                                            |
| `border_color` | Establece el color de los bordes de los componentes del widget, incluido el borde entre Posts, con un [valor de color hexadecimal](https://en.wikipedia.org/wiki/Web_colors#Hex_triplet)                                                                                                                                                                                                                                            | `%23a80000`                                                                       |
| `chrome`       | Elimina un componente de visualización del timeline con tokens separados por espacios:<br />• `noheader` — oculta la cabecera<br />• `nofooter` — oculta el pie, si es visible<br />• `noborders` — elimina todos los bordes: alrededor del widget, entre Posts y dentro de un Post<br />• `noscrollbar` — recorta y oculta la barra de desplazamiento del timeline, si es visible<br />• `transparent` — elimina el color de fondo | `noheader%20nofooter`                                                             |
| `aria_polite`  | Establece un valor assertive de [ARIA live region politeness](https://www.w3.org/TR/wai-aria/states_and_properties#aria-live) para los Posts 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](https://support.x.com/articles/20169421) ni [anuncios personalizados](https://support.x.com/articles/20170405)                                                                                                                                                                     | `true`                                                                            |

## Solicitudes de ejemplo

```
GET https://publish.x.com/oembed?url=https://x.com/XDevelopers
twurl -H publish.x.com "/oembed?url=https://x.com/XDevelopers"
```

## Respuesta de ejemplo

```json title="Respuesta de ejemplo" lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null}
{
  "url": "https://x.com/XDevelopers",
  "title": "",
  "html": "<a class=\"twitter-timeline\" href=\"https://x.com/XDevelopers\">Posts by XDevelopers</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": "X",
  "provider_url": "https://x.com",
  "version": "1.0"
}
```