Descripción general

Comparación de los endpoints de conteo de Publicaciones de X API

El endpoint v2 de conteo de Publicaciones acabará reemplazando el endpoint de conteo de Enterprise Search API. Si tienes código, aplicaciones o herramientas que usan una versión anterior de un endpoint de conteo de Publicaciones y estás considerando migrar a los nuevos endpoints de X API v2, esta guía es para ti.

---

Comparación de recuentos de Publicaciones recientes

La versión Enterprise de los endpoints de recuento de Publicaciones te permite obtener recuentos ya sea para 30 días o desde el archivo completo. Por lo tanto, el endpoint de recuento de Publicaciones recientes de v2, que analiza un período de 7 días, no sustituye directamente a ninguno de los endpoints mencionados.

Sin embargo, para ayudar con las comparaciones, veremos cómo se compara el endpoint de recuento de Publicaciones recientes de v2 con el endpoint Enterprise de 30 días.

La siguiente tabla compara los distintos tipos de endpoints de recuento de Publicaciones recientes:

Descripción	Enterprise	X API v2
Dominio host	https://gnip-api.x.com	https://api.x.com
Ruta del endpoint	/search/30day/accounts/:account_name/:label/counts.json	/2/tweets/counts/recent
Autenticación	Autenticación básica	OAuth 2.0 Bearer Token
Formato de marca de tiempo	YYYYMMDDhhmm	YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339
Devuelve recuentos de Publicaciones que no sean más antiguas que	31 días	7 días
Métodos HTTP admitidos	GET	GET
Límites de tasa de solicitudes predeterminados	20 solicitudes por 1 s, agregadas entre las solicitudes de datos de búsqueda y de recuento El límite de tasa por minuto variará según el socio, según se especifique en tu contrato.	180 solicitudes por 15 min por usuario 450 solicitudes por 15 min por App
Admite filtrado mediante annotations		✔
Admite filtrado mediante conversation_id		✔
Nombre de la clave JSON para el array de datos de Publicaciones	results	data
Granularidad temporal	Día, hora o minuto	Día, hora o minuto
Zona horaria	UTC	UTC
Parámetros de solicitud para seleccionar el período de tiempo	fromDate toDate	start_time end_time
Parámetros de solicitud para navegar por id de Publicación		since_id until_id
Requiere el uso de credenciales de una developer App asociada con un proyecto		✔

Comparación de recuentos de Publicaciones del archivo completo

La siguiente tabla compara los distintos tipos de endpoints de búsqueda de archivo completo:

Descripción	Enterprise	X API v2
Dominio de host	https://gnip-api.x.com	https://api.x.com
Ruta del endpoint	/search/fullarchive/accounts/:account_name/:label/counts	/2/tweets/counts/all
Autenticación	Autenticación básica	OAuth 2.0 Bearer Token
Formato de marca de tiempo	YYYYMMDDHHMM	YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339
Devuelve recuentos de Publicaciones que no sean anteriores a	El archivo completo desde marzo de 2006	El archivo completo desde marzo de 2006
Métodos HTTP compatibles	GET POST	GET
Límites de tasa de solicitudes predeterminados	El límite de tasa por minuto variará según el socio, según se especifique en tu contrato. 20 solicitudes por segundo	300 solicitudes cada 15 min por App 1 solicitud por segundo por App
Granularidad	Día, hora, minuto	Día, hora, minuto
Permite filtrar mediante annotations		✔
Permite filtrar mediante conversation_id		✔
Nombre de la clave JSON para el array de datos de Publicaciones	results	data
Parámetros de solicitud para seleccionar el período de tiempo	fromDate toDate	start_time end_time
Parámetros de solicitud para navegar por ID de Publicación		since_id until_id
Nombre de la clave JSON para paginación	next	meta.next_token
Parámetro de solicitud para paginación	next_token	next_token o pagination_token
Zona horaria	UTC	UTC
Requiere el uso de credenciales de una App de desarrollador asociada con un Proyecto que tenga acceso Academic Research		✔

Comparación de operadores de filtrado

Las dos versiones diferentes (Enterprise y v2) de conteos de Publicaciones difieren en qué operadores están disponibles y también presentan distintos niveles de disponibilidad de operadores dentro de cada versión, lo cual se explica a continuación.

Enterprise

• No hay subniveles de operadores de Enterprise. Todos los operadores de Enterprise están disponibles para todos los usuarios de Enterprise.

X API v2

• Core: Estos operadores están disponibles para cualquier usuario de v2.
• Advanced: Estos operadores solo están disponibles para usuarios que han sido aprobados para el acceso a Academic Research.

Puedes obtener más información sobre cada uno de estos conjuntos de operadores en sus respectivas guías:

• Operadores de Enterprise
• Operadores de X API v2

Ahora que entendemos estos diferentes niveles de operadores dentro de X API v2, aquí está la tabla que detalla la disponibilidad de operadores para los conteos de Publicaciones (ten en cuenta que si la celda queda en blanco, el operador no está disponible):

	Enterprise	v2
keyword	Disponible	Core
emoji	Disponible	Core
“exact phrase”	Disponible	Core
#	Disponible	Core
$	Disponible	Advanced
@	Disponible	Core
from:	Disponible	Core
to:	Disponible	Core
url:	Disponible	Core
retweets_of:	Disponible	Core
context:		Core
entity:		Core - Solo disponible con búsqueda reciente
conversation_id:		Core
place:	Disponible	Advanced
place_country:	Disponible	Advanced
point_radius:	Disponible	Advanced
bounding_box:	Disponible	Advanced
is:retweet	Disponible	Core
is:reply	Disponible	Core
is:quote	Disponible	Core
is:verified	Disponible	Core
-is:nullcast	Disponible	Advanced
has:hashtags	Disponible	Core
has:cashtags	Disponible	Advanced
has:links	Disponible	Core
has:mentions	Disponible	Core
has:media	Disponible	Core
has:images	Disponible	Core
has:videos	Disponible	Core
has:geo	Disponible	Advanced
lang:	Disponible	Core
list:		Advanced
has:profile_geo	Disponible
profile_country	Disponible
profile_locality	Disponible
profile_region	Disponible
proximity	Disponible

Otros recursos de migración

Centro de migración de X API

Consulta algunos ejemplos de código para estos endpoints

Conteos de Publicaciones: de Enterprise a X API v2