> ## 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.

# X API

> Accès programmatique aux Publications, aux utilisateurs, aux Espaces de X et plus encore

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

X API vous donne un accès programmatique à la conversation publique d'X. Lisez des publications, publiez du contenu, gérez des utilisateurs et analysez les tendances — le tout via des endpoints REST modernes avec une tarification flexible à l'usage.

<CardGroup cols={3}>
  <Card title="Premiers pas" icon="rocket" href="/fr/x-api/getting-started/make-your-first-request">
    Créez une App et effectuez votre première requête en quelques minutes.
  </Card>

  <Card title="Référence de l’API" icon="code" href="/fr/x-api/posts/create-post">
    Explorez tous les endpoints disponibles.
  </Card>

  <Card title="SDKs" icon="cube" href="/fr/xdks/overview">
    Bibliothèques officielles Python et TypeScript.
  </Card>
</CardGroup>

***

<div id="what-you-can-build">
  ## Ce que vous pouvez développer
</div>

<CardGroup cols={3}>
  <Card title="Publications" icon="message" href="/fr/x-api/posts/lookup/introduction">
    Recherchez, récupérez et publiez des publications. Accédez aux fils, aux fils de discussion et aux publications citées.
  </Card>

  <Card title="Utilisateurs" icon="user" href="/fr/x-api/users/lookup/introduction">
    Recherchez des utilisateurs, gérez les abonnements, les blocages et les mises en sourdine.
  </Card>

  <Card title="Spaces" icon="microphone" href="/fr/x-api/spaces/lookup/introduction">
    Trouvez des conversations audio en direct et leurs participants.
  </Card>

  <Card title="Messages privés" icon="envelope" href="/fr/x-api/direct-messages/lookup/introduction">
    Envoyez et recevez des messages privés.
  </Card>

  <Card title="Listes" icon="list" href="/fr/x-api/lists/list-lookup/introduction">
    Créez et gérez des listes de comptes sélectionnées.
  </Card>

  <Card title="Tendances" icon="arrow-trend-up" href="/fr/x-api/trends/trends-by-woeid/introduction">
    Accédez aux sujets tendances en fonction de la localisation.
  </Card>
</CardGroup>

***

<div id="pricing">
  ## Tarification
</div>

La X API utilise une tarification **à l’usage**. Pas d’abonnements, pas de plafonds mensuels : payez uniquement ce que vous utilisez.

<CardGroup cols={2}>
  <Card title="Mise à l’échelle flexible" icon="chart-line">
    Commencez modestement et grandissez. Les coûts évoluent en fonction de votre utilisation réelle.
  </Card>

  <Card title="Aucun engagement" icon="unlock">
    Aucun contrat ni dépense minimale. Arrêtez quand vous le souhaitez.
  </Card>

  <Card title="Suivi en temps réel" icon="gauge-high">
    Surveillez l’utilisation et les coûts en direct dans la Console de développement.
  </Card>

  <Card title="Basée sur des crédits" icon="coins">
    Achetez des crédits à l’avance. Ils sont débités à mesure que vous utilisez l’API.
  </Card>
</CardGroup>

<div className="mt-6 flex gap-4">
  <Button href="/fr/x-api/getting-started/pricing">Détails de la tarification</Button>
  <Button href="https://console.x.com">Acheter des crédits</Button>
</div>

***

<div id="key-features">
  ## Fonctionnalités clés
</div>

