Skip to main content

​
Comparaison des endpoints de comptage de Posts de la X API

L’endpoint de comptage de Posts de v2 finira par remplacer l’endpoint de comptage de la Search API Enterprise. Si vous avez du code, des Apps ou des outils utilisant une version plus ancienne d’un endpoint de comptage de Posts et envisagez de migrer vers les endpoints plus récents de la X API v2, alors ce guide est fait pour vous. Cette page contient deux tableaux de comparaison :

​
Comparaison des décomptes de Posts récents

La version Enterprise des endpoints de décompte de Posts vous permet de récupérer des décomptes sur 30 jours ou sur l’intégralité de l’archive. Par conséquent, l’endpoint v2 des décomptes de Posts récents, qui couvre une période de 7 jours, ne remplace pas directement l’un ou l’autre des endpoints susmentionnés. Cependant, pour faciliter les comparaisons, nous allons examiner comment l’endpoint v2 des décomptes de Posts récents se compare à l’endpoint Enterprise sur 30 jours. Le tableau suivant compare les différents types d’endpoints de décomptes de Posts récents :
DescriptionEnterpriseX API v2
Domaine hôtehttps://gnip-api.x.comhttps://api.x.com
Chemin d’endpoint/search/30day/accounts/:account_name/:label/counts.json/2/tweets/counts/recent
AuthenticationBasic authenticationOAuth 2.0 Bearer Token
Format d’horodatageYYYYMMDDhhmmYYYY-MM-DDTHH:mm:ssZ
ISO 8601 / RFC 3339
Renvoie les décomptes de Posts âgés d’au plus31 jours7 jours
Méthodes HTTP prises en chargeGETGET
Limites de taux de requêtes par défaut20 requêtes par 1 s, agrégées entre les données de recherche et les requêtes de décompte
La limite de taux par minute varie selon le partenaire, comme spécifié dans votre contrat.		180 requêtes par 15 min par utilisateur
450 requêtes par 15 min par App
Prend en charge le filtrage à l’aide des annotations✔
Prend en charge le filtrage à l’aide de conversation_id✔
Nom de clé JSON pour le tableau de données de Postresultsdata
Granularité temporelleJour, heure ou minuteJour, heure ou minute
Fuseau horaireUTCUTC
Paramètres de requête pour la sélection de la périodefromDate
toDate		start_time
end_time
Paramètres de requête pour la navigation par ID de Postsince_id
until_id
Nécessite l’utilisation d’identifiants provenant d’une developer App associée à un project✔

​
Comparaison des décomptes de Posts sur l’intégralité des archives

Le tableau suivant compare les différents types d’endpoints de recherche sur l’intégralité des archives :
DescriptionEnterpriseX API v2
Domaine hôtehttps://gnip-api.x.comhttps://api.x.com
Chemin de l’endpoint/search/fullarchive/accounts/:account_name/:label/counts/2/tweets/counts/all
AuthenticationAuthentification BasicOAuth 2.0 Bearer Token
Format d’horodatageYYYYMMDDHHMMYYYY-MM-DDTHH:mm:ssZ
ISO 8601 / RFC 3339
Renvoie des décomptes de Posts datant d’au plusL’intégralité des archives depuis mars 2006L’intégralité des archives depuis mars 2006
Méthodes HTTP prises en chargeGET
POST		GET
Limites de taux par défaut pour les requêtesLa limite de taux par minute varie selon le partenaire, comme indiqué dans votre contrat.
20 requêtes par seconde		300 requêtes par 15 min par App
1 requête par 1 s par App
GranularitéJour, heure, minuteJour, heure, minute
Prend en charge le filtrage à l’aide des annotations✔
Prend en charge le filtrage à l’aide de conversation_id✔
Nom de clé JSON pour le tableau de données de Postresultsdata
Paramètres de requête pour sélectionner la périodefromDate
toDate		start_time
end_time
Paramètres de requête pour naviguer par ID de Postsince_id
until_id
Nom de clé JSON pour la paginationnextmeta.next_token
Paramètre de requête pour la paginationnext_tokennext_token ou pagination_token
Fuseau horaireUTCUTC
Nécessite l’utilisation des identifiants d’une App développeur associée à un Project disposant de l’Academic Research access✔

​
Comparaison des opérateurs de filtrage

Les deux versions (Enterprise et v2) des décomptes de Posts diffèrent par les opérateurs disponibles et présentent également des niveaux de disponibilité variables au sein de chaque version, comme expliqué ci‑dessous. Enterprise
  • Il n’existe pas de sous‑niveaux d’opérateurs Enterprise. Tous les opérateurs Enterprise sont disponibles pour tous les utilisateurs Enterprise.
X API v2
  • De base : Ces opérateurs sont disponibles pour tout utilisateur v2.
  • Avancés : Ces opérateurs sont uniquement disponibles pour les utilisateurs approuvés pour l’accès Academic Research.
Vous pouvez en savoir plus sur chacun de ces ensembles d’opérateurs dans leurs guides respectifs : Maintenant que nous comprenons ces différents niveaux d’opérateurs au sein de X API v2, voici le tableau qui récapitule la disponibilité des opérateurs pour les décomptes de Posts (notez que si la cellule est laissée vide, l’opérateur n’est pas disponible) :
Enterprisev2
keywordDisponibleDe base
emojiDisponibleDe base
“exact phrase”DisponibleDe base
#DisponibleDe base
$DisponibleAvancés
@DisponibleDe base
from:DisponibleDe base
to:DisponibleDe base
url:DisponibleDe base
retweets_of:DisponibleDe base
context:De base
entity:De base - Uniquement disponible avec la recherche récente
conversation_id:De base
place:DisponibleAvancés
place_country:DisponibleAvancés
point_radius:DisponibleAvancés
bounding_box:DisponibleAvancés
is:retweetDisponibleDe base
is:replyDisponibleDe base
is:quoteDisponibleDe base
is:verifiedDisponibleDe base
-is:nullcastDisponibleAvancés
has:hashtagsDisponibleDe base
has:cashtagsDisponibleAvancés
has:linksDisponibleDe base
has:mentionsDisponibleDe base
has:mediaDisponibleDe base
has:imagesDisponibleDe base
has:videosDisponibleDe base
has:geoDisponibleAvancés
lang:DisponibleDe base
list:Avancés
has:profile_geoDisponible
profile_countryDisponible
profile_localityDisponible
profile_regionDisponible
proximityDisponible
Autres ressources de migration Hub de migration X API Découvrez des exemples de code pour ces endpoints Décomptes de Posts : Enterprise vers X API v2
⌘I