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

Recherchez dans l’archive complète des Publications depuis 2006

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érequis

Avant 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

shellscript

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"

---

​

É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

shellscript

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"

---

​

É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