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

# API oEmbed

> L’API oEmbed renvoie un HTML d’intégration simple dans un format compatible [oEmbed](http://oembed.com/).

Vous pouvez utiliser l’API oEmbed pour renvoyer de manière programmatique du contenu intégré, comme des [Tweets](https://developer.x.com/en/docs/twitter-for-websites/embedded-tweets/overview) et des [chronologies](https://developer.x.com/en/docs/twitter-for-websites/timelines/overview). 

La réponse de l’API oEmbed contiendra un extrait de code HTML qui sera automatiquement reconnu lorsque [le JavaScript des widgets X est inclus dans la page](https://developer.x.com/web/javascript/loading).

Veuillez noter que l’API est recommandée pour effectuer des opérations en masse, et nous vous conseillons d’utiliser notre outil robuste [publish.x.com](https://publish.x.com/#) pour intégrer du contenu.

<Tabs>
  <Tab title="Timelines intégrées">
    L'extrait HTML renvoyé sera automatiquement reconnu comme une [timeline intégrée](https://developer.x.com/en/docs/twitter-for-websites/timelines/overview) lorsque [le JavaScript de widget de X est inclus dans la page](https://developer.x.com/web/javascript/loading).

    Le endpoint oEmbed permet de personnaliser l'apparence finale d'une timeline intégrée en définissant les propriétés correspondantes dans le balisage HTML, qui seront interprétées par le JavaScript de X fourni par défaut avec la réponse HTML. Le format du balisage renvoyé peut évoluer au fil du temps, à mesure que X ajoute de nouvelles fonctionnalités ou ajuste la représentation de la timeline.

    Pour une timeline X spécifiée par l’URL de la timeline, dans un format JSON compatible [oEmbed](https://oembed.com/). Les timelines utilisateur et de Liste sont prises en charge. Le balisage de la timeline est destiné à être mis en cache sur vos serveurs pendant au plus la durée de mise en cache recommandée, indiquée par la propriété cache\_age.

    ## URL de la ressource

    *[https://publish.x.com/oembed](https://publish.x.com/oembed)*

    ## Informations sur la ressource

    |                                  |      |
    | :------------------------------- | :--- |
    | Formats de réponse               | JSON |
    | Nécessite une authentification ? | Non  |
    | Soumis à une limitation de débit | Non  |

    ## Paramètres

    | Nom          | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Exemple                                                                                                                                                          |
    | :----------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **url**      | L'URL de la timeline X à intégrer                                                                                                                                                                                                                                                                                                                                                                                                                                                         | \*   [https://x.com/TwitterDev](https://x.com/TwitterDev)<br /> \*[https://x.com/TwitterDev/lists/national-parks](https://x.com/TwitterDev/lists/national-parks) |
    | limit        | Affiche jusqu'à N éléments, où N est une valeur comprise entre 1 et 20 inclus                                                                                                                                                                                                                                                                                                                                                                                                             | 6                                                                                                                                                                |
    | maxwidth     | Définit la largeur maximale du widget. Doit être comprise entre 180 et 1200 inclus                                                                                                                                                                                                                                                                                                                                                                                                        | 300                                                                                                                                                              |
    | maxheight    | Définit la hauteur maximale du widget. Doit être supérieure à 200                                                                                                                                                                                                                                                                                                                                                                                                                         | 400                                                                                                                                                              |
    | omit\_script | N'inclut pas d'élément script dans la réponse                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1                                                                                                                                                                |
    | lang         | Un code de langue X pris en charge ([language code](/fr/en/docs/twitter-for-websites/twitter-for-websites-supported-languages/overview "Twitter language code"))                                                                                                                                                                                                                                                                                                                          | es                                                                                                                                                               |
    | theme        | Lorsqu'il est défini sur dark, la timeline est affichée avec un texte clair sur un arrière-plan sombre                                                                                                                                                                                                                                                                                                                                                                                    | dark                                                                                                                                                             |
    | chrome       | Supprime des composants d'affichage de la timeline à l'aide de jetons séparés par des espaces<br /><br />\*   noheader - masque l'en-tête<br />\*   nofooter - masque le pied de page, s'il est visible<br />\*   noborders - supprime toutes les bordures : autour du widget, entre les Tweets et à l'intérieur d'un Tweet<br />\*   noscrollbar - rogne et masque la barre de défilement de la timeline, si elle est visible<br />\*   transparent - supprime la couleur d'arrière-plan | noheader%20nofooter                                                                                                                                              |
    | aria\_polite | Définit, pour les Tweets ajoutés à une timeline, une valeur [ARIA live region politeness](https://www.w3.org/TR/wai-aria/states_and_properties#aria-live) assertive                                                                                                                                                                                                                                                                                                                       | assertive                                                                                                                                                        |
    | dnt          | Lorsqu'il est défini sur true, la timeline et sa page intégrée sur votre site ne sont pas utilisées à des fins incluant les [suggestions personnalisées](https://support.x.com/articles/20169421) et les [publicités personnalisées](https://support.x.com/articles/20170405)                                                                                                                                                                                                             | true                                                                                                                                                             |

    ## Exemples de requêtes

    ```bash theme={null}
    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"
    ```

    ## Exemple de réponse

    ```json theme={null}

    {
      "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"
    }
    ```
  </Tab>

  <Tab title="Tweets intégrés">
    L'extrait HTML renvoyé sera automatiquement reconnu comme un [Tweet intégré](https://developer.x.com/web/embedded-tweets) lorsque [le JavaScript du widget de X est inclus sur la page](https://developer.x.com/web/javascript/loading).

    Le point de terminaison oEmbed permet de personnaliser l'apparence finale d'un Tweet intégré en définissant les propriétés correspondantes dans le balisage HTML à interpréter par le JavaScript de X, fourni par défaut avec la réponse HTML. Le format du balisage renvoyé peut évoluer au fil du temps à mesure que X ajoute de nouvelles fonctionnalités ou ajuste sa représentation des Tweets.

    Le balisage de secours du Tweet doit être mis en cache sur vos serveurs pour une durée maximale correspondant à la durée de vie du cache suggérée, spécifiée par la propriété `cache_age`.

    ## URL de ressource

    *[https://publish.x.com/oembed](https://publish.x.com/oembed)*

    ## Informations sur la ressource

    |                                    |      |
    | :--------------------------------- | :--- |
    | Formats de réponse                 | JSON |
    | Authentification requise ?         | Non  |
    | Soumis à une limitation de débit ? | Non  |

    ## Paramètres

    | Nom                                                                                                                                    | Valeur par défaut | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
    | :------------------------------------------------------------------------------------------------------------------------------------- | :---------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | `url`requis  <br />String                                                                                                              |                   | URL du Tweet à intégrer                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
    | `maxwidth`  <br />Int `[220..550]`                                                                                                     | `325`             | La largeur maximale, en pixels entiers, d’un Tweet rendu. Une valeur fournie en dessous ou au-dessus de la plage autorisée sera renvoyée comme largeur minimale ou maximale prise en charge, respectivement ; la valeur de largeur ajustée sera reflétée dans la propriété `width` renvoyée. Notez que X ne prend pas en charge le paramètre oEmbed `maxheight`. Les Tweets sont fondamentalement du texte et ont donc une hauteur imprévisible qui ne peut pas être mise à l’échelle comme une image ou une vidéo. Par conséquent, la réponse oEmbed ne fournira pas de valeur pour `height`. Les implémentations qui nécessitent des hauteurs constantes pour les Tweets doivent se référer aux paramètres `hide_thread` et `hide_media` ci‑dessous. |
    | `hide_media`  <br />Boolean, String ou Int                                                                                             | `false`           | Lorsque la valeur est `true`, `"t"` ou `1`, les liens dans un Tweet ne sont pas affichés sous forme d’aperçus de photos, de vidéos ou de liens.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
    | `hide_thread`  <br />Boolean, String ou Int                                                                                            | `false`           | Lorsqu’il est défini sur `true`, `"t"` ou `1`, la version réduite du Tweet précédent dans un fil de conversation n’est pas affichée lorsque le Tweet demandé est une réponse à un autre Tweet.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
    | `omit_script`  <br />booléen, chaîne ou entier                                                                                         | `false`           | Lorsque ce paramètre est défini sur `true`, `"t"` ou `1`, le `<script>` responsable du chargement de `widgets.js` ne sera pas renvoyé. Vos pages Web doivent inclure leur propre référence à `widgets.js` pour pouvoir l’utiliser avec l’ensemble des widgets X, y compris les [Tweets intégrés](https://developer.x.com/web/embedded-tweets).                                                                                                                                                                                                                                                                                                                                                                                                         |
    | `align`  <br />Enum `{left,right,center,none}`                                                                                         | `none`            | Indique si le Tweet intégré doit être aligné à gauche, à droite ou centré par rapport à son élément parent.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
    | `lang`  <br />Enum([Language](https://developer.x.com/en/docs/twitter-for-websites/twitter-for-websites-supported-languages/overview)) | `en`              | Renvoie du HTML et un Tweet rendu dans la [langue X prise en charge pour les Tweets intégrés](https://developer.x.com/web/overview/languages) spécifiée.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
    | `theme`  <br />Enum `{light, dark}`                                                                                                    | `light`           | Lorsque ce paramètre est défini sur `dark`, le Tweet est affiché avec un texte clair sur un arrière-plan sombre.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
    | `dnt`  <br />booléen                                                                                                                   | `false`           | Lorsqu’il est défini sur `true`, le Tweet et sa page intégrée sur votre site ne sont pas utilisés à des fins telles que les [suggestions personnalisées](https://support.x.com/articles/20169421) et les [publicités personnalisées](https://support.x.com/articles/20170405).                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

    ## Exemples de requêtes

    ```bash theme={null}
    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"
    ```

    ## Exemple de réponse

    ```json theme={null}
    {
      "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"
    }
    ```
  </Tab>
</Tabs>