API X

Compétence sujette à des changements. Les points de terminaison de l’API X, les niveaux d’accès, les quotas et les autorisations d’écriture changent fréquemment. Vérifiez la documentation actuelle destinée aux développeurs et les droits d’accès à votre compte avant de citer des limites de débit ou de mettre en œuvre un flux de publication/recherche.

Interaction programmatique avec X (Twitter) pour la publication, la lecture, la recherche et l'analyse.

Quand l’activer

• L'utilisateur souhaite publier des tweets ou des fils de discussion par programmation
• Lecture du fil d’actualité, des mentions ou des données utilisateur provenant de X
• Recherche de contenu, de tendances ou de conversations sur X
• Création d’intégrations ou de bots pour X
• Analyses et suivi de l'engagement
• L'utilisateur dit « publier sur X », « tweeter », « API X » ou « API Twitter »

Authentification

Jeton Bearer OAuth 2.0 (application uniquement)

Idéal pour : les opérations à forte intensité de lecture, la recherche, les données publiques.

# Environment setup
export X_BEARER_TOKEN="your-bearer-token"

import os
import requests

bearer = os.environ["X_BEARER_TOKEN"]
headers = {"Authorization": f"Bearer {bearer}"}

# Search recent tweets
resp = requests.get(
    "https://api.x.com/2/tweets/search/recent",
    headers=headers,
    params={"query": "claude code", "max_results": 10}
)
tweets = resp.json()

OAuth 1.0a (contexte utilisateur)

Requis pour : publier des tweets, gérer le compte, les messages privés et tout flux d'écriture.

# Environment setup — source before use
export X_CONSUMER_KEY="your-consumer-key"
export X_CONSUMER_SECRET="your-consumer-secret"
export X_ACCESS_TOKEN="your-access-token"
export X_ACCESS_TOKEN_SECRET="your-access-token-secret"

Les alias hérités tels que X_API_KEY, X_API_SECRET, et X_ACCESS_SECRET peuvent exister dans des configurations plus anciennes. Privilégiez les X_CONSUMER_* et X_ACCESS_TOKEN_SECRET lors de la documentation ou de la mise en place de nouveaux flux.

import os
from requests_oauthlib import OAuth1Session

oauth = OAuth1Session(
    os.environ["X_CONSUMER_KEY"],
    client_secret=os.environ["X_CONSUMER_SECRET"],
    resource_owner_key=os.environ["X_ACCESS_TOKEN"],
    resource_owner_secret=os.environ["X_ACCESS_TOKEN_SECRET"],
)

Opérations de base

Publier un tweet

resp = oauth.post(
    "https://api.x.com/2/tweets",
    json={"text": "Hello from Claude Code"}
)
resp.raise_for_status()
tweet_id = resp.json()["data"]["id"]

Publier un fil de discussion

def post_thread(oauth, tweets: list[str]) -> list[str]:
    ids = []
    reply_to = None
    for text in tweets:
        payload = {"text": text}
        if reply_to:
            payload["reply"] = {"in_reply_to_tweet_id": reply_to}
        resp = oauth.post("https://api.x.com/2/tweets", json=payload)
        tweet_id = resp.json()["data"]["id"]
        ids.append(tweet_id)
        reply_to = tweet_id
    return ids

Lire le fil d’actualité d’un utilisateur

resp = requests.get(
    f"https://api.x.com/2/users/{user_id}/tweets",
    headers=headers,
    params={
        "max_results": 10,
        "tweet.fields": "created_at,public_metrics",
    }
)

Rechercher des tweets

resp = requests.get(
    "https://api.x.com/2/tweets/search/recent",
    headers=headers,
    params={
        "query": "from:affaanmustafa -is:retweet",
        "max_results": 10,
        "tweet.fields": "public_metrics,created_at",
    }
)

Récupérer les messages originaux récents pour la modélisation vocale

resp = requests.get(
    "https://api.x.com/2/tweets/search/recent",
    headers=headers,
    params={
        "query": "from:affaanmustafa -is:retweet -is:reply",
        "max_results": 25,
        "tweet.fields": "created_at,public_metrics",
    }
)
voice_samples = resp.json()

Récupérer un utilisateur par nom d'utilisateur

resp = requests.get(
    "https://api.x.com/2/users/by/username/affaanmustafa",
    headers=headers,
    params={"user.fields": "public_metrics,description,created_at"}
)

Téléverser un média et publier

# Media upload uses v1.1 endpoint

# Step 1: Upload media
media_resp = oauth.post(
    "https://upload.twitter.com/1.1/media/upload.json",
    files={"media": open("image.png", "rb")}
)
media_id = media_resp.json()["media_id_string"]

# Step 2: Post with media
resp = oauth.post(
    "https://api.x.com/2/tweets",
    json={"text": "Check this out", "media": {"media_ids": [media_id]}}
)

Limites de débit

Les limites de débit de l'API X varient selon le point de terminaison, la méthode d'authentification et le niveau de compte, et elles évoluent au fil du temps. Toujours :

• Consultez la documentation actuelle destinée aux développeurs X avant de coder en dur des hypothèses
• Lire x-rate-limit-remaining et les x-rate-limit-reset les en-têtes lors de l'exécution
• Appliquez automatiquement une politique de mise en attente plutôt que de vous fier à des tables statiques dans le code

import time

remaining = int(resp.headers.get("x-rate-limit-remaining", 0))
if remaining < 5:
    reset = int(resp.headers.get("x-rate-limit-reset", 0))
    wait = max(0, reset - int(time.time()))
    print(f"Rate limit approaching. Resets in {wait}s")

Gestion des erreurs

resp = oauth.post("https://api.x.com/2/tweets", json={"text": content})
if resp.status_code == 201:
    return resp.json()["data"]["id"]
elif resp.status_code == 429:
    reset = int(resp.headers["x-rate-limit-reset"])
    raise Exception(f"Rate limited. Resets at {reset}")
elif resp.status_code == 403:
    raise Exception(f"Forbidden: {resp.json().get('detail', 'check permissions')}")
else:
    raise Exception(f"X API error {resp.status_code}: {resp.text}")

Sécurité

• Ne jamais coder en dur les jetons. Utiliser des variables d’environnement ou des .env fichiers.
• Ne jamais valider les fichiers d'.env. Ajouter à .gitignore.
• Remplacez les jetons s'ils ont été exposés. Régénérez-les sur developer.x.com.
• Utilisez des jetons en lecture seule lorsque l'accès en écriture n'est pas nécessaire.
• Stockez les secrets OAuth en toute sécurité — ni dans le code source ni dans les journaux.

Intégration avec Content Engine

Utilisez brand-voice plus content-engine pour générer du contenu natif de la plateforme, puis publiez-le via l’API X :

1. Récupérez les publications originales récentes lorsque la correspondance vocale est importante
2. Créez ou réutilisez un VOICE PROFILE
3. Générer du contenu au content-engine au format natif de X
4. Valider la longueur et la structure du fil de discussion
5. Renvoyer le brouillon pour validation, sauf si l’utilisateur a explicitement demandé de publier immédiatement
6. Publier via l’API X uniquement après validation
7. Suivre l'engagement via public_metrics

Compétences associées

• brand-voice — Créer un profil vocal réutilisable à partir de contenus X réels et de ressources provenant du site ou d’autres sources
• content-engine — Générer du contenu adapté à la plateforme X
• crosspost — Diffuser du contenu sur X, LinkedIn et d’autres plateformes
• connections-optimizer — Réorganiser le graphe X avant de mettre en place une stratégie de communication axée sur le réseau