Skip to main content

Comparación de los endpoints de recuento de Posts de la X API

El endpoint de recuento de Posts de la v2 reemplazará eventualmente el endpoint de recuento de la Enterprise Search API. Si tienes código, Apps o herramientas que usan una versión anterior de un endpoint de recuento de Posts y estás considerando migrar a los endpoints más recientes de la X API v2, esta guía es para ti. Esta página contiene dos tablas de comparación:

Comparación de recuentos de Posts recientes

La versión Empresarial de los endpoints de recuento de Posts te permite obtener recuentos de 30 días o del archivo completo. Por lo tanto, el endpoint de recuento de Posts recientes de v2, que contempla un período de 7 días, no sustituye directamente a ninguno de los endpoints mencionados. Sin embargo, para facilitar las comparaciones, veremos cómo se compara el endpoint de recuento de Posts recientes de v2 con el endpoint Empresarial de 30 días. La siguiente tabla compara los distintos tipos de endpoints de recuento de Posts recientes:
DescripciónEmpresarialX 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ásicaToken Bearer de OAuth 2.0
Formato de marca de tiempoYYYYMMDDhhmmYYYY-MM-DDTHH:mm:ssZ
ISO 8601 / RFC 3339
Devuelve recuentos de Posts no más antiguos que31 días7 días
Métodos HTTP compatiblesGETGET
Límites de tasa de solicitudes predeterminados20 solicitudes por 1 s, agregadas entre solicitudes de datos de búsqueda y de recuentos
El límite por minuto variará según el socio, tal como 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 la matriz de datos de Postresultsdata
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 Postsince_id
until_id
Requiere usar credenciales de una App de desarrollador asociada a un proyecto

Comparación de recuentos de Post del archivo completo

La siguiente tabla compara los distintos tipos de endpoints de búsqueda del archivo completo:
DescripciónEmpresarialX API v2
Dominio del 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ásicaToken de portador OAuth 2.0
Formato de marca de tiempoYYYYMMDDHHMMYYYY-MM-DDTHH:mm:ssZ
ISO 8601 / RFC 3339
Devuelve recuentos de Post no anteriores aEl archivo completo desde marzo de 2006El archivo completo desde marzo de 2006
Métodos HTTP compatiblesGET
POST
GET
Límites de velocidad de solicitud predeterminadosEl límite por minuto variará según el socio, según lo especificado en su contrato.
20 solicitudes por s
300 solicitudes por 15 min por App
1 solicitud por 1 s por App
GranularidadDía, hora, minutoDía, hora, minuto
Admite filtrado con annotations
Admite filtrado con conversation_id
Nombre de la clave JSON para la matriz de datos de Postresultsdata
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 Postsince_id
until_id
Nombre de la clave JSON para la paginaciónnextmeta.next_token
Parámetro de solicitud para la paginaciónnext_tokennext_token o pagination_token
Zona horariaUTCUTC
Requiere el uso de credenciales de una App de desarrollador asociada a un Project que tenga acceso de Investigación Académica

Comparación de operadores de filtrado

Las dos versiones (Empresarial y v2) de los recuentos de Post difieren en los operadores disponibles y también presentan distintos niveles de disponibilidad de operadores dentro de cada versión, como se explica a continuación. Empresarial
  • No hay subniveles de operadores empresariales. Todos los operadores empresariales están disponibles para todos los usuarios empresariales.
X API v2
  • Básico: Estos operadores están disponibles para cualquier usuario de v2.
  • Avanzado: Estos operadores solo están disponibles para usuarios aprobados para el acceso de Investigación académica.
Puede 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 muestra la disponibilidad de operadores para los recuentos de Post (tenga en cuenta que si la celda se deja en blanco, el operador no está disponible):
Enterprisev2
keywordAvailableCore
emojiAvailableCore
“exact phrase”AvailableCore
#AvailableCore
$AvailableAdvanced
@AvailableCore
from:AvailableCore
to:AvailableCore
url:AvailableCore
retweets_of:AvailableCore
context:Core
entity:Core - Only available with recent search
conversation_id:Core
place:AvailableAdvanced
place_country:AvailableAdvanced
point_radius:AvailableAdvanced
bounding_box:AvailableAdvanced
is:retweetAvailableCore
is:replyAvailableCore
is:quoteAvailableCore
is:verifiedAvailableCore
-is:nullcastAvailableAdvanced
has:hashtagsAvailableCore
has:cashtagsAvailableAdvanced
has:linksAvailableCore
has:mentionsAvailableCore
has:mediaAvailableCore
has:imagesAvailableCore
has:videosAvailableCore
has:geoAvailableAdvanced
lang:AvailableCore
list:Advanced
has:profile_geoAvailable
profile_countryAvailable
profile_localityAvailable
profile_regionAvailable
proximityAvailable
Otros recursos de migración Centro de migración de X API Consulta código de ejemplo para estos endpoints Recuentos de Post: de Empresarial a X API v2