Skip to main content

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ónEnterpriseX API v2
Dominio hosthttps://gnip-api.x.comhttps://api.x.com
Ruta del endpoint/search/30day/accounts/:account_name/:label/counts.json/2/tweets/counts/recent
AutenticaciónAutenticación básicaOAuth 2.0 Bearer Token
Formato de marca de tiempoYYYYMMDDhhmmYYYY-MM-DDTHH:mm:ssZ
ISO 8601 / RFC 3339
Devuelve recuentos de Publicaciones que no sean más antiguas que31 días7 días
Métodos HTTP admitidosGETGET
Límites de tasa de solicitudes predeterminados20 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 Publicacionesresultsdata
Granularidad temporalDía, hora o minutoDía, hora o minuto
Zona horariaUTCUTC
Parámetros de solicitud para seleccionar el período de tiempofromDate
toDate
start_time
end_time
Parámetros de solicitud para navegar por id de Publicaciónsince_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ónEnterpriseX API v2
Dominio de hosthttps://gnip-api.x.comhttps://api.x.com
Ruta del endpoint/search/fullarchive/accounts/:account_name/:label/counts/2/tweets/counts/all
AutenticaciónAutenticación básicaOAuth 2.0 Bearer Token
Formato de marca de tiempoYYYYMMDDHHMMYYYY-MM-DDTHH:mm:ssZ
ISO 8601 / RFC 3339
Devuelve recuentos de Publicaciones que no sean anteriores aEl archivo completo desde marzo de 2006El archivo completo desde marzo de 2006
Métodos HTTP compatiblesGET
POST
GET
Límites de tasa de solicitudes predeterminadosEl 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
GranularidadDía, hora, minutoDía, hora, minuto
Permite filtrar mediante annotations
Permite filtrar mediante conversation_id
Nombre de la clave JSON para el array de datos de Publicacionesresultsdata
Parámetros de solicitud para seleccionar el período de tiempofromDate
toDate
start_time
end_time
Parámetros de solicitud para navegar por ID de Publicaciónsince_id
until_id
Nombre de la clave JSON para paginaciónnextmeta.next_token
Parámetro de solicitud para paginaciónnext_tokennext_token o pagination_token
Zona horariaUTCUTC
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: 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):
Enterprisev2
keywordDisponibleCore
emojiDisponibleCore
“exact phrase”DisponibleCore
#DisponibleCore
$DisponibleAdvanced
@DisponibleCore
from:DisponibleCore
to:DisponibleCore
url:DisponibleCore
retweets_of:DisponibleCore
context:Core
entity:Core - Solo disponible con búsqueda reciente
conversation_id:Core
place:DisponibleAdvanced
place_country:DisponibleAdvanced
point_radius:DisponibleAdvanced
bounding_box:DisponibleAdvanced
is:retweetDisponibleCore
is:replyDisponibleCore
is:quoteDisponibleCore
is:verifiedDisponibleCore
-is:nullcastDisponibleAdvanced
has:hashtagsDisponibleCore
has:cashtagsDisponibleAdvanced
has:linksDisponibleCore
has:mentionsDisponibleCore
has:mediaDisponibleCore
has:imagesDisponibleCore
has:videosDisponibleCore
has:geoDisponibleAdvanced
lang:DisponibleCore
list:Advanced
has:profile_geoDisponible
profile_countryDisponible
profile_localityDisponible
profile_regionDisponible
proximityDisponible
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