> ## 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.
# Consulta de mutes
> Este guia mostra como recuperar sua lista de usuários silenciados usando a X API. Referência para o nível standard da X API v2 sobre quickstart.
export const Button = ({href, children}) => {
return ;
};
Este guia mostra como recuperar sua lista de usuários silenciados usando a X API.
**Pré-requisitos**
Antes de começar, você precisará de:
* Uma [conta de desenvolvedor](https://developer.x.com/en/portal/petition/essential/basic-info) com um App aprovado
* User Access Token (OAuth 1.0a ou OAuth 2.0 PKCE)
***
## Obter seus usuários silenciados
Você precisa do ID do usuário autenticado. Encontre-o usando o [endpoint de consulta de usuário](/x-api/users/lookup/introduction) ou a partir do seu Access Token (a parte numérica é o seu user ID).
```bash cURL theme={null}
curl "https://api.x.com/2/users/123456789/muting?\
user.fields=created_at,username,verified&\
max_results=100" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN"
```
```python title="Python SDK" lines wrap icon="python" theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# Obter usuários silenciados com paginação
for page in client.users.get_muting(
"123456789",
user_fields=["created_at", "username", "verified"],
max_results=100
):
for user in page.data:
print(f"{user.username} - Muted")
```
```javascript title="JavaScript SDK" lines wrap icon="square-js" theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// Obter usuários silenciados com paginação
const paginator = client.users.getMuting("123456789", {
userFields: ["created_at", "username", "verified"],
maxResults: 100,
});
for await (const page of paginator) {
page.data?.forEach((user) => {
console.log(`${user.username} - Muted`);
});
}
```
```json theme={null}
{
"data": [
{
"id": "2244994945",
"name": "X Developers",
"username": "XDevelopers",
"created_at": "2013-12-14T04:35:55.000Z",
"verified": true
}
],
"meta": {
"result_count": 1,
"next_token": "1710819323648428707"
}
}
```
***
## Incluir dados adicionais
Use expansions para obter dados relacionados, como Posts fixados:
```bash cURL theme={null}
curl "https://api.x.com/2/users/123456789/muting?\
user.fields=created_at&\
expansions=pinned_tweet_id&\
tweet.fields=created_at" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN"
```
```python title="Python SDK" lines wrap icon="python" theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# Obter usuários silenciados com expansions
for page in client.users.get_muting(
"123456789",
user_fields=["created_at"],
expansions=["pinned_tweet_id"],
tweet_fields=["created_at"]
):
for user in page.data:
print(f"{user.username}")
# Posts fixados estão em page.includes.tweets
```
```javascript title="JavaScript SDK" lines wrap icon="square-js" theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// Obter usuários silenciados com expansions
const paginator = client.users.getMuting("123456789", {
userFields: ["created_at"],
expansions: ["pinned_tweet_id"],
tweetFields: ["created_at"],
});
for await (const page of paginator) {
page.data?.forEach((user) => {
console.log(user.username);
});
// Posts fixados estão em page.includes?.tweets
}
```
### Resposta com expansion
```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": [
{
"username": "XDevelopers",
"created_at": "2013-12-14T04:35:55.000Z",
"id": "2244994945",
"name": "X Developers",
"pinned_tweet_id": "1430984356139470849"
}
],
"includes": {
"tweets": [
{
"created_at": "2021-08-26T20:03:51.000Z",
"id": "1430984356139470849",
"text": "Help us build a better X Developer Platform!..."
}
]
},
"meta": {
"result_count": 1
}
}
```
***
## Paginar pelos resultados
Os SDKs tratam a paginação automaticamente. Para cURL, use o `next_token` da resposta:
```bash theme={null}
curl "https://api.x.com/2/users/123456789/muting?\
max_results=100&\
pagination_token=1710819323648428707" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN"
```
***
## Próximos passos
Silencie e reative usuários
Documentação completa do endpoint