Skip to main content

​
Comparaison des endpoints de comptage des Publications de X API

L’endpoint v2 de comptage des Publications finira par remplacer l’endpoint de comptage de l’Enterprise Search API. Si vous avez du code, des applications ou des outils qui utilisent une version plus ancienne d’un endpoint de comptage des Publications et que vous envisagez de migrer vers les nouveaux endpoints de X API v2, ce guide vous est destiné.

​
Comparaison des décomptes récents de Publications

La version Enterprise des endpoints de décompte de Publications vous permet de récupérer des décomptes soit sur 30 jours, soit sur l’intégralité des archives. Par conséquent, l’endpoint v2 de décompte récent de Publications, qui couvre une période de 7 jours, ne remplace directement aucun de ces endpoints. Cependant, pour faciliter les comparaisons, nous allons examiner comment l’endpoint v2 de décompte récent de Publications se compare à l’endpoint Enterprise sur 30 jours. Le tableau suivant compare les différents types d’endpoints récents de décompte de Publications :
DescriptionEnterpriseX API v2
Host domainhttps://gnip-api.x.comhttps://api.x.com
Endpoint path/search/30day/accounts/:account_name/:label/counts.json/2/tweets/counts/recent
AuthenticationAuthentification BasicOAuth 2.0 Jeton Bearer
Timestamp formatYYYYMMDDhhmmYYYY-MM-DDTHH:mm:ssZ
ISO 8601 / RFC 3339
Returns counts of Posts that are no older than31 jours7 jours
HTTP methods supportedGETGET
Default request rate limits20 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 et par utilisateur
450 requêtes par 15 min et par App
Supports filtering using annotations✔
Supports filtering using conversation_id✔
JSON key name for Post data arrayresultsdata
Time granularityJour, heure ou minuteJour, heure ou minute
TimezoneUTCUTC
Request parameters for selecting time periodfromDate
toDate		start_time
end_time
Request parameters for navigating by Post IDsince_id
until_id
Requires the use of credentials from a developer App associated with a project✔

​
Comparaison des décomptes de Publications sur l’archive complète

Le tableau suivant compare les différents types de points de terminaison de recherche sur l’archive complète :
DescriptionEnterpriseX API v2
Domaine d’hébergementhttps://gnip-api.x.comhttps://api.x.com
Chemin du point de terminaison/search/fullarchive/accounts/:account_name/:label/counts/2/tweets/counts/all
AuthentificationAuthentification de base (Basic auth)Jeton Bearer OAuth 2.0
Format d’horodatageYYYYMMDDHHMMYYYY-MM-DDTHH:mm:ssZ
ISO 8601 / RFC 3339
Renvoie des décomptes de Publications pour des données ne datant pas d’avantL’archive complète depuis mars 2006L’archive complète depuis mars 2006
Méthodes HTTP prises en chargeGET
POST		GET
Limites de taux de requêtes par défautLa limite de taux par minute varie selon le partenaire, comme spécifié dans votre contrat.
20 requêtes par s		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 la clé JSON pour le tableau de données de Publicationsresultsdata
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 Publicationsince_id
until_id
Nom de la 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 d’identifiants provenant d’une App développeur associée à un Projet qui dispose de l’Academic Research access✔

​
Comparaison des opérateurs de filtrage

Les deux versions (Enterprise et v2) des décomptes de Publications diffèrent quant aux opérateurs disponibles et présentent également des niveaux variables de disponibilité des opérateurs dans chaque version, comme expliqué ci‑dessous. Enterprise
  • Il n’y a 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 de la v2.
  • Avancé : Ces opérateurs sont uniquement disponibles pour les utilisateurs qui ont été approuvés pour l’accès Academic Research.
Vous pouvez en apprendre davantage 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 un tableau qui récapitule la disponibilité des opérateurs pour les décomptes de Publications (notez que si une cellule est laissée vide, l’opérateur n’est pas disponible) :
Enterprisev2
keywordDisponibleDe base
emojiDisponibleDe base
“exact phrase”DisponibleDe base
#DisponibleDe base
$DisponibleAvancé
@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é
place_country:DisponibleAvancé
point_radius:DisponibleAvancé
bounding_box:DisponibleAvancé
is:retweetDisponibleDe base
is:replyDisponibleDe base
is:quoteDisponibleDe base
is:verifiedDisponibleDe base
-is:nullcastDisponibleAvancé
has:hashtagsDisponibleDe base
has:cashtagsDisponibleAvancé
has:linksDisponibleDe base
has:mentionsDisponibleDe base
has:mediaDisponibleDe base
has:imagesDisponibleDe base
has:videosDisponibleDe base
has:geoDisponibleAvancé
lang:DisponibleDe base
list:Avancé
has:profile_geoDisponible
profile_countryDisponible
profile_localityDisponible
profile_regionDisponible
proximityDisponible
Autres ressources de migration X API migration hub Check out some sample code for these endpoints Décomptes de Publications : d’Enterprise à X API v2