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

# Descripción general

> El endpoint v2 Search Tweets eventualmente reemplazará al endpoint estándar v1.1 search/posts y. Referencia del nivel estándar de X API v2 sobre migración.

## Comparación de los endpoints de Search Posts de la X API

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

***

## Comparación de recent search

La siguiente tabla compara los diversos tipos de endpoints de recent search:

| **Description**                                                                                                                                                | **Standard v1.1**                                                                                                   | **X API v2**                                                                                                                                                                                                                                                                                                                                                               |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Host domain                                                                                                                                                    | [https://api.x.com](https://api.x.com)                                                                              | [https://api.x.com](https://api.x.com)                                                                                                                                                                                                                                                                                                                                     |
| Endpoint path                                                                                                                                                  | /1.1/search/tweets.json                                                                                             | /2/tweets/search/recent                                                                                                                                                                                                                                                                                                                                                    |
| [Autenticación](/resources/fundamentals/authentication)                                                                                                        | OAuth 1.0a User Context  <br />OAuth 2.0 App-Only                                                                   | OAuth 1.0a User Context<br /><br />OAuth 2.0 Authorization Code with PKCE<br /><br />OAuth 2.0 App-Only                                                                                                                                                                                                                                                                    |
| Formato de timestamp                                                                                                                                           | YYYYMMDD                                                                                                            | YYYY-MM-DDTHH:mm:ssZ  <br />[ISO 8601 / RFC 3339](https://tools.ietf.org/html/rfc3339#section-5.6)                                                                                                                                                                                                                                                                         |
| Devuelve Posts no más antiguos de                                                                                                                              | 7 días                                                                                                              | 7 días                                                                                                                                                                                                                                                                                                                                                                     |
| Métodos HTTP admitidos                                                                                                                                         | GET                                                                                                                 | GET                                                                                                                                                                                                                                                                                                                                                                        |
| Límites de tasa de solicitud predeterminados                                                                                                                   | 180 solicitudes por 15 min con OAuth 1.0a User Context<br /><br />450 solicitudes por 15 min con OAuth 2.0 App-Only | **Self-serve:**<br /><br />60 solicitudes por 15 min con OAuth 2.0 App-Only<br /><br />60 solicitudes por 15 min con OAuth 1.0a User Context<br /><br />60 solicitudes por 15 min con OAuth 2.0 Authorization Code with PKCE                                                                                                                                               |
| Ofrece URLs completamente expandidas                                                                                                                           |                                                                                                                     | ✔                                                                                                                                                                                                                                                                                                                                                                          |
| Máximo de Posts por respuesta (predeterminado)                                                                                                                 | 100 (15)                                                                                                            | 100 (10)                                                                                                                                                                                                                                                                                                                                                                   |
| Formato JSON de Post                                                                                                                                           | Formato Standard v1.1                                                                                               | [Formato X API v2](/x-api/fundamentals/data-dictionary) (determinado por los parámetros de solicitud fields y expansions, no es retrocompatible con 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](/x-api/migrate/data-format-migration). |
| Admite la selección de qué [fields](/x-api/fundamentals/fields) se devuelven en el payload                                                                     |                                                                                                                     | ✔                                                                                                                                                                                                                                                                                                                                                                          |
| Admite solicitar y recibir [annotations](/x-api/fundamentals/post-annotations)                                                                                 |                                                                                                                     | ✔                                                                                                                                                                                                                                                                                                                                                                          |
| Admite solicitar [métricas](/x-api/fundamentals/metrics) específicas dentro del objeto Post                                                                    |                                                                                                                     | ✔                                                                                                                                                                                                                                                                                                                                                                          |
| Admite el operador y campo [conversation\_id](/x-api/fundamentals/conversation-id)                                                                             |                                                                                                                     | ✔                                                                                                                                                                                                                                                                                                                                                                          |
| Proporciona historial de edición de Post                                                                                                                       | ✔                                                                                                                   | ✔                                                                                                                                                                                                                                                                                                                                                                          |
| Nombre de la clave JSON para el array de datos de Post                                                                                                         | statuses                                                                                                            | data                                                                                                                                                                                                                                                                                                                                                                       |
| Nombre de la clave JSON para paginación                                                                                                                        | search\_metadata.next\_results                                                                                      | meta.next\_token                                                                                                                                                                                                                                                                                                                                                           |
| Admite navegación del 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 Post                                                                                                            | since\_id   <br />max\_id                                                                                           | since\_id   <br />until\_id                                                                                                                                                                                                                                                                                                                                                |
| Parámetro de solicitud para paginación                                                                                                                         | Proporciona consulta codificada en URL                                                                              | next\_token                                                                                                                                                                                                                                                                                                                                                                |
| Requiere el uso de credenciales de una [developer App](/resources/fundamentals/developer-apps) asociada a un [Project](/resources/fundamentals/developer-apps) |                                                                                                                     | ✔                                                                                                                                                                                                                                                                                                                                                                          |

### Comparación de full-archive search

La siguiente tabla compara los diversos tipos de endpoints de full-archive search:

| **Description**                                                                                                                                                                                   | **Enterprise**                                                                                                                     | **X API v2**                                                                                                              |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------ |
| Host domain                                                                                                                                                                                       | [https://gnip-api.x.com](https://gnip-api.x.com)                                                                                   | [https://api.x.com](https://api.x.com)                                                                                    |
| Endpoint path                                                                                                                                                                                     | /search/fullarchive/accounts/:account\_name/:label                                                                                 | /2/tweets/search/all                                                                                                      |
| [Autenticación](/resources/fundamentals/authentication)                                                                                                                                           | Basic auth                                                                                                                         | OAuth 2.0 App-Only                                                                                                        |
| Formato de timestamp                                                                                                                                                                              | YYYYMMDDHHMM                                                                                                                       | YYYY-MM-DDTHH:mm:ssZ  <br />[ISO 8601 / RFC 3339](https://tools.ietf.org/html/rfc3339#section-5.6)                        |
| Devuelve Posts no más antiguos de                                                                                                                                                                 | El archivo completo desde marzo de 2006                                                                                            | El archivo completo desde marzo de 2006                                                                                   |
| Métodos HTTP admitidos                                                                                                                                                                            | GET  <br />POST                                                                                                                    | GET                                                                                                                       |
| Límites de tasa de solicitud predeterminados                                                                                                                                                      | El límite por minuto variará según el partner como se especifica en tu contrato. <br /><br />20 solicitudes por seg 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 expandidas                                                                                                                                                              | ✔                                                                                                                                  | ✔                                                                                                                         |
| Posts por respuesta                                                                                                                                                                               | Máximo: 500  <br />Predeterminado: 100                                                                                             | Máximo: 500  <br />Predeterminado: 10                                                                                     |
| Formato JSON de Post                                                                                                                                                                              | Formato [Native Enriched o Activity Streams](/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary)                              | Formato [X API v2](/x-api/fundamentals/data-dictionary) (determinado por los parámetros de solicitud fields y expansions) |
| Admite la selección de qué [fields](/x-api/fundamentals/fields) se devuelven en el payload                                                                                                        |                                                                                                                                    | ✔                                                                                                                         |
| Admite solicitar y recibir [annotations](/x-api/fundamentals/post-annotations)                                                                                                                    |                                                                                                                                    | ✔                                                                                                                         |
| Admite solicitar [métricas](/x-api/fundamentals/metrics) específicas dentro del objeto Post                                                                                                       |                                                                                                                                    | ✔                                                                                                                         |
| Admite el operador y campo [conversation\_id](/x-api/fundamentals/conversation-id)                                                                                                                |                                                                                                                                    | ✔                                                                                                                         |
| Proporciona historial de edición de Post                                                                                                                                                          | ✔                                                                                                                                  | ✔                                                                                                                         |
| Nombre de la clave JSON para el array de datos de Post                                                                                                                                            | results                                                                                                                            | data                                                                                                                      |
| Nombre de la clave JSON para paginación                                                                                                                                                           | **next**                                                                                                                           | meta.next\_token                                                                                                          |
| Resolución temporal de las solicitudes basadas en tiempo                                                                                                                                          | segundo                                                                                                                            | segundo                                                                                                                   |
| Zona horaria                                                                                                                                                                                      | UTC                                                                                                                                | UTC                                                                                                                       |
| Admite navegación del archivo por ID de Post                                                                                                                                                      |                                                                                                                                    | ✔                                                                                                                         |
| Parámetros de solicitud para navegación por tiempo                                                                                                                                                | fromDate  <br />toDate                                                                                                             | start\_time  <br />end\_time                                                                                              |
| Parámetros de solicitud para navegar por ID de Post                                                                                                                                               |                                                                                                                                    | since\_id   <br />until\_id                                                                                               |
| Parámetro de solicitud para paginación                                                                                                                                                            | next\_token                                                                                                                        | next\_token                                                                                                               |
| Requiere el uso de credenciales de una [developer App](/resources/fundamentals/developer-apps) asociada a un [Project](/resources/fundamentals/developer-apps) que tenga acceso Academic Research |                                                                                                                                    | ✔                                                                                                                         |

**Comparación de operadores de filtrado**

Las cuatro versiones diferentes (standard, enterprise y v2) de search Posts difieren en qué operadores están disponibles, y también tienen distintos niveles de disponibilidad de operadores dentro de cada versión, que se explican a continuación.

Enterprise

* No hay sub-niveles de operadores enterprise

X API v2

* **Self-serve:** disponible al usar cualquier Project
* **Enterprise:** disponible al usar un Project

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

* [Operadores Enterprise](/x-api/enterprise-gnip-2.0/fundamentals/search-api#available-operators)
* [Operadores de X API v2](/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 mapea la disponibilidad de operadores para search Posts (ten en cuenta que si la celda está en blanco, el operador no está disponible):

| Search operator                     | 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:                             |                                               |            | Self-serve - Solo disponible con recent search |
| 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 - puede usarse como operador o 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 la X API](/x-api/migrate/overview)

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

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

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