API para X / Twitter

API para X / Twitter: Buscar usuários

Busque contas do X (Twitter) por palavra-chave: a aba Pessoas da busca do X. Encontra correspondências em nomes de usuário, nomes de exibição e bios, e retorna registros de perfil normalizados com número de seguidores, seguindo e posts, mais paginação por cursor. Para posts, use twitter.search.

POST/v1/run/twitter.search_users
Disponibilidade
99,95%
30d · 8.539 chamadas
Requisições
8.600
30d · semanal, últimas 12 sem.
Resposta
1,4s
mediana · 30d

Rede de provedores

Provedores ordenados por tráfego

Teste

Faça sua primeira requisição

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",
    "users": [
      {
        "avatarUrl": "https://example.com/image.jpg",
        "bio": "A short example description of this item.",
        "canDm": true,
        "coverUrl": "https://example.com/page",
        "createdUtc": 12.5,
        "followers": 12500,
        "following": 12500,
        "id": "a1b2c3d4",
        "listedCount": 12500,
        "location": "example",
        "name": "Example title",
        "posts": 248,
        "profileUrl": "https://example.com/page",
        "username": "alex_rivera",
        "verified": true
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface TwitterSearchUsersResponse {
  data: {
    nextCursor: string | null;
    users: {
      avatarUrl: string;
      bio: string;
      canDm?: boolean;
      coverUrl?: string;
      createdUtc: number;
      followers: number;
      following: number;
      id: string;
      listedCount?: number;
      location: string;
      name: string;
      posts: number;
      profileUrl: string;
      username: string;
      verified: boolean;
    }[];
  } | 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.search_users
curl -X POST https://api.getanyapi.com/v1/run/twitter.search_users \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"ai agents"}'
CampoTipoValor de exemplo
Corpo da requisição
querystring"ai agents"Palavra-chave comparada com nomes de usuário, nomes de exibição e bios do X (Twitter). É a aba Pessoas da busca do X: passe um tema ('ai agents'), um nome ('Elon Musk') ou um nome de usuário ('openai') e receba contas, não posts. Para posts, use twitter.search.
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 contas.
Resposta
dataobjectThe page of matching accounts, or null when nothing was found.
data.nextCursorstringOpaque cursor for the next page of accounts, or null when this lane has no more. Pass it back as cursor to continue.
data.usersobject[]Matching X (Twitter) accounts, normalized to a compact profile record. Populated whenever the provider has data for the entity.
data.users[].avatarUrlstringURL of the account's profile image. Populated whenever the provider has data for the entity.
data.users[].biostringThe account's profile bio/description (may be empty).
data.users[].canDmbooleanWhether the account accepts direct messages.
data.users[].coverUrlstringProfile banner image URL of the account.
data.users[].createdUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
data.users[].followersintegerHow many followers this account has.
data.users[].followingintegerHow many accounts this account follows.
data.users[].idstringThe account's numeric X user id. Populated whenever the provider has data for the entity.
data.users[].listedCountintegerNumber of public lists the account appears on.
data.users[].locationstringThe account's self-reported location (may be empty).
data.users[].namestringThe account's display name. Populated whenever the provider has data for the entity.
data.users[].postsintegerHow many posts this account has published.
data.users[].profileUrlstringCanonical URL of the account's X profile. Populated whenever the provider has data for the entity.
data.users[].usernamestringThe account's @ handle, without the @ prefix. Populated whenever the provider has data for the entity.
data.users[].verifiedbooleanWhether the account carries the blue verification check.
foundbooleanTrue when the search returned at least one account; false when nothing matched.
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,00075
Preço /mil req.USDUS$ 0,75

Dúvidas frequentes

Sobre o endpoint Buscar usuários da API para X / Twitter

O endpoint Buscar usuários da AnyAPI para X / Twitter retorna dados de X / Twitter em JSON normalizado com uma chamada POST para /v1/run/twitter.search_users. Busque contas do X (Twitter) por palavra-chave: a aba Pessoas da busca do X. Encontra correspondências em nomes de usuário, nomes de exibição e bios, e retorna registros de perfil normalizados com número de seguidores, seguindo e posts, mais paginação por cursor. Para posts, use twitter.search. A AnyAPI distribui cada requisição entre 2 fontes, com failover automático quando uma falha. Custa a partir de US$ 0,75 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar usuários da API para X / Twitter feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,4 segundos, em 8.539 chamadas medidas.

Custa a partir de US$ 0,75 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.

Busque contas do X (Twitter) por palavra-chave: a aba Pessoas da busca do X. Encontra correspondências em nomes de usuário, nomes de exibição e bios, e retorna registros de perfil normalizados com número de seguidores, seguindo e posts, mais paginação por cursor. Para posts, use twitter.search. 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 Buscar usuários da API para X / Twitter feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,4 segundos, em 8.539 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 resultadosThreada 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.Posts do usuárioa partir de US$ 0,50 /mil req.