API para X / Twitter

API para X / Twitter: Seguidores

Obtenha a lista de seguidores de qualquer conta pública do X (Twitter) pelo nome de usuário, com paginação por cursor. O limit é um máximo por página e uma página nativa tem até 200 contas; siga o nextCursor da resposta para obter mais.

POST/v1/run/twitter.followers
Disponibilidade
97,80%
30d · 681 chamadas
Requisições
681
30d · semanal, últimas 12 sem.
Resposta
2,3s
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 `bio`, 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 perfil 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": {
    "createdUtc": 12.5,
    "id": "a1b2c3d4",
    "items": [
      {
        "avatarUrl": "https://example.com/image.jpg",
        "bio": "A short example description of this item.",
        "followers": 12500,
        "following": 12500,
        "location": "example",
        "name": "Example title",
        "username": "alex_rivera",
        "verified": true
      }
    ],
    "nextCursor": "example"
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface TwitterFollowersResponse {
  data: {
    createdUtc?: number;
    id?: string;
    items: {
      avatarUrl: string;
      bio?: string;
      followers: number;
      following?: number;
      location: string;
      name: string;
      username: string;
      verified: boolean;
    }[];
    nextCursor?: string | null;
  } | 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.followers
curl -X POST https://api.getanyapi.com/v1/run/twitter.followers \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":200,"username":"nasa"}'
CampoTipoValor de exemplo
Corpo da requisição
usernamestring"nasa"Nome de usuário do X (Twitter) cujos seguidores serão buscados, sem o prefixo @ (ex.: elonmusk).
cursorstringCursor de paginação opaco vindo do nextCursor da resposta anterior. Omita na primeira página; envie-o para buscar a próxima página de seguidores.
limitinteger200Número máximo de seguidores a retornar por página (padrão 200). Uma página nativa tem até 200 contas, então um limit maior ainda retorna no máximo uma página nativa; siga o nextCursor da resposta para obter mais.
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 `bio`, 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 perfil 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
dataobject
data.createdUtcnumberUTC epoch timestamp in seconds (Unix time) the account was created. Multiply by 1000 for a JS Date in milliseconds.
data.idstringNumeric X user id of the account, as a string.
data.itemsobject[]Follower records, normalized to a compact shape. Populated whenever the provider has data for the entity.
data.items[].avatarUrlstringURL of the account's profile image (may be empty). Populated whenever the provider has data for the entity.
data.items[].biopode ser exigidostringThe account's profile bio/description.
data.items[].followersintegerHow many followers this account has.
data.items[].followingpode ser exigidointegerHow many accounts this account follows.
data.items[].locationstringThe account's self-reported location (may be empty).
data.items[].namestringThe account's display name. Populated whenever the provider has data for the entity.
data.items[].usernamestringThe account's @ handle, without the @ prefix. Populated whenever the provider has data for the entity.
data.items[].verifiedbooleanWhether the account is verified.
data.nextCursorstringOpaque cursor for the next page of followers, or null when there are no more. Pass it back as cursor to continue.
foundboolean
reason"not_found"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. 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 Seguidores da API para X / Twitter

O endpoint Seguidores da AnyAPI para X / Twitter retorna dados de X / Twitter em JSON normalizado com uma chamada POST para /v1/run/twitter.followers. Obtenha a lista de seguidores de qualquer conta pública do X (Twitter) pelo nome de usuário, com paginação por cursor. O limit é um máximo por página e uma página nativa tem até 200 contas; siga o nextCursor da resposta para obter mais. A AnyAPI distribui cada requisição entre 2 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, 97,8% das chamadas ao endpoint Seguidores da API para X / Twitter feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,3 segundos, em 681 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 lista de seguidores de qualquer conta pública do X (Twitter) pelo nome de usuário, com paginação por cursor. O limit é um máximo por página e uma página nativa tem até 200 contas; siga o nextCursor da resposta para obter mais. 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, 97,8% das chamadas ao endpoint Seguidores da API para X / Twitter feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,3 segundos, em 681 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.