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.

Comece grátisBaixar amostraou JSON

US$ 0,54/mil req., pague por requisição, sem assinatura.

ai agents / X
x.com/search?q=ai%20agents&src=typed_query&f=user

ai agents

TopLatestPeopleMediaLists
M

Marcus Feld | AI Agents

@marcus_builds_ai

Building autonomous AI agents for support and sales. Ex-Stripe. Writing about agent orchestration weekly.

48.2K Followers

Follow
O que a API retornouusers[0]
{
"id": "1893004471820193024",
"username": "marcus_builds_ai",
"name": "Marcus Feld | AI Agents",
"profileUrl": "https://x.com/marcus_builds_ai",
"bio": "Building autonomous AI agents for support and sales. Ex-Stripe. Writing about agent orchestration weekly.",
"followers": 48200,
"following": 612,
"posts": 3840,
... 7 campos a mais
}
Disponibilidade
98,28%
30d · 106.743 chamadas
Requisições
108.440
30d · semanal, últimas 12 sem.
Resposta
1,2s
mediana · 30d

Preços e provedores

Preços do endpoint Buscar usuários da API para X / Twitter: uma API, 3 provedores intercambiáveis

O provedor mais barato atende primeiro. Se ele falhar, o próximo assume na mesma chamada.

Provedor
1LynxAtende primeiro85,13% de disponibilidade999ms p5047,0% das chamadasUS$ 0,54/mil req.flat2CapybaraReserva 182,64% de disponibilidade1280ms p5037,2% das chamadasUS$ 0,70/mil req.flat3BadgerReserva 292,39% de disponibilidade586ms p5015,8% das chamadasUS$ 0,105/mil resultadosaté US$ 0,0021 / requisição
Você paga
US$ 5,40
US$ 0,54/mil req., só pelo que você usar. Sem plano mensal.
Suas primeiras 185 requisições são grátis com o saldo inicial de US$ 0,10.

Teste

Obtenha Buscar usuários do X / Twitter em uma só 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 `location`, 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.

Este exemplo mostra 19 de 20 campos. Ver todos os campos

{
  "found": true,
  "data": {
    "users": [
      {
        "id": "1893004471820193024",
        "username": "marcus_builds_ai",
        "name": "Marcus Feld | AI Agents",
        "profileUrl": "https://x.com/marcus_builds_ai",
        "bio": "Building autonomous AI agents for support and sales. Ex-Stripe. Writing about agent orchestration weekly.",
        "followers": 48200,
        "following": 612,
        "posts": 3840,
        "verified": true,
        "location": "Austin, TX",
        "avatarUrl": "https://pbs.twimg.com/profile_images/1893004471820193024/marcus_400x400.jpg",
        "createdUtc": 1517443200,
        "coverUrl": "https://pbs.twimg.com/profile_banners/1893004471820193024/1700000000",
        "listedCount": 214,
        "canDm": true
      },
      {
        "id": "1560093221004840960",
        "username": "agentstacknews",
        "name": "Agent Stack",
        "profileUrl": "https://x.com/agentstacknews",
        "bio": "Daily news on AI agents, tool use, and multi-agent frameworks.",
        "followers": 22900,
        "following": 88,
        "posts": 9120,
        "verified": false,
        "location": "",
        "avatarUrl": "https://pbs.twimg.com/profile_images/1560093221004840960/stack_400x400.jpg",
        "createdUtc": 1651363200,
        "listedCount": 61,
        "canDm": false
      },
      {
        "id": "1401882093771280384",
        "username": "priya_agentlabs",
        "name": "Priya Raman",
        "profileUrl": "https://x.com/priya_agentlabs",
        "bio": "Founder @AgentLabsHQ. Previously ML eng at a11y startup. She/her.",
        "followers": 15300,
        "following": 940,
        "posts": 2205,
        "verified": true,
        "location": "San Francisco, CA",
        "avatarUrl": "https://pbs.twimg.com/profile_images/1401882093771280384/priya_400x400.jpg",
        "createdUtc": 1622505600,
        "coverUrl": "https://pbs.twimg.com/profile_banners/1401882093771280384/1690000000",
        "listedCount": 47,
        "canDm": true
      }
    ],
    "nextCursor": "DAABCgABGZ3xw5A2xVIKAAIY__users_page2"
  }
}

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

Referência

Uma requisição, um formato de resposta.

Cada campo que você envia e cada campo que você recebe, cada um com um exemplo real.

Última verificação em 2026-11-14 · disponibilidade e latência medidas em 30d

Corpo da requisição

JSON, enviado via POST para este endpoint.

  • 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.

  • cursorstring

    Cursor 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.

  • 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 `location`, 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.

Você envia. Um corpo JSON pequeno. Os valores mostrados são exemplos para você trocar pelos seus.

Resposta

JSON, um valor de exemplo por campo.

