> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-b90e1c4d.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# User Search
> Search X users by keyword with the X API v2 User search endpoint to find accounts by name, handle, bio terms, and other public profile fields and metadata.
export const Button = ({href, children}) => {
return ;
};
The User Search endpoint lets you search for users by keyword. Find users by name, username, or content in their bio.
## Overview
Search by name, username, or bio
Find relevant accounts
***
## Endpoint
| Method | Endpoint | Description |
| :----- | :--------------------------------------------- | :--------------- |
| GET | [`/2/users/search`](/x-api/users/search-users) | Search for users |
***
## Example request
```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"
```
## Example response
```json title="Example response" lines wrap icon="https://mintcdn.com/x-preview-mintlify-b90e1c4d/FzxSSaEcmuIUnJHr/icons/xds/icon-brackets.svg?fit=max&auto=format&n=FzxSSaEcmuIUnJHr&q=85&s=b0ec2f0aab78c7fbb98f1f71feda1b01" 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
}
}
```
***
## Getting started
**Prerequisites**
* An approved [developer account](https://developer.x.com/en/portal/petition/essential/basic-info)
* A [Project and App](/resources/fundamentals/developer-apps) in the Developer Console
* Your App's [keys and tokens](/resources/fundamentals/authentication)
Look up users by ID or username
Full endpoint documentation