Démarrage rapide de la recherche récente

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"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Rechercher des publications récentes
for page in client.posts.search_recent(
    query="python lang:en -is:retweet"
):
    for post in page.data:
        print(post.text)

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Rechercher des publications récentes
const paginator = client.posts.searchRecent({
  query: "python lang:en -is:retweet",
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(post.text);
  });
}

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"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Recherche avec des champs et des expansions
for page in client.posts.search_recent(
    query="python lang:en -is:retweet",
    tweet_fields=["created_at", "public_metrics", "author_id"],
    expansions=["author_id"],
    user_fields=["username", "verified"],
    max_results=10
):
    for post in page.data:
        print(f"{post.text[:50]}... - Likes: {post.public_metrics.like_count}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Recherche avec des champs et des expansions
const paginator = client.posts.searchRecent({
  query: "python lang:en -is:retweet",
  tweetFields: ["created_at", "public_metrics", "author_id"],
  expansions: ["author_id"],
  userFields: ["username", "verified"],
  maxResults: 10,
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(`${post.text?.slice(0, 50)}... - Likes: ${post.public_metrics?.like_count}`);
  });
}

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

Publications d’un utilisateur spécifique

from:XDevelopers

Publications avec un hashtag

#Python -is:retweet

Publications contenant des images

"machine learning" has:images lang:en

Publications mentionnant un utilisateur

@elonmusk -is:retweet -is:reply

Publications contenant des liens vers un domaine

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

Vue d’ensemble

Publications

Utilisateurs

Messages privés

Mentions J’aime

Listes

Espaces

Communautés

Notes de la communauté

Tendances

Actualités

Médias

Activité sur X

Utilisation

Connexions de flux

Conformité

Enterprise v2

Flux des J’aime

GNIP 2.0

Démarrage rapide de la recherche récente

Guide de pagination

Exemples de requêtes

Prochaines étapes

Créer une requête

Référence des opérateurs

Recherche dans l’archive complète

Référence de l’API

Guide de pagination

​Exemples de requêtes

​Prochaines étapes

Créer une requête

Référence des opérateurs

Recherche dans l’archive complète

Référence de l’API

Exemples de requêtes

Prochaines étapes