<Tabs>
  <Tab title="Accès aux données">
    ### Objets de données riches

    Accédez à des données détaillées et structurées pour les publications, les utilisateurs, les médias et plus encore :

    * **Publications** : texte complet, métriques, entités, annotations, fils de conversation
    * **Utilisateurs** : profils, nombre d’abonnés, statut de vérification du compte
    * **Médias** : images, vidéos, GIFs avec métadonnées
    * **Sondages** : options et nombre de votes

    Personnalisez les réponses avec les [fields](/fr/x-api/fundamentals/fields) et les [expansions](/fr/x-api/fundamentals/expansions) pour obtenir exactement les données dont vous avez besoin.
  </Tab>

  <Tab title="Diffusion en temps réel">
    ### Flux filtré

    Recevez les publications en temps réel, au moment où elles sont publiées. Définissez jusqu’à 1 000 règles de filtrage pour ne recevoir que les publications correspondantes.

    ```bash theme={null}
    # Ajouter une règle
    curl -X POST "https://api.x.com/2/tweets/search/stream/rules" \
      -H "Authorization: Bearer $TOKEN" \
      -d '{"add": [{"value": "from:xdevelopers"}]}'

    # Se connecter au flux
    curl "https://api.x.com/2/tweets/search/stream" \
      -H "Authorization: Bearer $TOKEN"
    ```

    [En savoir plus sur le flux filtré →](/fr/x-api/posts/filtered-stream/introduction)
  </Tab>

  <Tab title="Recherche et analyses">
    ### Recherche sur l’ensemble des archives

    Recherchez dans l’intégralité de l’historique des publications publiques — depuis 2006. Créez des requêtes avec des opérateurs pour les utilisateurs, mots-clés, dates, et plus encore.

    ```bash theme={null}
    curl "https://api.x.com/2/tweets/search/all?query=AI%20lang:en" \
      -H "Authorization: Bearer $TOKEN"
    ```

    ### Métriques

    Accédez aux métriques d’engagement, notamment les impressions, mentions « J’aime », republications, réponses et vues vidéo.

    [En savoir plus sur la recherche →](/fr/x-api/posts/search/introduction)
  </Tab>
</Tabs>

***

<div id="api-versions">
  ## Versions de l'API
</div>

| Version        | Statut     | Description                                                                       |
| :------------- | :--------- | :-------------------------------------------------------------------------------- |
| **v2**         | Active     | Endpoints modernes, tarification flexible et toutes les nouvelles fonctionnalités |
| **Enterprise** | Disponible | Accès à haut volume avec assistance dédiée                                        |

<Tip>
  Utilisez **X API v2** pour tous les nouveaux projets. C'est là que sont publiées toutes les nouvelles fonctionnalités et améliorations.
</Tip>

***

<div id="quick-start">
  ## Démarrage rapide
</div>

<Steps>
  <Step title="Créer un compte développeur">
    Inscrivez-vous sur [console.x.com](https://console.x.com) et créez une App.
  </Step>

  <Step title="Obtenir vos identifiants">
    Générez votre Jeton Bearer pour les requêtes en mode app-only.
  </Step>

  <Step title="Envoyer une requête">
    Essayez de rechercher un utilisateur :

    ```bash theme={null}
    curl "https://api.x.com/2/users/by/username/xdevelopers" \
      -H "Authorization: Bearer $BEARER_TOKEN"
    ```
  </Step>
</Steps>

<Button href="/fr/x-api/getting-started/make-your-first-request">Guide complet de démarrage rapide</Button>

***

<div id="tools-libraries">
  ## Outils et bibliothèques
</div>

<CardGroup cols={3}>
  <Card title="SDK Python" icon="python" href="/fr/xdks/python/overview">
    Bibliothèque Python officielle avec prise en charge asynchrone.
  </Card>

  <Card title="SDK TypeScript" icon="js" href="/fr/xdks/typescript/overview">
    Bibliothèque TypeScript/JavaScript officielle.
  </Card>

  <Card title="Postman" icon="server" href="https://app.getpostman.com/run-collection/9956214-784efcda-ed4c-4491-a4c0-a26470a67400">
    Explorateur d’API interactif.
  </Card>
</CardGroup>

[Parcourir toutes les bibliothèques →](/fr/x-api/tools-and-libraries/overview)

***

<div id="support">
  ## Assistance
</div>

<CardGroup cols={2}>
  <Card title="Forum des développeurs" icon="comments" href="https://devcommunity.x.com">
    Obtenez de l'aide auprès de la communauté et de l'équipe X.
  </Card>

  <Card title="Centre d'assistance" icon="circle-question" href="https://developer.x.com/en/support/twitter-api.html">
    FAQ et guides de dépannage.
  </Card>
</CardGroup>