API para X / Twitter

API para X / Twitter: Tweets do usuário

Linha do tempo paginada dos tweets de um usuário, com texto, mídia e contagens de engajamento. Pagine com o campo cursor.

POST/v1/run/twitter.user_tweets
Disponibilidade
100,00%
30d · 64.067 chamadas
Requisições
64.067
30d · semanal, últimas 12 sem.
Resposta
1,4s
mediana · 30d

Teste

Faça sua primeira requisição

requireFieldsarray
Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `isPinned`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um post que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança. Ao paginar, vale só para a primeira página; as páginas seguintes continuam na fonte que a primeira página escolheu, pelo preço cotado.
Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
  "found": true,
  "data": {
    "nextCursor": "DAABCgABF__cursor",
    "tweets": [
      {
        "id": "1800000000000000000",
        "url": "https://x.com/NASA/status/1800000000000000000",
        "text": "Liftoff! 🚀",
        "likes": 142000,
        "retweets": 21400,
        "replies": 3900,
        "createdAt": "2024-06-09T13:45:00Z"
      }
    ]
  }
}
Interface da resposta
interface TwitterUserTweetsResponse {
  data: {
    nextCursor?: string | null;
    tweets: {
      authorHandle?: string;
      authorId?: string;
      authorImage?: string;
      authorName?: string;
      bookmarks: number;
      conversationId?: string;
      createdUtc: number;
      id: string;
      isPinned: boolean | null;
      isReply?: boolean;
      lang?: string;
      likes: number;
      media?: {
        height?: number;
        type: string;
        url: string;
        videoUrl?: string;
        width?: number;
      }[];
      quotes?: number;
      replies: number;
      retweets: number;
      source?: string;
      text: string;
      url: string;
      views: number;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Requisição, resposta e preço

Última verificação em 2026-09-29 · disponibilidade e latência medidas em 30d
POST /v1/run/twitter.user_tweets
curl -X POST https://api.getanyapi.com/v1/run/twitter.user_tweets \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle":"nasa","cursor":"0"}'
CampoTipoValor de exemplo
Corpo da requisição
handlestring"nasa"Nome de usuário do Twitter/X sem o @ inicial.
cursorstring"0"Cursor de paginação opaco do nextCursor de uma resposta anterior. Omita na primeira página.
limitintegerNúmero máximo de tweets e respostas do próprio usuário a retornar NESTA página (1-100). As fontes retornam menos, a maioria no máximo 20, então leia `nextCursor` e envie-o de volta como `cursor` para continuar, em vez de pedir uma única página grande.
requireFieldsarrayOpcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `isPinned`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um post que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança. Ao paginar, vale só para a primeira página; as páginas seguintes continuam na fonte que a primeira página escolheu, pelo preço cotado.
requireSinglePagebooleanExige uma fonte que consiga retornar o limit pedido em uma única resposta.
Resposta
foundbooleantrue
dataobject
data.nextCursorstring"DAABCgABF__cursor"
data.tweetsarray
data.tweets[].idstring"1800000000000000000"
data.tweets[].urlstring"https://x.com/NASA/status/1800000000000000000"
data.tweets[].textstring"Liftoff! 🚀"
data.tweets[].likesnumber142000
data.tweets[].retweetsnumber21400
data.tweets[].repliesnumber3900
data.tweets[].createdAtstring"2024-06-09T13:45:00Z"
Preço
Preço por requisiçãoUSDUS$ 0,0005
Preço /mil req.USDUS$ 0,50

Dúvidas frequentes

Sobre o endpoint Tweets do usuário da API para X / Twitter

O endpoint Tweets do usuário da AnyAPI para X / Twitter retorna dados de X / Twitter em JSON normalizado com uma chamada POST para /v1/run/twitter.user_tweets. Linha do tempo paginada dos tweets de um usuário, com texto, mídia e contagens de engajamento. Pagine com o campo cursor. A AnyAPI distribui cada requisição entre 3 fontes, com failover automático quando uma falha. Custa a partir de US$ 0,50 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Tweets do usuário da API para X / Twitter feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,4 segundos, em 64.067 chamadas medidas.

Custa a partir de US$ 0,50 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Linha do tempo paginada dos tweets de um usuário, com texto, mídia e contagens de engajamento. Pagine com o campo cursor. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 100,0% das chamadas ao endpoint Tweets do usuário da API para X / Twitter feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,4 segundos, em 64.067 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.