> ## 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.
# Búsqueda de usuarios
> Busca usuarios de X por palabra clave con el endpoint User search de X API v2 para encontrar cuentas por nombre, handle, términos de bio y otros fields y metadatos públicos del perfil.
export const Button = ({href, children}) => {
return ;
};
El endpoint User Search te permite buscar usuarios por palabra clave. Encuentra usuarios por nombre, username o contenido de su bio.
## Resumen
Busca por nombre, username o bio
Encuentra cuentas relevantes
***
## Endpoint
| Método | Endpoint | Descripción |
| :----- | :--------------------------------------------- | :------------- |
| GET | [`/2/users/search`](/x-api/users/search-users) | Busca usuarios |
***
## Solicitud de ejemplo
```bash theme={null}
curl "https://api.x.com/2/users/search?\
query=python%20developer&\
user.fields=description,verified,public_metrics" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
## Respuesta de ejemplo
```json title="Example response" lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null}
{
"data": [
{
"id": "1234567890",
"name": "Python Developer",
"username": "pythondev",
"description": "Building cool things with Python",
"verified": false,
"public_metrics": {
"followers_count": 5000,
"following_count": 200,
"tweet_count": 1500
}
}
],
"meta": {
"result_count": 1
}
}
```
***
## Primeros pasos
**Requisitos previos**
* Una [cuenta de desarrollador](https://developer.x.com/en/portal/petition/essential/basic-info) aprobada
* Un [Project y App](/resources/fundamentals/developer-apps) en la Developer Console
* Las [claves y tokens](/resources/fundamentals/authentication) de tu App
Consulta usuarios por ID o username
Documentación completa del endpoint