Vue d’ensemble

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 :

Description	Enterprise	X API v2
Host domain	https://gnip-api.x.com	https://api.x.com
Endpoint path	/search/30day/accounts/:account_name/:label/counts.json	/2/tweets/counts/recent
Authentication	Authentification Basic	OAuth 2.0 Jeton Bearer
Timestamp format	YYYYMMDDhhmm	YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339
Returns counts of Posts that are no older than	31 jours	7 jours
HTTP methods supported	GET	GET
Default request rate limits	20 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 array	results	data
Time granularity	Jour, heure ou minute	Jour, heure ou minute
Timezone	UTC	UTC
Request parameters for selecting time period	fromDate toDate	start_time end_time
Request parameters for navigating by Post ID		since_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 :

Description	Enterprise	X API v2
Domaine d’hébergement	https://gnip-api.x.com	https://api.x.com
Chemin du point de terminaison	/search/fullarchive/accounts/:account_name/:label/counts	/2/tweets/counts/all
Authentification	Authentification de base (Basic auth)	Jeton Bearer OAuth 2.0
Format d’horodatage	YYYYMMDDHHMM	YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339
Renvoie des décomptes de Publications pour des données ne datant pas d’avant	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 de 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 s	300 requêtes par 15 min par App 1 requête par 1 s par App
Granularité	Jour, heure, minute	Jour, 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 Publications	results	data
Paramètres de requête pour la sélection de la période	fromDate toDate	start_time end_time
Paramètres de requête pour la navigation par ID de Publication		since_id until_id
Nom de la clé JSON pour la pagination	next	meta.next_token
Paramètre de requête pour la pagination	next_token	next_token ou pagination_token
Fuseau horaire	UTC	UTC
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 :

• Enterprise operators
• X API v2 operators

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) :

	Enterprise	v2
keyword	Disponible	De base
emoji	Disponible	De base
“exact phrase”	Disponible	De base
#	Disponible	De base
$	Disponible	Avancé
@	Disponible	De base
from:	Disponible	De base
to:	Disponible	De base
url:	Disponible	De base
retweets_of:	Disponible	De base
context:		De base
entity:		De base - Uniquement disponible avec la recherche récente
conversation_id:		De base
place:	Disponible	Avancé
place_country:	Disponible	Avancé
point_radius:	Disponible	Avancé
bounding_box:	Disponible	Avancé
is:retweet	Disponible	De base
is:reply	Disponible	De base
is:quote	Disponible	De base
is:verified	Disponible	De base
-is:nullcast	Disponible	Avancé
has:hashtags	Disponible	De base
has:cashtags	Disponible	Avancé
has:links	Disponible	De base
has:mentions	Disponible	De base
has:media	Disponible	De base
has:images	Disponible	De base
has:videos	Disponible	De base
has:geo	Disponible	Avancé
lang:	Disponible	De base
list:		Avancé
has:profile_geo	Disponible
profile_country	Disponible
profile_locality	Disponible
profile_region	Disponible
proximity	Disponible

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