X / Twitter (dados públicos)

X / Twitter (dados públicos): Perfis, posts, respostas, buscas e tendências públicas do X.

Atualizado em 05/11/2026.

O que é X / Twitter (dados públicos) na APIcultura

Acesse X / Twitter (dados públicos) pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Perfis, posts, respostas, buscas e tendências públicas do X. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: Redes (dados públicos). Autenticação: chave da própria APIcultura (apk_live_...); nenhuma conta de terceiros precisa ser conectada.

Endpoints e preço por chamada

Endpoint (slug)	O que faz	Preço por chamada	Rota
`x-perfil`	Perfil público	R$ 0,01	`POST /v1/call/x-perfil`
`x-posts-perfil`	Posts de um perfil	R$ 0,01	`POST /v1/call/x-posts-perfil`
`x-buscar-posts`	Buscar posts	R$ 0,01	`POST /v1/call/x-buscar-posts`
`x-respostas-post`	Respostas de um post	R$ 0,01	`POST /v1/call/x-respostas-post`
`x-tendencias`	Tendências	R$ 0,01	`POST /v1/call/x-tendencias`

Perfil público (`x-perfil`)

Dados de um perfil público do X. Preço: R$ 0,01 por chamada.

username (string, obrigatório), ex.: nasa

Schema de entrada de x-perfil

{
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Posts de um perfil (`x-posts-perfil`)

Posts recentes de uma conta. Preço: R$ 0,01 por chamada.

limit (integer, opcional), ex.: 20
username (string, obrigatório), ex.: nasa

Schema de entrada de x-posts-perfil

{
  "required": [
    "username"
  ],
  "properties": {
    "limit": {
      "type": "number"
    },
    "username": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Buscar posts (`x-buscar-posts`)

Busca posts públicos no X. Preço: R$ 0,01 por chamada.

limit (integer, opcional), ex.: 20
mode (string, opcional), ex.: latest
query (string, obrigatório), ex.: rust lang

Schema de entrada de x-buscar-posts

{
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "number"
    },
    "mode": {
      "type": "string",
      "maxLength": 2000
    },
    "query": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Respostas de um post (`x-respostas-post`)

Respostas a um post. Preço: R$ 0,01 por chamada.

limit (integer, opcional), ex.: 20
tweet (string, obrigatório), ex.: https://x.com/NASA/status/2095890075447964086

Schema de entrada de x-respostas-post

{
  "required": [
    "tweet"
  ],
  "properties": {
    "limit": {
      "type": "number"
    },
    "tweet": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Tendências (`x-tendencias`)

Assuntos em alta no X. Preço: R$ 0,01 por chamada.

limit (integer, opcional, padrão 50, mín. 1, máx. 50), ex.: 10
location (string, opcional), ex.: US

Schema de entrada de x-tendencias

{
  "required": [],
  "properties": {
    "limit": {
      "type": "number"
    },
    "location": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta call com o slug do endpoint e a entrada:

{ "name": "call", "arguments": { "slug": "x-perfil", "input": {"username":"nasa"}, "max_cost_brl": 0.1 } }

Exemplo de chamada HTTP

curl -X POST https://api.apicultura.app/v1/call/x-perfil \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"username":"nasa"}'

Formato da resposta, preço e limites

A resposta é JSON com data (o resultado do endpoint) e meta (inclui cost_brl, o valor cobrado). Preço deste endpoint: R$ 0,01 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use max_cost_brl para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

Workflows que usam X / Twitter (dados públicos)

Monitorar menções públicas da sua marca

Experimente

Teste no playground interativo: X / Twitter (dados públicos) no playground. Veja também todas as ferramentas, como conectar seu agente e o FAQ.

Nota. X / Twitter (dados públicos) é marca de seus respectivos donos, citada apenas para identificar a integração.