> ## 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. # Guía de integración > Conceptos clave y buenas prácticas para integrar la búsqueda de Publicaciones Esta guía cubre los conceptos clave que necesitas conocer para integrar los endpoints de búsqueda de Publicaciones en tu aplicación. ***

## Autenticación

### Búsqueda reciente

La búsqueda reciente es compatible con varios métodos de autenticación: | Método | Caso de uso | | :-------------------------------------------------------------------------------------------------------------------------------- | :------------------------------ | | [OAuth 2.0 App-Only](/es/resources/fundamentals/authentication#oauth-2-0) | Datos públicos de publicaciones | | [OAuth 2.0 Authorization Code with PKCE](/es/resources/fundamentals/authentication#oauth-2-0-authorization-code-flow-with-pkce-2) | Métricas privadas | | [OAuth 1.0a User Context](/es/resources/fundamentals/authentication) | Métricas privadas |

### Búsqueda en el archivo completo

La búsqueda en el archivo completo solo admite la autenticación [OAuth 2.0 App-Only](/es/resources/fundamentals/authentication#oauth-2-0). Las métricas privadas (`non_public_metrics`, `organic_metrics`, `promoted_metrics`) no están disponibles con la búsqueda en el archivo completo porque solo admite autenticación App-Only. ***

## Creación de consultas

Las consultas usan operadores para buscar Publicaciones que coincidan. Combina operadores utilizando lógica booleana: ``` (AI OR "machine learning") lang:en -is:retweet has:links ```

### Límites de longitud de las consultas

### Tipos de operadores

## Campos y expansiones

De forma predeterminada, la respuesta solo incluye `id`, `text` y `edit_history_tweet_ids`. Usa los parámetros para solicitar datos adicionales.

### Ejemplo de solicitud

```bash cURL theme={null} curl "https://api.x.com/2/tweets/search/recent?\ query=python&\ tweet.fields=created_at,public_metrics,author_id&\ expansions=author_id,attachments.media_keys&\ user.fields=username,verified&\ media.fields=url,type" \ -H "Authorization: Bearer $BEARER_TOKEN" ``` ```python Python SDK theme={null} from xdk import Client client = Client(bearer_token="YOUR_BEARER_TOKEN") # Buscar publicaciones recientes for page in client.posts.search_recent( query="python", tweet_fields=["created_at", "public_metrics", "author_id"], expansions=["author_id", "attachments.media_keys"], user_fields=["username", "verified"], media_fields=["url", "type"], max_results=100 ): for post in page.data: print(f"{post.text} - Likes: {post.public_metrics.like_count}") ``` ```javascript JavaScript SDK theme={null} import { Client } from "@xdevplatform/xdk"; const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" }); // Buscar publicaciones recientes const paginator = client.posts.searchRecent("python", { tweetFields: ["created_at", "public_metrics", "author_id"], expansions: ["author_id", "attachments.media_keys"], userFields: ["username", "verified"], mediaFields: ["url", "type"], maxResults: 100, }); for await (const page of paginator) { page.data?.forEach((post) => { console.log(`${post.text} - Likes: ${post.public_metrics?.like_count}`); }); } ```

### Expansions disponibles

## Paginación

Los endpoints de búsqueda devuelven resultados en páginas. Usa el `next_token` de la respuesta para recuperar páginas adicionales.

### Cómo funciona

1. Realiza tu solicitud inicial con `max_results` 2. Consulta el objeto `meta` para ver si incluye un `next_token` 3. Incluye `next_token` en las solicitudes posteriores 4. Repite hasta que ya no se devuelva ningún `next_token`

### Ejemplo

```bash cURL theme={null} # Primera solicitud curl "https://api.x.com/2/tweets/search/recent?query=python&max_results=100" \ -H "Authorization: Bearer $BEARER_TOKEN" # Solicitud siguiente con token de paginación curl "https://api.x.com/2/tweets/search/recent?query=python&max_results=100&next_token=NEXT_TOKEN" \ -H "Authorization: Bearer $BEARER_TOKEN" ``` ```python Python SDK theme={null} from xdk import Client client = Client(bearer_token="YOUR_BEARER_TOKEN") # El SDK se encarga de la paginación automáticamente all_posts = [] for page in client.posts.search_recent(query="python", max_results=100): if page.data: all_posts.extend(page.data) print(f"Se encontraron {len(all_posts)} publicaciones") ``` ```javascript JavaScript SDK theme={null} import { Client } from "@xdevplatform/xdk"; const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" }); async function getAllResults(query) { const allPosts = []; // El SDK se encarga de la paginación automáticamente const paginator = client.posts.searchRecent(query, { maxResults: 100 }); for await (const page of paginator) { if (page.data) { allPosts.push(...page.data); } } return allPosts; } // Uso const posts = await getAllResults("python"); console.log(`Se encontraron ${posts.length} publicaciones`); ``` Obtén más información sobre la paginación ***

## Edición de Publicaciones

Las Publicaciones se pueden editar hasta 5 veces en un plazo de 30 minutos. Los endpoints de búsqueda siempre devuelven la versión más reciente.

### Consideraciones

* `edit_history_tweet_ids` contiene todos los id de Publicación (de la más antigua a la más reciente) * Las Publicaciones obtenidas después de la ventana de 30 minutos representan la versión final * En casos de uso casi en tiempo real, las Publicaciones recién publicadas aún pueden editarse Obtén más información sobre cómo editar Publicaciones ***

## Mejores prácticas

Usa varios operadores para acotar los resultados y reducir el ruido. Empieza con un criterio amplio y luego afínalo según los resultados. Implementa una paginación adecuada para grandes conjuntos de resultados. Almacena los resultados localmente para evitar solicitudes repetidas. ***

## Próximos pasos

Domina la sintaxis de las consultas Todos los operadores disponibles Gestiona grandes conjuntos de resultados Documentación completa del endpoint