API para X / Twitter

API para X / Twitter: Posts do usuário

Obtenha a linha do tempo da aba Posts do perfil de uma conta do X (Twitter) pelo nome de usuário. Os resultados seguem a ordem do perfil: um post fixado pode aparecer primeiro; depois vêm, em ordem cronológica inversa, os posts do autor, reposts, citações e continuações de threads do próprio autor.

POST/v1/run/twitter.user_posts
Disponibilidade
99,88%
30d · 21.075 chamadas
Requisições
21.077
30d · semanal, últimas 12 sem.
Resposta
2,2s
mediana · 30d

Rede de provedores

Provedores ordenados por tráfego

Provedores
LynxTentado primeiro20.708 atendidas98,96% de disponibilidade2053ms p5098,4%US$ 0,50/mil req.preço fixoCapybara311 atendidas100,00% de disponibilidade2231ms p501,5%US$ 0,75/mil req.preço fixoBadger18 atendidas94,74% de disponibilidade614ms p500,1%US$ 0,105/mil resultadosaté US$ 0,0021 / requisição

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` ou `isReply`, 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 tweet 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.
{
  "data": {
    "nextCursor": "example",
    "tweets": [
      {
        "authorHandle": "alex_rivera",
        "authorId": "Alex Rivera",
        "authorImage": "https://example.com/image.jpg",
        "authorName": "Alex Rivera",
        "bookmarks": 42,
        "conversationId": "a1b2c3d4",
        "createdUtc": 12.5,
        "id": "a1b2c3d4",
        "isPinned": true,
        "isReply": true,
        "lang": "en",
        "likes": 12500,
        "media": [
          {
            "height": 42,
            "type": "general",
            "url": "https://example.com/page",
            "videoUrl": "https://example.com/page",
            "width": 1024
          }
        ],
        "quotes": 42,
        "replies": 42,
        "retweets": 42,
        "source": "https://example.com/page",
        "text": "A short example description of this item.",
        "url": "https://example.com/page",
        "views": 12500
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface TwitterUserPostsResponse {
  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" | "suspended";
}

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_posts
curl -X POST https://api.getanyapi.com/v1/run/twitter.user_posts \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle":"levelsio"}'
CampoTipoValor de exemplo
Corpo da requisição
handlestring"levelsio"Nome de usuário do Twitter/X sem o @ inicial.
cursorstringCursor de paginação opaco do nextCursor de uma resposta anterior. Omita na primeira página.
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` ou `isReply`, 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 tweet 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.
Resposta
dataobjectThe Posts-tab timeline page, or null when the account was not found.
data.nextCursorstringOpaque cursor for the next native Posts-tab page, or null when no more pages are available.
data.tweetsobject[]Posts in profile order. A pinned post may appear before otherwise reverse-chronological results. Populated whenever the provider has data for the entity.
data.tweets[].authorHandlestringHandle of the account that posted.
data.tweets[].authorIdstringNumeric X user id of the account that posted, as a string.
data.tweets[].authorImagestringAvatar image URL of the account that posted.
data.tweets[].authorNamestringDisplay name of the account that posted.
data.tweets[].bookmarksintegerNumber of bookmarks.
data.tweets[].conversationIdstringId of the conversation the post belongs to, as a string.
data.tweets[].createdUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.
data.tweets[].idstringThe post's numeric tweet ID, represented as a string. Populated whenever the provider has data for the entity.
data.tweets[].isPinnedpode ser exigidobooleanWhether X marks the post as pinned on the profile, or null when the serving source does not publish it.
data.tweets[].isReplypode ser exigidobooleanWhether X marks the record as a reply. Certified Posts-tab captures use this for self-thread continuations.
data.tweets[].langstringLanguage code reported for the post, when available.
data.tweets[].likesintegerNumber of likes.
data.tweets[].mediaobject[]Photo, video, and GIF attachments on the post. Empty when the post has none.
data.tweets[].media[].heightinteger
data.tweets[].media[].typestringOne of photo, video, or gif.
data.tweets[].media[].urlstringImage URL. For a video or GIF this is the poster/thumbnail frame. X media URLs on pbs.twimg.com are publicly fetchable without authentication; append ?name=orig for the full-resolution original.
data.tweets[].media[].videoUrlstringPlayable video file URL. Present only for video and gif items.
data.tweets[].media[].widthinteger
data.tweets[].quotesintegerNumber of quote posts.
data.tweets[].repliesintegerNumber of replies.
data.tweets[].retweetsintegerNumber of reposts or retweets.
data.tweets[].sourcestringClient the post was sent from, e.g. "Twitter Web App".
data.tweets[].textstringThe post text. Empty for media-only posts. Populated whenever the provider has data for the entity.
data.tweets[].urlstringCanonical x.com URL of the post. Populated whenever the provider has data for the entity.
data.tweets[].viewsintegerNumber of views.
foundbooleanWhether the account's Posts-tab timeline was returned.
reason"not_found" | "suspended"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. `suspended`: the platform has suspended the account. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Preço
Preço por requisiçãoUSDUS$ 0,0005
Preço /mil req.USDUS$ 0,50

Dúvidas frequentes

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

O endpoint Posts 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_posts. Obtenha a linha do tempo da aba Posts do perfil de uma conta do X (Twitter) pelo nome de usuário. Os resultados seguem a ordem do perfil: um post fixado pode aparecer primeiro; depois vêm, em ordem cronológica inversa, os posts do autor, reposts, citações e continuações de threads do próprio autor. 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, 99,9% das chamadas ao endpoint Posts do usuário da API para X / Twitter feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,2 segundos, em 21.075 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.

Obtenha a linha do tempo da aba Posts do perfil de uma conta do X (Twitter) pelo nome de usuário. Os resultados seguem a ordem do perfil: um post fixado pode aparecer primeiro; depois vêm, em ordem cronológica inversa, os posts do autor, reposts, citações e continuações de threads do próprio autor. 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, 99,9% das chamadas ao endpoint Posts do usuário da API para X / Twitter feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,2 segundos, em 21.075 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.
Mais para chamar

Outros endpoints de X / Twitter

Perfila partir de US$ 0,22 /mil req.Tweets do usuárioa partir de US$ 0,50 /mil req.Tweeta partir de US$ 0,22 /mil req.Artigoa partir de US$ 0,75 /mil req.Comunidadea partir de US$ 0,10 /mil req.Tweets da comunidadea partir de US$ 0,50 /mil req.Seguidoresa partir de US$ 0,50 /mil req.Seguindoa partir de US$ 0,50 /mil req.Respostasa partir de US$ 0,50 /mil req.Buscara partir de US$ 0,65 /mil req.Buscar comunidadesa partir de US$ 0,11 /mil resultadosBuscar usuáriosa partir de US$ 0,75 /mil req.Threada partir de US$ 3,75 /mil req.Tendênciasa partir de US$ 0,10 /mil req.Transcrição do tweeta partir de US$ 1,20 /mil req.