> ## 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.

# Operadores de búsqueda

> Esta página proporciona una lista completa de operadores disponibles al construir una consulta para Search. Referencia del nivel estándar de X API v2 sobre integración.

Esta página proporciona una lista completa de operadores disponibles al [construir una consulta](/x-api/posts/search/integrate/build-a-query) para los endpoints de Search API.

## Descripción general

Los operadores se utilizan para coincidir con atributos específicos de Post. Hay dos tipos:

* **Operadores independientes** — Pueden usarse solos o junto con cualquier otro operador
* **Operadores que requieren conjunción** — Deben usarse con al menos un operador independiente

***

## Operadores de palabra clave y frase

| Operator         | Type          | Summary                                                                             | Example                             |
| :--------------- | :------------ | :---------------------------------------------------------------------------------- | :---------------------------------- |
| `keyword`        | Independiente | Coincide con una palabra clave dentro del cuerpo del Post (coincidencia tokenizada) | `pepsi OR cola OR "coca cola"`      |
| `emoji`          | Independiente | Coincide con un emoji dentro del cuerpo del Post                                    | `(😃 OR 😡) 😬`                     |
| `"exact phrase"` | Independiente | Coincide con la frase exacta dentro del cuerpo del Post                             | `("X API" OR #v2) -"recent search"` |

***

## Operadores de entidad

| Operator | Type          | Summary                                                           | Example                      |
| :------- | :------------ | :---------------------------------------------------------------- | :--------------------------- |
| `#`      | Independiente | Coincide con Posts que contienen un hashtag (coincidencia exacta) | `#thankunext #fanart`        |
| `@`      | Independiente | Coincide con Posts que mencionan un username                      | `(@XDevelopers OR @API) -@X` |
| `$`      | Independiente | Coincide con Posts que contienen un cashtag                       | `$twtr OR @XDevelopers -$fb` |

***

## Operadores de usuario

| Operator       | Type          | Summary                                                 | Example                        |
| :------------- | :------------ | :------------------------------------------------------ | :----------------------------- |
| `from:`        | Independiente | Coincide con Posts de un usuario específico             | `from:XDevelopers OR from:API` |
| `to:`          | Independiente | Coincide con Posts en respuesta a un usuario específico | `to:XDevelopers OR to:API`     |
| `retweets_of:` | Independiente | Coincide con Retweets de un usuario específico          | `retweets_of:twitterdev`       |

***

## Operadores de URL

| Operator | Type          | Summary                                                                         | Example                               |
| :------- | :------------ | :------------------------------------------------------------------------------ | :------------------------------------ |
| `url:`   | Independiente | Coincidencia tokenizada en URL (coincide con los campos `url` o `expanded_url`) | `url:"https://developer.twitter.com"` |

***

## Operadores de contexto y entidad

| Operator           | Type          | Summary                                                                   | Example                               |
| :----------------- | :------------ | :------------------------------------------------------------------------ | :------------------------------------ |
| `context:`         | Independiente | Coincide con Posts con un par domain/entity específico                    | `context:10.799022225751871488`       |
| `entity:`          | Independiente | Coincide con Posts con un valor de entity específico (solo recent search) | `entity:"Michael Jordan"`             |
| `conversation_id:` | Independiente | Coincide con Posts en un hilo de conversación                             | `conversation_id:1334987486343299072` |

***

## Operador de List

| Operator | Type          | Summary                                               | Example    |
| :------- | :------------ | :---------------------------------------------------- | :--------- |
| `list:`  | Independiente | Coincide con Posts de miembros de una List específica | `list:123` |

***

## Operadores de referencia a Post

| Operator                | Type          | Summary                                         | Example                                    |
| :---------------------- | :------------ | :---------------------------------------------- | :----------------------------------------- |
| `in_reply_to_tweet_id:` | Independiente | Coincide con respuestas a un Post específico    | `in_reply_to_tweet_id:1539382664746020864` |
| `retweets_of_tweet_id:` | Independiente | Coincide con Retweets de un Post específico     | `retweets_of_tweet_id:1539382664746020864` |
| `quotes_of_tweet_id:`   | Independiente | Coincide con Quote Tweets de un Post específico | `quotes_of_tweet_id:1539382664746020864`   |

***

## Operadores de ubicación

| Operator         | Type          | Summary                                            | Example                                                     |
| :--------------- | :------------ | :------------------------------------------------- | :---------------------------------------------------------- |
| `place:`         | Independiente | Coincide con Posts etiquetados con una ubicación   | `place:"new york city" OR place:seattle`                    |
| `place_country:` | Independiente | Coincide con Posts con un código de país           | `place_country:US OR place_country:MX`                      |
| `point_radius:`  | Independiente | Coincide con Posts dentro de un radio de un punto  | `point_radius:[2.355128 48.861118 16km]`                    |
| `bounding_box:`  | Independiente | Coincide con Posts dentro de un cuadro delimitador | `bounding_box:[-105.301758 39.964069 -105.178505 40.09455]` |

***

## Operadores de tipo de Post

| Operator       | Type                | Summary                                         | Example                         |
| :------------- | :------------------ | :---------------------------------------------- | :------------------------------ |
| `is:retweet`   | Requiere conjunción | Coincide con Retweets                           | `data @XDevelopers -is:retweet` |
| `is:reply`     | Requiere conjunción | Coincide con respuestas                         | `from:XDevelopers is:reply`     |
| `is:quote`     | Requiere conjunción | Coincide con Quote Tweets                       | `"sentiment analysis" is:quote` |
| `is:verified`  | Requiere conjunción | Coincide con Posts de autores verificados       | `#nowplaying is:verified`       |
| `-is:nullcast` | Requiere conjunción | Excluye Posts promocionales (debe estar negado) | `"mobile games" -is:nullcast`   |

