> ## 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.
# Busca de usuários
> Busque usuários do X por palavra-chave com o endpoint de busca de usuários da X API v2 para encontrar contas por nome, handle, termos da bio e outros fields de perfil e metadados públicos.
export const Button = ({href, children}) => {
return ;
};
O endpoint de Busca de Usuários permite pesquisar usuários por palavra-chave. Encontre usuários por nome, username ou pelo conteúdo da bio.
## Visão geral
Busque por nome, username ou bio
Encontre contas relevantes
***
## Endpoint
| Método | Endpoint | Descrição |
| :----- | :--------------------------------------------- | :-------------- |
| GET | [`/2/users/search`](/x-api/users/search-users) | Buscar usuários |
***
## Exemplo de requisição
```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"
```
## Exemplo de resposta
```json title="Exemplo de resposta" 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
}
}
```
***
## Introdução
**Pré-requisitos**
* Uma [conta de desenvolvedor](https://developer.x.com/en/portal/petition/essential/basic-info) aprovada
* Um [Project e App](/resources/fundamentals/developer-apps) no Developer Console
* As [chaves e tokens](/resources/fundamentals/authentication) do seu App
Consulte usuários por ID ou username
Documentação completa do endpoint