Comparaison des endpoints de recherche de Publications de X API
Comparaison de la recherche récente
| Description | Standard v1.1 | X API v2 |
|---|---|---|
| Domaine hôte | https://api.x.com | https://api.x.com |
| Chemin de l’endpoint | /1.1/search/tweets.json | /2/tweets/search/recent |
| Authentification | Contexte utilisateur OAuth 1.0a OAuth 2.0 App-Only | Contexte utilisateur OAuth 1.0a OAuth 2.0 Authorization Code avec PKCE OAuth 2.0 App-Only |
| Format d’horodatage | YYYYMMDD | YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339 |
| Renvoie des Publications âgées d’au plus | 7 jours | 7 jours |
| Méthodes HTTP prises en charge | GET | GET |
| Limites de taux de requête par défaut | 180 requêtes par 15 min avec contexte utilisateur OAuth 1.0a 450 requêtes par 15 min avec OAuth 2.0 App-Only | Libre-service : 60 requêtes par 15 min avec OAuth 2.0 App-Only 60 requêtes par 15 min avec contexte utilisateur OAuth 1.0a 60 requêtes par 15 min avec OAuth 2.0 Authorization Code avec PKCE |
| Propose des URL entièrement déroulées | ✔ | |
| Nombre maximal de Publications par réponse (valeur par défaut) | 100 (15) | 100 (10) |
| Format JSON de la Publication | Format Standard v1.1 | Format X API v2 (déterminé par les paramètres de requête fields et expansions, non rétrocompatible avec les formats v1.1) Pour en savoir plus sur la migration du format Standard v1.1 vers le format X API v2, consultez notre guide de migration des formats de données. |
| Permet de sélectionner quels champs sont renvoyés dans la charge utile | ✔ | |
| Permet de demander et de recevoir des annotations | ✔ | |
| Permet de demander des métriques spécifiques au sein de l’objet Publication | ✔ | |
| Prend en charge l’opérateur et le champ conversation_id | ✔ | |
| Fournit l’historique d’édition de la Publication | ✔ | ✔ |
| Nom de la clé JSON pour le tableau de données de Publications | statuses | data |
| Nom de la clé JSON pour la pagination | search_metadata.next_results | meta.next_token |
| Permet de parcourir l’archive par plage temporelle | ✔ | ✔ |
| Résolution temporelle des requêtes basées sur le temps | jour | seconde |
| Fuseau horaire | UTC | UTC |
| Paramètres de requête pour la navigation par temps | until | start_time end_time |
| Paramètres de requête pour la navigation par ID de Publication | since_id max_id | since_id until_id |
| Paramètre de requête pour la pagination | Fournit la requête encodée en URL | next_token |
| Nécessite l’utilisation d’informations d’identification provenant d’une App développeur associée à un Project | ✔ |
Comparaison de la recherche dans l’archive complète
| Description | Enterprise | X API v2 |
|---|---|---|
| Domaine d’hébergement | https://gnip-api.x.com | https://api.x.com |
| Chemin du endpoint | /search/fullarchive/accounts/:account_name/:label | /2/tweets/search/all |
| Authentication | Authentification Basic | OAuth 2.0 App-Only |
| Format d’horodatage | YYYYMMDDHHMM | YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339 |
| Renvoie des Publications qui ne sont pas plus anciennes que | L’archive complète depuis mars 2006 | L’archive complète depuis mars 2006 |
| Méthodes HTTP prises en charge | GET POST | GET |
| Limites de taux des requêtes par défaut | La limite de taux par minute varie selon le partenaire, comme spécifié dans votre contrat. 20 requêtes par seconde avec authentification Basic | 300 requêtes par 15 min avec OAuth 2.0 App-Only 1 requête par seconde avec OAuth 2.0 App-Only |
| Propose des URL entièrement déroulées | ✔ | ✔ |
| Publications par réponse | Maximum : 500 Par défaut : 100 | Maximum : 500 Par défaut : 10 |
| Format JSON de la Publication | Format Native Enriched ou Activity Streams | Format X API v2 (déterminé par les paramètres de requête fields et expansions) |
| Permet de sélectionner quels fields sont renvoyés dans le payload | ✔ | |
| Permet de demander et de recevoir des annotations | ✔ | |
| Permet de demander des metrics spécifiques dans l’objet Publication | ✔ | |
| Prend en charge l’opérateur et le champ conversation_id | ✔ | |
| Fournit l’historique des modifications de la Publication | ✔ | ✔ |
| Nom de la clé JSON pour le tableau de données de Publication | results | data |
| Nom de la clé JSON pour la pagination | next | meta.next_token |
| Résolution temporelle des requêtes basées sur le temps | seconde | seconde |
| Fuseau horaire | UTC | UTC |
| Permet de naviguer dans l’archive par ID de Publication | ✔ | |
| Paramètres de requête pour la navigation en fonction du temps | fromDate toDate | start_time end_time |
| Paramètres de requête pour la navigation par ID de Publication | since_id until_id | |
| Paramètre de requête pour la pagination | next_token | next_token |
| Nécessite l’utilisation d’identifiants provenant d’une developer App associée à un Project disposant de l’accès Academic Research | ✔ |
- Il n’existe pas de sous-niveaux d’opérateurs Enterprise
- Self-serve : Disponible avec n’importe quel Project
- Enterprise : Disponible avec un Project
| Opérateur de recherche | Standard | Enterprise | v2 |
|---|---|---|---|
| keyword | Disponible q:keyword | Disponible | Disponible |
| emoji | Disponible q:😄 | Disponible | Disponible |
| ”exact phrase” | Disponible | Disponible | Disponible |
| # | Disponible | Disponible | Disponible |
| $ | Disponible | Disponible | Disponible |
| @ | Disponible | Disponible | Disponible |
| from: | Disponible | Disponible | Disponible |
| to: | Disponible | Disponible | Disponible |
| url: | Disponible | Disponible | Disponible |
| retweets_of: | Disponible | Disponible | |
| context: | Disponible | ||
| entity: | En libre-service – uniquement disponible avec la recherche récente | ||
| conversation_id: | Disponible | ||
| place: | Disponible | Disponible | |
| place_country: | Disponible | Disponible | |
| point_radius: | paramètre geocode | Disponible | Disponible |
| bounding_box: | Disponible | Disponible | |
| is:retweet | filter:retweets | Disponible | Disponible |
| is:reply | Disponible | Disponible | |
| is:quote | Disponible | Disponible | |
| is:verified | Disponible | Disponible | |
| -is:nullcast | Disponible | Disponible | |
| has:hashtags | Disponible | Disponible | |
| has:cashtags | Disponible | Disponible | |
| has:links | filter:links | Disponible | Disponible |
| has:mentions | Disponible | Disponible | |
| has:media | filter:media | Disponible | Disponible |
| has:images | filter:images, filter:twimg | Disponible | Disponible |
| has:videos | filter:videos filter:native_video | Disponible | Disponible |
| has:geo | Disponible | Disponible | |
| lang: | lang - peut être utilisé comme opérateur ou comme paramètre | Disponible | Disponible |
| has:profile_geo | Disponible | ||
| profile_country | Disponible | ||
| profile_locality | Disponible | ||
| profile_region | Disponible | ||
| proximity | Disponible | ||
| :( | Disponible | ||
| :) | Disponible | ||
| ? | Disponible | ||
| filter:periscope | Disponible | ||
| list: | Disponible | Disponible | |
| filter:replies | Disponible | ||
| filter:pro_video | Disponible | ||
| filter:social | Disponible | ||
| filter:trusted | Disponible | ||
| filter:follows | Disponible | ||
| filter:has_engagement | Disponible | ||
| include:antisocial | Disponible | ||
| include:offensive_user | Disponible | ||
| include:antisocial_offensive_user | Disponible | ||
| include:sensitive_content | Disponible | ||
| source: | Disponible | ||
| min_replies: | Disponible | ||
| min_retweets: | Disponible | ||
| min_faves: | Disponible | ||
| card_name: | Disponible | ||
| card_domain: | Disponible |