Filtrar por identificadores e datas no X
Nesta página
Direcione as suas pesquisas no X com precisão
A Pesquisa no X oferece verdadeiro valor assim que dominar os seus parâmetros de filtragem. Em vez de obter um feed bruto de publicações, pode direcionar contas específicas, definir janelas temporais precisas e excluir fontes de ruído. Estes filtros transformam uma ferramenta de pesquisa genérica num instrumento de monitorização de precisão.
Filtrar por identificadores: allowed_x_handles e excluded_x_handles
Monitorizar contas específicas
O parâmetro allowed_x_handles restringe a pesquisa às publicações das contas que listar. Pode direcionar até 10 identificadores simultaneamente:
response = client.responses.create(
model="grok-4.5",
input="Summary of recent announcements from these tech accounts",
tools=[{
"type": "x_search",
"allowed_x_handles": [
"elonmusk",
"sama",
"demishassabis",
"ylecun"
]
}]
)
Excluir contas ruidosas
O parâmetro excluded_x_handles funciona de forma inversa. Permite todas as contas exceto as que especificar. Útil para eliminar bots ou contas com conteúdo irrelevante:
response = client.responses.create(
model="grok-4.5",
input="Serious discussions on AI regulation",
tools=[{
"type": "x_search",
"excluded_x_handles": ["bot_spam_1", "compte_parodie"]
}]
)
Regra de exclusividade mútua
Tal como os domínios web, allowed_x_handles e excluded_x_handles são mutuamente exclusivos. Não pode combiná-los numa única chamada. O limite é de 10 identificadores por parâmetro, o dobro do limite para domínios web.
Filtrar por datas: from_date e to_date
Os parâmetros de tempo permitem definir uma janela de pesquisa precisa no formato ISO 8601 (AAAA-MM-DD):
response = client.responses.create(
model="grok-4.5",
input="Reactions to the Grok 4.5 announcement",
tools=[{
"type": "x_search",
"from_date": "2026-03-01",
"to_date": "2026-03-15"
}]
)
Estes filtros são particularmente úteis para:
- Analisar o impacto de um evento: definir o período em torno do evento
- Comparar o sentimento antes/depois: executar duas consultas com janelas diferentes
- Evitar ruído antigo: focar em discussões recentes
Utilização com o SDK nativo de Python
O SDK xAI aceita objetos Python datetime além de cadeias ISO:
from xai_sdk.tools import x_search
from datetime import datetime
response = client.chat.create(
model="grok-4.5",
tools=[x_search(
from_date=datetime(2026, 3, 1),
to_date=datetime(2026, 3, 31)
)]
)
Convenção camelCase em JavaScript
O SDK Vercel AI utiliza a convenção camelCase para os nomes dos parâmetros:
tools: [xai.tools.xSearch({
allowedXHandles: ["elonmusk"],
fromDate: "2026-03-01",
toDate: "2026-03-31"
})]
Combinar filtros
Pode combinar identificadores e datas numa única chamada para máxima precisão:
response = client.responses.create(
model="grok-4.5",
input="What did Sam Altman say about GPT-5 in March 2026?",
tools=[{
"type": "x_search",
"allowed_x_handles": ["sama"],
"from_date": "2026-03-01",
"to_date": "2026-03-31"
}]
)
Construir um sistema de monitorização dinâmico
Ao combinar estes filtros programaticamente, pode construir uma ferramenta de monitorização configurável:
def create_x_monitor(handles, days_back=7):
from datetime import datetime, timedelta
today = datetime.now()
start = (today - timedelta(days=days_back)).strftime("%Y-%m-%d")
return {
"type": "x_search",
"allowed_x_handles": handles,
"from_date": start,
"to_date": today.strftime("%Y-%m-%d")
}
# Monitorizar líderes de IA durante a semana
tool = create_x_monitor(
handles=["sama", "demishassabis", "ylecun"],
days_back=7
)
Prática
Configure uma pesquisa direcionada no X para 3 a 5 contas influentes no seu setor. Defina uma janela temporal de uma semana e compare os resultados com uma pesquisa sem filtros de identificador. Meça a diferença de relevância.
Pontos-chave
allowed_x_handleseexcluded_x_handlesfiltram por conta (máximo de 10 cada)- Ambos os parâmetros de identificador são mutuamente exclusivos
from_dateeto_datedefinem a janela temporal no formatoAAAA-MM-DD- As datas podem ser combinadas com filtros de identificador
- O SDK de Python aceita objetos
datetime, o SDK de JavaScript usa camelCase - Estes filtros transformam a Pesquisa no X de uma ferramenta genérica num instrumento de monitorização direcionado