> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Descripción general

<div id="comparing-x-apis-search-posts-endpoints">
  ## Comparación de los endpoints Search Posts de X API
</div>

El endpoint v2 Search Tweets sustituirá eventualmente al endpoint [estándar v1.1 search/posts](/es/x-api/posts/search/introduction) y a la [Enterprise Search API](/es/x-api/enterprise-gnip-2.0/fundamentals/search-api). Si tienes código, aplicaciones o herramientas que utilizan una versión anterior de un endpoint de búsqueda de X y estás considerando migrar a los nuevos endpoints de X API v2, esta guía es para ti.

***

<div id="recent-search-comparison">
  ## Comparación de búsqueda reciente
</div>

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

| **Descripción**                                                                                                                                                              | **Standard v1.1**                                                                                                          | **X API v2**                                                                                                                                                                                                                                                                                                                                                                                            |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Dominio del host                                                                                                                                                             | [https://api.x.com](https://api.x.com)                                                                                     | [https://api.x.com](https://api.x.com)                                                                                                                                                                                                                                                                                                                                                                  |
| Ruta del endpoint                                                                                                                                                            | /1.1/search/tweets.json                                                                                                    | /2/tweets/search/recent                                                                                                                                                                                                                                                                                                                                                                                 |
| [Autenticación](/es/resources/fundamentals/authentication)                                                                                                                   | Contexto de usuario OAuth 1.0a  <br />OAuth 2.0 solo App                                                                   | Contexto de usuario OAuth 1.0a<br /><br />Código de autorización OAuth 2.0 con PKCE<br /><br />OAuth 2.0 solo App                                                                                                                                                                                                                                                                                       |
| Formato de marca de tiempo                                                                                                                                                   | YYYYMMDD                                                                                                                   | YYYY-MM-DDTHH:mm:ssZ  <br />[ISO 8601 / RFC 3339](https://tools.ietf.org/html/rfc3339#section-5.6)                                                                                                                                                                                                                                                                                                      |
| Devuelve Publicaciones con una antigüedad máxima de                                                                                                                          | 7 días                                                                                                                     | 7 días                                                                                                                                                                                                                                                                                                                                                                                                  |
| Métodos HTTP compatibles                                                                                                                                                     | GET                                                                                                                        | GET                                                                                                                                                                                                                                                                                                                                                                                                     |
| Límites de tasa de solicitud predeterminados                                                                                                                                 | 180 solicitudes por 15 min con contexto de usuario OAuth 1.0a<br /><br />450 solicitudes por 15 min con OAuth 2.0 solo App | **Autoservicio:**<br /><br />60 solicitudes por 15 min con OAuth 2.0 solo App<br /><br />60 solicitudes por 15 min con contexto de usuario OAuth 1.0a<br /><br />60 solicitudes por 15 min con código de autorización OAuth 2.0 con PKCE                                                                                                                                                                |
| Ofrece URLs completamente expandidas                                                                                                                                         |                                                                                                                            | ✔                                                                                                                                                                                                                                                                                                                                                                                                       |
| Máximo de Publicaciones por respuesta (predeterminado)                                                                                                                       | 100 (15)                                                                                                                   | 100 (10)                                                                                                                                                                                                                                                                                                                                                                                                |
| Formato JSON de la Publicación                                                                                                                                               | Formato Standard v1.1                                                                                                      | [Formato X API v2](/es/x-api/fundamentals/data-dictionary) (determinado por los parámetros de solicitud fields y expansions; no es compatible con versiones anteriores de los formatos v1.1)<br /><br />Para obtener más información sobre cómo migrar del formato Standard v1.1 al formato X API v2, visita nuestra [guía de migración de formatos de datos](/es/x-api/migrate/data-format-migration). |
| Permite seleccionar qué [campos](/es/x-api/fundamentals/fields) se devuelven en la carga útil                                                                                |                                                                                                                            | ✔                                                                                                                                                                                                                                                                                                                                                                                                       |
| Permite solicitar y recibir [anotaciones](/es/x-api/fundamentals/post-annotations)                                                                                           |                                                                                                                            | ✔                                                                                                                                                                                                                                                                                                                                                                                                       |
| Permite solicitar [métricas](/es/x-api/fundamentals/metrics) específicas dentro del objeto de la Publicación                                                                 |                                                                                                                            | ✔                                                                                                                                                                                                                                                                                                                                                                                                       |
| Permite usar el operador y campo [conversation\_id](/es/x-api/fundamentals/conversation-id)                                                                                  |                                                                                                                            | ✔                                                                                                                                                                                                                                                                                                                                                                                                       |
| Proporciona historial de edición de la Publicación                                                                                                                           | ✔                                                                                                                          | ✔                                                                                                                                                                                                                                                                                                                                                                                                       |
| Nombre de la clave JSON para el arreglo de datos de la Publicación                                                                                                           | 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 las solicitudes basadas en tiempo                                                                                                                     | día                                                                                                                        | segundo                                                                                                                                                                                                                                                                                                                                                                                                 |
| Zona horaria                                                                                                                                                                 | UTC                                                                                                                        | UTC                                                                                                                                                                                                                                                                                                                                                                                                     |
| Parámetros de solicitud para navegar por tiempo                                                                                                                              | until                                                                                                                      | start\_time  <br />end\_time                                                                                                                                                                                                                                                                                                                                                                            |
| Parámetros de solicitud para navegar por id de la Publicación                                                                                                                | since\_id   <br />max\_id                                                                                                  | since\_id   <br />until\_id                                                                                                                                                                                                                                                                                                                                                                             |
| Parámetro de solicitud para la paginación                                                                                                                                    | Proporciona una consulta codificada en URL                                                                                 | next\_token                                                                                                                                                                                                                                                                                                                                                                                             |
| Requiere el uso de credenciales de una [App de desarrollador](/es/resources/fundamentals/developer-apps) asociada a un [Proyecto](/es/resources/fundamentals/developer-apps) |                                                                                                                            | ✔                                                                                                                                                                                                                                                                                                                                                                                                       |

<div id="full-archive-search-comparison">
  ### Comparación de búsqueda en el archivo completo
</div>

La siguiente tabla compara los diversos tipos de endpoints de búsqueda en el archivo completo:

| **Descripción**                                                                                                                                                                                              | **Enterprise**                                                                                                                                    | **X API v2**                                                                                                                 |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------- |
| Dominio de host                                                                                                                                                                                              | [https://gnip-api.x.com](https://gnip-api.x.com)                                                                                                  | [https://api.x.com](https://api.x.com)                                                                                       |
| Ruta del endpoint                                                                                                                                                                                            | /search/fullarchive/accounts/:account\_name/:label                                                                                                | /2/tweets/search/all                                                                                                         |
| [Authentication](/es/resources/fundamentals/authentication)                                                                                                                                                  | Basic auth                                                                                                                                        | OAuth 2.0 App-Only                                                                                                           |
| Formato de marca de tiempo                                                                                                                                                                                   | YYYYMMDDHHMM                                                                                                                                      | YYYY-MM-DDTHH:mm:ssZ  <br />[ISO 8601 / RFC 3339](https://tools.ietf.org/html/rfc3339#section-5.6)                           |
| Devuelve 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  <br />POST                                                                                                                                   | GET                                                                                                                          |
| Límites de tasa de solicitudes predeterminados                                                                                                                                                               | El límite de tasa por minuto variará según el socio, tal como se especifica en su contrato. <br /><br />20 solicitudes por segundo con Basic auth | 300 solicitudes por 15 min con OAuth 2.0 App-Only<br /><br />1 solicitud por 1 seg con OAuth 2.0 App-Only                    |
| Ofrece URLs completamente resueltas                                                                                                                                                                          | ✔                                                                                                                                                 | ✔                                                                                                                            |
| Publicaciones por respuesta                                                                                                                                                                                  | Máximo: 500  <br />Predeterminado: 100                                                                                                            | Máximo: 500  <br />Predeterminado: 10                                                                                        |
| Formato JSON de la Publicación                                                                                                                                                                               | Formato [Native Enriched or Activity Streams](/es/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary)                                         | Formato [X API v2](/es/x-api/fundamentals/data-dictionary) (determinado por los parámetros de solicitud fields y expansions) |
| Permite seleccionar qué [fields](/es/x-api/fundamentals/fields) se devuelven en el payload                                                                                                                   |                                                                                                                                                   | ✔                                                                                                                            |
| Permite solicitar y recibir [annotations](/es/x-api/fundamentals/post-annotations)                                                                                                                           |                                                                                                                                                   | ✔                                                                                                                            |
| Permite solicitar [metrics](/es/x-api/fundamentals/metrics) específicas dentro del objeto Post                                                                                                               |                                                                                                                                                   | ✔                                                                                                                            |
| Permite el operador y campo [conversation\_id](/es/x-api/fundamentals/conversation-id)                                                                                                                       |                                                                                                                                                   | ✔                                                                                                                            |
| Proporciona historial de edición de la Publicación                                                                                                                                                           | ✔                                                                                                                                                 | ✔                                                                                                                            |
| Nombre de la clave JSON para el array de datos de la Publicación                                                                                                                                             | results                                                                                                                                           | data                                                                                                                         |
| Nombre de la clave JSON para la paginación                                                                                                                                                                   | **next**                                                                                                                                          | meta.next\_token                                                                                                             |
| Resolución temporal de las solicitudes basadas en el tiempo                                                                                                                                                  | second                                                                                                                                            | second                                                                                                                       |
| Zona horaria                                                                                                                                                                                                 | UTC                                                                                                                                               | UTC                                                                                                                          |
| Permite navegar por el archivo mediante el ID de la Publicación                                                                                                                                              |                                                                                                                                                   | ✔                                                                                                                            |
| Parámetros de solicitud para la navegación por tiempo                                                                                                                                                        | fromDate  <br />toDate                                                                                                                            | start\_time  <br />end\_time                                                                                                 |
| Parámetros de solicitud para la navegación por ID de la Publicación                                                                                                                                          |                                                                                                                                                   | since\_id   <br />until\_id                                                                                                  |
| Parámetro de solicitud para la paginación                                                                                                                                                                    | next\_token                                                                                                                                       | next\_token                                                                                                                  |
| Requiere el uso de credenciales de una [developer App](/es/resources/fundamentals/developer-apps) asociada con un [Project](/es/resources/fundamentals/developer-apps) que tenga acceso de Academic Research |                                                                                                                                                   | ✔                                                                                                                            |

**Comparación de operadores de filtrado**

Las cuatro versiones diferentes (Standard, Enterprise y v2) de búsqueda de Publicaciones difieren en qué operadores están disponibles y también presentan distintos niveles de disponibilidad de operadores dentro de cada versión, que se explican a continuación.

Enterprise

* No existen subniveles de operadores Enterprise

X API v2

* **Self-serve:** Disponible cuando se utiliza cualquier Project
* **Enterprise:** Disponible cuando se utiliza un Project

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

* [Enterprise operators](/es/x-api/enterprise-gnip-2.0/fundamentals/search-api#available-operators)
* [X API v2 operators](/es/x-api/posts/search/integrate/build-a-query#operators)

Ahora que entendemos los diferentes niveles de operadores dentro de X API v2, aquí está la tabla que muestra la disponibilidad de operadores para la búsqueda de Publicaciones (tenga en cuenta que, si la celda se deja en blanco, el operador no está disponible):

| Operador de búsqueda                | Standard                                           | Enterprise | v2                                                  |
| :---------------------------------- | :------------------------------------------------- | :--------- | :-------------------------------------------------- |
| keyword                             | Disponible  <br />q:keyword                        | Disponible | Disponible                                          |
| emoji                               | Disponible  <br />q:😄                             | Disponible | Disponible                                          |
| "exact phrase"                      | Disponible                                         | Disponible | Disponible                                          |
| #                                   | Disponible                                         | Disponible | Disponible                                          |
| \$                                  | Disponible                                         | Disponible | Disponible                                          |
| @                                   | Disponible                                         | Disponible | Disponible                                          |
| from:                               | Disponible                                         | Disponible | Disponible                                          |
| to:                                 | Disponible                                         | Disponible | Disponible                                          |
| url:                                | Disponible                                         | Disponible | Disponible                                          |
| retweets\_of:                       |                                                    | Disponible | Disponible                                          |
| context:                            |                                                    |            | Disponible                                          |
| entity:                             |                                                    |            | Autoservicio: solo disponible con búsqueda reciente |
| conversation\_id:                   |                                                    |            | Disponible                                          |
| place:                              |                                                    | Disponible | Disponible                                          |
| place\_country:                     |                                                    | Disponible | Disponible                                          |
| point\_radius:                      | parámetro geocode                                  | Disponible | Disponible                                          |
| bounding\_box:                      |                                                    | Disponible | Disponible                                          |
| is:retweet                          | filter:retweets                                    | Disponible | Disponible                                          |
| is:reply                            |                                                    | Disponible | Disponible                                          |
| is:quote                            |                                                    | Disponible | Disponible                                          |
| is:verified                         |                                                    | Disponible | Disponible                                          |
| -is:nullcast                        |                                                    | Disponible | Disponible                                          |
| has:hashtags                        |                                                    | Disponible | Disponible                                          |
| has:cashtags                        |                                                    | Disponible | Disponible                                          |
| has:links                           | filter:links                                       | Disponible | Disponible                                          |
| has:mentions                        |                                                    | Disponible | Disponible                                          |
| has:media                           | filter:media                                       | Disponible | Disponible                                          |
| has:images                          | filter:images, filter:twimg                        | Disponible | Disponible                                          |
| has:videos                          | filter:videos  <br />filter:native\_video          | Disponible | Disponible                                          |
| has:geo                             |                                                    | Disponible | Disponible                                          |
| lang:                               | lang: se puede usar como operador o como parámetro | Disponible | Disponible                                          |
| has:profile\_geo                    |                                                    | Disponible |                                                     |
| profile\_country                    |                                                    | Disponible |                                                     |
| profile\_locality                   |                                                    | Disponible |                                                     |
| profile\_region                     |                                                    | Disponible |                                                     |
| proximity                           |                                                    | Disponible |                                                     |
| :(                                  | Disponible                                         |            |                                                     |
| :)                                  | Disponible                                         |            |                                                     |
| ?                                   | Disponible                                         |            |                                                     |
| filter:periscope                    | Disponible                                         |            |                                                     |
| list:                               | Disponible                                         |            | Disponible                                          |
| 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                                         |            |                                                     |

**Otros recursos de migración**

[Centro de migración de X API](/es/x-api/migrate/overview)

[Consulta algunos ejemplos de código para estos endpoints](https://github.com/xdevplatform/Twitter-API-v2-sample-code "Consulta algunos ejemplos de código para estos endpoints")

[Buscar Publicaciones: Standard v1.1 a X API v2](/es/x-api/posts/search/migrate/standard-to-twitter-api-v2)

[Buscar Publicaciones: Enterprise a X API v2](/es/x-api/posts/search/migrate/enterprise-to-twitter-api-v2)
