Comparación de los endpoints de búsqueda de Posts de la X API
Comparación de búsqueda reciente
| Descripción | Standard v1.1 | X API v2 |
|---|---|---|
| Dominio del host | https://api.x.com | https://api.x.com |
| Ruta del endpoint | /1.1/search/tweets.json | /2/tweets/search/recent |
| Authentication | Contexto de usuario de OAuth 1.0a OAuth 2.0 App-Only | Contexto de usuario de OAuth 1.0a Código de autorización de OAuth 2.0 con PKCE OAuth 2.0 App-Only |
| Formato de marca de tiempo | YYYYMMDD | YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339 |
| Devuelve Posts de no más de | 7 días | 7 días |
| Métodos HTTP compatibles | GET | GET |
| Límites de tasa de solicitudes predeterminados | 180 solicitudes por 15 min con Contexto de usuario de OAuth 1.0a 450 solicitudes por 15 min con OAuth 2.0 App-Only | Básico: 60 solicitudes por 15 min con OAuth 2.0 App-Only 60 solicitudes por 15 min con Contexto de usuario de OAuth 1.0a 60 solicitudes por 15 min con Código de autorización de OAuth 2.0 con PKCE Pro: 450 solicitudes por 15 min con OAuth 2.0 App-Only 180 solicitudes por 15 min con Contexto de usuario de OAuth 1.0a 180 solicitudes por 15 min con Código de autorización de OAuth 2.0 con PKCE |
| Ofrece URLs completamente desplegadas | ✔ | |
| Máximo de Posts por respuesta (predeterminado) | 100 (15) | 100 (10) |
| Formato JSON de Post | Formato Standard v1.1 | Formato de X API v2 (determinado por los parámetros de solicitud fields y expansions; no es retrocompatible con los formatos de v1.1) Para obtener más información sobre cómo migrar del formato Standard v1.1 al formato de X API v2, visita nuestra guía de migración de formatos de datos. |
| Permite seleccionar qué fields se devuelven en la carga útil | ✔ | |
| Permite solicitar y recibir annotations | ✔ | |
| Permite solicitar metrics específicas dentro del objeto Post | ✔ | |
| Permite el operador y el campo conversation_id | ✔ | |
| Proporciona historial de edición del Post | ✔ | ✔ |
| Nombre de la clave JSON para el arreglo de datos del Post | statuses | data |
| Nombre de la clave JSON para la paginación | search_metadata.next_results | meta.next_token |
| Permite navegar el archivo por rango de tiempo | ✔ | ✔ |
| Resolución temporal de solicitudes basadas en tiempo | día | segundo |
| Zona horaria | UTC | UTC |
| Parámetros de solicitud para navegar por tiempo | until | start_time end_time |
| Parámetros de solicitud para navegar por ID de Post | since_id max_id | since_id until_id |
| Parámetro de solicitud para paginación | Proporciona consulta codificada en URL | next_token |
| Requiere el uso de credenciales de una App de desarrollador asociada a un Project | ✔ |
Comparación de búsqueda en todo el archivo
| Descripción | Empresarial | X API v2 |
|---|---|---|
| Dominio host | https://gnip-api.x.com | https://api.x.com |
| Ruta del endpoint | /search/fullarchive/accounts/:account_name/:label | /2/tweets/search/all |
| Autenticación | Autenticación básica | OAuth 2.0 App-Only |
| Formato de marca de tiempo | YYYYMMDDHHMM | YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339 |
| Devuelve Posts que no sean anteriores a | Todo el archivo desde marzo de 2006 | Todo el archivo desde marzo de 2006 |
| Métodos HTTP admitidos | GET POST | GET |
| Límites de frecuencia de solicitud predeterminados | El límite por minuto variará según el socio tal como se especifique en su contrato. 20 solicitudes por seg con autenticación básica | 300 solicitudes por 15 min con OAuth 2.0 App-Only 1 solicitud por 1 seg con OAuth 2.0 App-Only |
| Ofrece URL completamente desarrolladas | ✔ | ✔ |
| Posts por respuesta | Máximo: 500 Predeterminado: 100 | Máximo: 500 Predeterminado: 10 |
| Formato JSON de Post | Formato Native Enriched or Activity Streams | Formato X API v2 (determinado por los parámetros de solicitud fields y expansions) |
| Admite seleccionar qué fields se devuelven en el payload | ✔ | |
| Admite solicitar y recibir annotations | ✔ | |
| Admite solicitar metrics específicas dentro del objeto Post | ✔ | |
| Admite el operador y el campo conversation_id | ✔ | |
| Proporciona historial de edición de Post | ✔ | ✔ |
| Nombre de la clave JSON para el arreglo de datos de Post | results | data |
| Nombre de la clave JSON para paginación | next | meta.next_token |
| Resolución temporal de solicitudes basadas en tiempo | segundo | segundo |
| Zona horaria | UTC | UTC |
| Admite navegar el archivo por id de Post | ✔ | |
| Parámetros de solicitud para navegación por tiempo | fromDate toDate | start_time end_time |
| Parámetros de solicitud para navegación por id de Post | since_id until_id | |
| Parámetro de solicitud para paginación | next_token | next_token |
| Requiere el uso de credenciales de una App de desarrollador asociada a un Project que tenga acceso de Academic Research | ✔ |
- No hay subniveles de operadores Enterprise
- Gratis: Disponible al usar cualquier Project
- Básico: Disponible al usar cualquier Project
- Pro: Disponible al usar un Project
- Empresarial: Disponible al usar un Project
| Operador de búsqueda | Estándar | Empresarial | v2 |
|---|---|---|---|
| keyword | Disponible q:keyword | Disponible | Básico y Pro |
| emoji | Disponible q:😄 | Disponible | Básico y Pro |
| “exact phrase” | Disponible | Disponible | Básico y Pro |
| # | Disponible | Disponible | Básico y Pro |
| $ | Disponible | Disponible | Pro |
| @ | Disponible | Disponible | Básico y Pro |
| from: | Disponible | Disponible | Básico y Pro |
| to: | Disponible | Disponible | Básico y Pro |
| url: | Disponible | Disponible | Básico y Pro |
| retweets_of: | Disponible | Básico y Pro | |
| context: | Básico y Pro | ||
| entity: | Básico y Pro - solo disponible con búsqueda reciente | ||
| conversation_id: | Básico | ||
| place: | Disponible | Pro | |
| place_country: | Disponible | Pro | |
| point_radius: | parámetro geocode | Disponible | Pro |
| bounding_box: | Disponible | Pro | |
| is:retweet | filter:retweets | Disponible | Básico y Pro |
| is:reply | Disponible | Básico y Pro | |
| is:quote | Disponible | Básico y Pro | |
| is:verified | Disponible | Básico y Pro | |
| -is:nullcast | Disponible | Pro | |
| has:hashtags | Disponible | Básico y Pro | |
| has:cashtags | Disponible | Pro | |
| has:links | filter:links | Disponible | Básico y Pro |
| has:mentions | Disponible | Básico y Pro | |
| has:media | filter:media | Disponible | Básico y Pro |
| has:images | filter:images, filter:twimg | Disponible | Básico y Pro |
| has:videos | filter:videos filter:native_video | Disponible | Básico y Pro |
| has:geo | Disponible | Pro | |
| lang: | lang: se puede usar como operador o como parámetro | Disponible | Básico y Pro |
| has:profile_geo | Disponible | ||
| profile_country | Disponible | ||
| profile_locality | Disponible | ||
| profile_region | Disponible | ||
| proximity | Disponible | ||
| :( | Disponible | ||
| :) | Disponible | ||
| ? | Disponible | ||
| filter:periscope | Disponible | ||
| list: | Disponible | Pro | |
| filter:replies | Disponible | ||
| filter:pro_video | Disponible | ||
| filter:social | Disponible | ||
| filter:trusted | Disponible | ||
| filter:follows | Disponible | ||
| filter:has_engagement | Disponible | ||
| include:antisocial | Disponible | ||
| include:offensive_user | Disponible | ||
| include:antisocial_offensive_user | Disponible | ||
| include:sensitive_content | Disponible | ||
| source: | Disponible | ||
| min_replies: | Disponible | ||
| min_retweets: | Disponible | ||
| min_faves: | Disponible | ||
| card_name: | Disponible | ||
| card_domain: | Disponible |