datadata

The page of matching accounts, or null when nothing was found.

  • nextCursorstring

    DAABCgABGZ3xw5A2xVIKAAIY__users_page2

    Opaque cursor for the next page of accounts, or null when this lane has no more. Pass it back as cursor to continue.

each userdata.users[]

Matching X (Twitter) accounts, normalized to a compact profile record. Populated whenever the provider has data for the entity.

  • avatarUrlstring

    https://pbs.twimg.com/profile_images/1893004471820193024/marcus_400x400.jpg

    URL of the account's profile image. Populated whenever the provider has data for the entity.

  • biostring

    Building autonomous AI agents for support and sales. Ex-Stripe. Writing about agent orchestration weekly.

    The account's profile bio/description (may be empty).

  • canDmbooleanpode ser exigido

    true

    Whether the account accepts direct messages; null when the serving source does not return it. Name it in requireFields to be served by a source that does.

  • coverUrlstring

    https://pbs.twimg.com/profile_banners/1893004471820193024/1700000000

    Profile banner image URL of the account.

  • createdUtcnumber

    1517443200

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • followersinteger

    48200

    How many followers this account has.

  • followinginteger

    612

    How many accounts this account follows.

  • idstring

    1893004471820193024

    The account's numeric X user id. Populated whenever the provider has data for the entity.

  • listedCountintegerpode ser exigido

    214

    Number of public lists the account appears on; null when the serving source does not return it. Name it in requireFields to be served by a source that does.

  • locationstringpode ser exigido

    Austin, TX

    The account's self-reported location (may be empty); null when the serving source does not return locations. Name it in requireFields to be served by a source that does.

  • namestring

    Marcus Feld | AI Agents

    The account's display name. Populated whenever the provider has data for the entity.

  • postsinteger

    3840

    How many posts this account has published.

  • profileUrlstring

    https://x.com/marcus_builds_ai

    Canonical URL of the account's X profile. Populated whenever the provider has data for the entity.

  • usernamestring

    marcus_builds_ai

    The account's @ handle, without the @ prefix. Populated whenever the provider has data for the entity.

  • verifiedboolean

    true

    Whether the account carries the blue verification check.

top level
  • foundboolean

    true

    True 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.

Você recebe. Campos nomeados e tipados, no mesmo formato, seja qual for a fonte que responder.

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 3 fontes, com failover automático quando uma falha. Custa a partir de US$ 0,54 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 98,3% das chamadas ao endpoint Buscar usuários da API para X / Twitter feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,2 segundos, em 106.743 chamadas medidas.

Custa a partir de US$ 0,54 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, 98,3% das chamadas ao endpoint Buscar usuários da API para X / Twitter feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,2 segundos, em 106.743 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.

Sim. Uma conta nova da AnyAPI começa com US$ 0,10 de saldo grátis, sem cartão, o que cobre 185 chamadas de Buscar usuários do X / Twitter a US$ 0,00054 cada.

A AnyAPI consulta a próxima das suas 3 fontes na mesma requisição, começando pela mais barata, então a queda de uma fonte não derruba sua chamada.

Envie uma requisição POST para https://api.getanyapi.com/v1/run/twitter.search_users com sua chave da AnyAPI em um cabeçalho "Authorization: Bearer" e a entrada como corpo JSON. A mesma chave e a mesma carteira funcionam em todos os endpoints da AnyAPI.

Não. Você adiciona dólares a um único saldo pré-pago da AnyAPI e cada requisição desconta dele. Não há plano mensal nem mínimo, e o mesmo saldo paga todos os endpoints da AnyAPI.

Sim. Instale @getanyapi/sdk pelo npm para TypeScript ou getanyapi pelo pip para Python. Os dois chamam todos os endpoints da AnyAPI com a mesma chave, e qualquer cliente HTTP também funciona.

Sim. Um agente pode se conectar ao servidor MCP da AnyAPI em https://api.getanyapi.com/mcp, ou criar a própria chave de teste grátis com um único POST sem autenticação para https://api.getanyapi.com/agent/signup e chamar este endpoint por HTTP.
Mais para chamar

Outros endpoints de X / Twitter

Perfila partir de US$ 0,22 /mil req.Tweets do usuárioa partir de US$ 0,45 /mil req.Tweeta partir de US$ 0,22 /mil req.Artigoa partir de US$ 0,54 /mil req.Comunidadea partir de US$ 0,10 /mil req.Tweets da comunidadea partir de US$ 0,45 /mil req.Seguidoresa partir de US$ 0,45 /mil req.Seguindoa partir de US$ 0,45 /mil req.Respostasa partir de US$ 0,45 /mil req.Buscara partir de US$ 0,54 /mil req.Buscar comunidadesa partir de US$ 0,11 /mil resultadosThreada partir de US$ 2,69 /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,45 /mil req.