***

## Operadores de tipo de contenido

| Operator         | Type                | Summary                                          | Example                              |
| :--------------- | :------------------ | :----------------------------------------------- | :----------------------------------- |
| `has:hashtags`   | Requiere conjunción | Coincide con Posts con hashtags                  | `from:XDevelopers -has:hashtags`     |
| `has:cashtags`   | Requiere conjunción | Coincide con Posts con cashtags                  | `#stonks has:cashtags`               |
| `has:links`      | Requiere conjunción | Coincide con Posts con enlaces                   | `from:XDevelopers has:links`         |
| `has:mentions`   | Requiere conjunción | Coincide con Posts con menciones                 | `#nowplaying has:mentions`           |
| `has:media`      | Requiere conjunción | Coincide con Posts con media (photo, GIF, video) | `(kittens OR puppies) has:media`     |
| `has:images`     | Requiere conjunción | Coincide con Posts con imágenes                  | `#meme has:images`                   |
| `has:video_link` | Requiere conjunción | Coincide con Posts con videos nativos de X       | `#icebucketchallenge has:video_link` |
| `has:geo`        | Requiere conjunción | Coincide con Posts con datos de geolocalización  | `recommend #paris has:geo`           |

***

## Operador de idioma

| Operator | Type                | Summary                                                 | Example                    |
| :------- | :------------------ | :------------------------------------------------------ | :------------------------- |
| `lang:`  | Requiere conjunción | Coincide con Posts clasificados en un idioma específico | `recommend #paris lang:en` |

***

## Operadores lógicos

| Operator      | Summary                               | Example                      |
| :------------ | :------------------------------------ | :--------------------------- |
| `OR`          | OR lógico entre expresiones           | `cat OR dog`                 |
| Espacio (AND) | AND lógico entre expresiones          | `cat dog` (ambos requeridos) |
| `()`          | Agrupación para expresiones complejas | `(cat OR dog) -is:retweet`   |
| `-`           | Negación/exclusión                    | `cat -grumpy`                |

***

## Idiomas admitidos

El operador `lang:` admite estos códigos de idioma BCP 47:

| Language  | Code | Language   | Code | Language            | Code    |
| :-------- | :--- | :--------- | :--- | :------------------ | :------ |
| Amharic   | `am` | Greek      | `el` | Portuguese          | `pt`    |
| Arabic    | `ar` | Gujarati   | `gu` | Romanian            | `ro`    |
| Armenian  | `hy` | Hebrew     | `iw` | Russian             | `ru`    |
| Basque    | `eu` | Hindi      | `hi` | Serbian             | `sr`    |
| Bengali   | `bn` | Hungarian  | `hu` | Simplified Chinese  | `zh-CN` |
| Bulgarian | `bg` | Indonesian | `in` | Slovak              | `sk`    |
| Catalan   | `ca` | Italian    | `it` | Slovenian           | `sl`    |
| Croatian  | `hr` | Japanese   | `ja` | Spanish             | `es`    |
| Czech     | `cs` | Kannada    | `kn` | Swedish             | `sv`    |
| Danish    | `da` | Korean     | `ko` | Tamil               | `ta`    |
| Dutch     | `nl` | Latvian    | `lv` | Telugu              | `te`    |
| English   | `en` | Lithuanian | `lt` | Thai                | `th`    |
| Estonian  | `et` | Malayalam  | `ml` | Traditional Chinese | `zh-TW` |
| Finnish   | `fi` | Marathi    | `mr` | Turkish             | `tr`    |
| French    | `fr` | Norwegian  | `no` | Ukrainian           | `uk`    |
| German    | `de` | Persian    | `fa` | Urdu                | `ur`    |
| Georgian  | `ka` | Polish     | `pl` | Vietnamese          | `vi`    |

***

## Limitaciones de consulta

| Access level | Recent search    | Full-archive search |
| :----------- | :--------------- | :------------------ |
| Self-serve   | 512 caracteres   | 1,024 caracteres    |
| Enterprise   | 4,096 caracteres | 4,096 caracteres    |

***

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Construir una consulta" icon="https://mintcdn.com/x-preview/szd6PKNMlRQoyyAo/icons/xds/icon-filter.svg?fit=max&auto=format&n=szd6PKNMlRQoyyAo&q=85&s=5d59aff402c1f2aeae0e9e44bb23400e" href="/x-api/posts/search/integrate/build-a-query" width="24" height="24" data-path="icons/xds/icon-filter.svg">
    Aprende la sintaxis de consulta y mejores prácticas
  </Card>

  <Card title="Introducción a Search" icon="https://mintcdn.com/x-preview/cfyQtgCdwk8p69aa/icons/xds/icon-search.svg?fit=max&auto=format&n=cfyQtgCdwk8p69aa&q=85&s=8c11ad89387b7c09ced1553d5c232834" href="/x-api/posts/search/introduction" width="24" height="24" data-path="icons/xds/icon-search.svg">
    Comienza con Search
  </Card>

  <Card title="Herramienta Query Builder" icon="wrench" href="https://developer.x.com/apitools/query?query=">
    Construye y prueba consultas de forma interactiva
  </Card>
</CardGroup>
