Passer au contenu principal
Ce guide vous accompagne pas à pas pour effectuer votre première requête de recherche récente afin de trouver des Publications des 7 derniers jours.
PrérequisAvant de commencer, vous aurez besoin de :
  • D’un compte développeur avec une App approuvée
  • Du Jeton Bearer de votre App (disponible dans la Console de développement sous « Keys and tokens »)

Créer une requête

Les requêtes de recherche utilisent des opérateurs pour cibler des Publications. Commencez par un mot-clé simple :
python
Ou combinez plusieurs opérateurs :
python lang:en -is:retweet
Cette requête renvoie les Publications contenant “python” en anglais, en excluant les retweets.
Consultez la référence complète des opérateurs pour toutes les options disponibles.

Effectuer une requête

cURL
curl "https://api.x.com/2/tweets/search/recent?query=python%20lang%3Aen%20-is%3Aretweet" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Examinez la réponse

La réponse par défaut inclut id, text et edit_history_tweet_ids :
{
  "data": [
    {
      "id": "1234567890123456789",
      "text": "Just started learning Python and loving it!",
      "edit_history_tweet_ids": ["1234567890123456789"]
    },
    {
      "id": "1234567890123456788",
      "text": "Python tip: use list comprehensions for cleaner code",
      "edit_history_tweet_ids": ["1234567890123456788"]
    }
  ],
  "meta": {
    "newest_id": "1234567890123456789",
    "oldest_id": "1234567890123456788",
    "result_count": 2
  }
}

Ajouter des champs et des expansions

Demandez des données supplémentaires à l’aide de paramètres de requête :
cURL
curl "https://api.x.com/2/tweets/search/recent?\
query=python%20lang%3Aen%20-is%3Aretweet&\
tweet.fields=created_at,public_metrics,author_id&\
expansions=author_id&\
user.fields=username,verified&\
max_results=10" \
  -H "Authorization: Bearer $BEARER_TOKEN"
Réponse :
{
  "data": [
    {
      "id": "1234567890123456789",
      "text": "Just started learning Python and loving it!",
      "created_at": "2024-01-15T10:30:00.000Z",
      "author_id": "9876543210",
      "public_metrics": {
        "retweet_count": 5,
        "reply_count": 2,
        "like_count": 42,
        "quote_count": 1
      },
      "edit_history_tweet_ids": ["1234567890123456789"]
    }
  ],
  "includes": {
    "users": [
      {
        "id": "9876543210",
        "username": "pythondev",
        "verified": false
      }
    ]
  },
  "meta": {
    "newest_id": "1234567890123456789",
    "oldest_id": "1234567890123456789",
    "result_count": 1
  }
}

Paginer les résultats

Les SDK gèrent automatiquement la pagination. Pour cURL, utilisez le next_token dans la réponse :
curl "https://api.x.com/2/tweets/search/recent?\
query=python&\
max_results=100&\
next_token=b26v89c19zqg8o3fo7gesq314yb9l2l4ptqy" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Guide de pagination

Découvrez comment parcourir de grands ensembles de résultats

​
Exemples de requêtes

from:XDevelopers

#Python -is:retweet

"machine learning" has:images lang:en

@elonmusk -is:retweet -is:reply

url:github.com lang:en

​
Prochaines étapes

Créer une requête

Maîtrisez la syntaxe des requêtes et les opérateurs

Référence des opérateurs

Consultez tous les opérateurs disponibles

Recherche dans l’archive complète

Recherchez dans l’archive complète des Publications

Référence de l’API

Documentation complète de l’endpoint