Consulta de mutes

Este guia mostra como recuperar sua lista de usuários silenciados usando a X API.

Pré-requisitosAntes de começar, você precisará de:

Uma conta de desenvolvedor com um App aprovado
User Access Token (OAuth 1.0a ou OAuth 2.0 PKCE)

Obter seus usuários silenciados

Obtenha seu user ID

Você precisa do ID do usuário autenticado. Encontre-o usando o endpoint de consulta de usuário ou a partir do seu Access Token (a parte numérica é o seu user ID).

Solicite seus usuários silenciados

cURL

curl "https://api.x.com/2/users/123456789/muting?\
user.fields=created_at,username,verified&\
max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

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")

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`);
  });
}

Revise a resposta

{
  "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:

cURL

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"

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

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

Exemplo de resposta

{
  "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:

curl "https://api.x.com/2/users/123456789/muting?\
max_results=100&\
pagination_token=1710819323648428707" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Consulta de mutes

Obter seus usuários silenciados

Incluir dados adicionais

Resposta com expansion

Paginar pelos resultados

Próximos passos

Gerenciar mutes

Referência da API

​Obter seus usuários silenciados

​Incluir dados adicionais

​Resposta com expansion

​Paginar pelos resultados

​Próximos passos

Gerenciar mutes

Referência da API

Obter seus usuários silenciados

Incluir dados adicionais

Resposta com expansion

Paginar pelos resultados

Próximos passos