Démarrage rapide de la recherche dans l’archive complète

Ce guide vous explique comment effectuer votre première requête de recherche sur l’archive complète afin de trouver des Publications dans l’archive intégrale de X, qui remonte à mars 2006.

La recherche sur l’archive complète nécessite un accès Self-serve ou Enterprise. Passez à un niveau d’accès supérieur pour utiliser cet endpoint.

PrérequisAvant de commencer, vous aurez besoin de :

D’un compte développeur
Du Jeton Bearer de votre App (disponible dans la Console de développement sous “Keys and tokens”)

Étape 1 : Créer une requête

La recherche dans l’archive complète prend en charge tous les opérateurs de requête. Créez vos requêtes de la même manière que pour la recherche récente :

from:XDevelopers lang:en

La recherche dans l’archive complète prend en charge des requêtes jusqu’à 1 024 caractères (4 096 pour Enterprise).

Étape 2 : Définir une plage temporelle

Par défaut, les résultats renvoient des Publications des 30 derniers jours. Utilisez start_time et end_time pour rechercher des périodes spécifiques :

Paramètre	Format	Exemple
`start_time`	ISO 8601	`2020-01-01T00:00:00Z`
`end_time`	ISO 8601	`2020-12-31T23:59:59Z`

Étape 3 : Effectuer une requête

cURL

curl "https://api.x.com/2/tweets/search/all?\
query=from%3AXDevelopers&\
start_time=2020-01-01T00%3A00%3A00Z&\
end_time=2020-12-31T23%3A59%3A59Z&\
max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Recherche sur l'ensemble des archives avec pagination
for page in client.posts.search_all(
    query="from:XDevelopers",
    start_time="2020-01-01T00:00:00Z",
    end_time="2020-12-31T23:59:59Z",
    max_results=100
):
    for post in page.data:
        print(post.text)

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

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

// Recherche sur l'ensemble des archives avec pagination
const paginator = client.posts.searchAll({
  query: "from:XDevelopers",
  startTime: "2020-01-01T00:00:00Z",
  endTime: "2020-12-31T23:59:59Z",
  maxResults: 100,
});

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

Étape 4 : Examiner la réponse

{
  "data": [
    {
      "id": "1271111223220809728",
      "text": "Tune in tonight and watch as @jessicagarson takes us through...",
      "edit_history_tweet_ids": ["1271111223220809728"]
    },
    {
      "id": "1270799243071062016",
      "text": "As we work towards building the new Twitter API...",
      "edit_history_tweet_ids": ["1270799243071062016"]
    }
  ],
  "meta": {
    "newest_id": "1271111223220809728",
    "oldest_id": "1270799243071062016",
    "result_count": 2
  }
}

Les Publications créées avant l’introduction de la fonctionnalité d’édition (septembre 2022) ne contiendront pas edit_history_tweet_ids.

Étape 5 : Ajoutez 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/all?\
query=from%3AXDevelopers&\
start_time=2020-01-01T00%3A00%3A00Z&\
end_time=2020-12-31T23%3A59%3A59Z&\
tweet.fields=created_at,public_metrics,author_id&\
expansions=author_id&\
user.fields=username,description&\
max_results=100" \
  -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_all(
    query="from:XDevelopers",
    start_time="2020-01-01T00:00:00Z",
    end_time="2020-12-31T23:59:59Z",
    tweet_fields=["created_at", "public_metrics", "author_id"],
    expansions=["author_id"],
    user_fields=["username", "description"],
    max_results=100
):
    for post in page.data:
        print(f"{post.created_at}: {post.text[:50]}...")

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

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

// Recherche avec des champs et des expansions
const paginator = client.posts.searchAll({
  query: "from:XDevelopers",
  startTime: "2020-01-01T00:00:00Z",
  endTime: "2020-12-31T23:59:59Z",
  tweetFields: ["created_at", "public_metrics", "author_id"],
  expansions: ["author_id"],
  userFields: ["username", "description"],
  maxResults: 100,
});

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

Étape 6 : Parcourir les résultats page par page

Les SDK gèrent la pagination automatiquement. Avec cURL, utilisez le next_token renvoyé dans la réponse :

curl "https://api.x.com/2/tweets/search/all?\
query=from%3AXDevelopers&\
max_results=500&\
next_token=b26v89c19zqg8o3fo7gesq314yb9l2l4ptqy" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Guide de pagination

En savoir plus sur la gestion de grands volumes de résultats

Principales différences par rapport à la recherche récente

Fonctionnalité	Recherche récente	Recherche dans l’archive complète
Plage temporelle	7 derniers jours	De mars 2006 à aujourd’hui
Accès requis	Tous les développeurs	Facturation à l’usage, Enterprise
Nombre max de résultats par requête	100	500
Longueur de la requête	512 caractères	1 024 caractères
Limite de débit	450 / 15 min	300 / 15 min, 1 / s
Authentification	App-Only, User Context	App-Only uniquement

Paramètres courants

Paramètre	Description	Valeur par défaut
`query`	Requête de recherche (obligatoire)	—
`max_results`	Publications par page (10-500)	10
`start_time`	Horodatage de la Publication la plus ancienne	Il y a 30 jours
`end_time`	Horodatage de la Publication la plus récente	Maintenant
`next_token`	Jeton de pagination	—
`tweet.fields`	Champs supplémentaires de la Publication	`id`, `text`
`expansions`	Objets liés à inclure	—

Prochaines étapes

Créer une requête

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

Référence des opérateurs

Voir tous les opérateurs disponibles

Guide de pagination

Gérer de gros volumes de résultats

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 dans l’archive complète

Étape 1 : Créer une requête

Étape 2 : Définir une plage temporelle

Étape 3 : Effectuer une requête

Étape 4 : Examiner la réponse

Étape 5 : Ajoutez des champs et des expansions

Étape 6 : Parcourir les résultats page par page

Guide de pagination

Principales différences par rapport à la recherche récente

Paramètres courants

Prochaines étapes

Créer une requête

Référence des opérateurs

Guide de pagination

Référence de l’API