API de X / Twitter

API de X / Twitter: Buscar usuarios

Busca cuentas de X (Twitter) por palabra clave: la pestaña Personas de la búsqueda de X. Coincide con nombres de usuario, nombres visibles y biografías de perfil, y devuelve registros de perfil normalizados con número de seguidores, seguidos y publicaciones, además de paginación por cursor. Usa twitter.search para publicaciones.

US$0.54/1k solic., pagas por solicitud, sin suscripción.

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
Lo que devolvió la APIusers[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 más
}
Disponibilidad
98.28%
30d · 106,743 llamadas
Solicitudes
108,440
30d · semanal, últimas 12 sem.
Respuesta
1.2s
mediana · 30d

Pruébalo

Obtén Buscar usuarios de X / Twitter en una sola solicitud

requireFieldsarray
Opcional; si lo omites, el enrutamiento no cambia y atiende la fuente más barata. Indica los campos de salida que esta solicitud debe poder devolver, por ejemplo `location`, y solo la atenderá una fuente que los devuelva todos. Los campos que no indiques se siguen devolviendo siempre que la fuente que atiende los tenga. Esto puede subir tu precio: cuando la fuente más barata no puede devolver un campo indicado, atiende una fuente más cara, y se te cotiza y cobra su precio. Un campo indicado puede faltar igualmente en un perfil que realmente no lo tenga. Indicar una combinación que ninguna fuente devuelve junta se rechaza como entrada no válida, sin cargo. Al recorrer varias páginas, solo se aplica a la primera; las páginas siguientes se quedan con la fuente elegida para esa página, al precio que se cotizó.
Abrir en
Respuesta de ejemplo
Las ejecuciones gratis devuelven solo los primeros 3 resultados. Agrega fondos a una clave para obtener la respuesta completa.

Este ejemplo muestra 19 de 20 campos. Ver todos los 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"
  }
}

Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.

Referencia

Una solicitud, un formato de respuesta.

Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.

Verificado por última vez el 2026-11-14 · disponibilidad y latencia medidas en 30d

Cuerpo de la solicitud

JSON, enviado por POST a este endpoint.

  • querystring

    ai agents

    Palabra clave a comparar con los nombres de usuario, nombres visibles y biografías de perfil de X (Twitter). Es la pestaña Personas de la búsqueda de X: pasa un tema ('ai agents'), un nombre ('Elon Musk') o un nombre de usuario ('openai') y recibe cuentas, no publicaciones. Usa twitter.search para publicaciones.

  • cursorstring

    Cursor de paginación opaco tomado de nextCursor en una respuesta anterior. Omítelo para la primera página; pásalo para obtener la siguiente página de cuentas.

  • requireFieldsarray

    Opcional; si lo omites, el enrutamiento no cambia y atiende la fuente más barata. Indica los campos de salida que esta solicitud debe poder devolver, por ejemplo `location`, y solo la atenderá una fuente que los devuelva todos. Los campos que no indiques se siguen devolviendo siempre que la fuente que atiende los tenga. Esto puede subir tu precio: cuando la fuente más barata no puede devolver un campo indicado, atiende una fuente más cara, y se te cotiza y cobra su precio. Un campo indicado puede faltar igualmente en un perfil que realmente no lo tenga. Indicar una combinación que ninguna fuente devuelve junta se rechaza como entrada no válida, sin cargo. Al recorrer varias páginas, solo se aplica a la primera; las páginas siguientes se quedan con la fuente elegida para esa página, al precio que se cotizó.

Envías. Un cuerpo JSON pequeño. Los valores que se muestran son ejemplos para reemplazar por los tuyos.

Respuesta

JSON, un valor de ejemplo 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).

  • canDmbooleanse puede exigir

    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.

  • listedCountintegerse puede exigir

    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.

  • locationstringse puede exigir

    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.

Recibes. Campos con nombre y tipo, con el mismo formato sin importar qué fuente responda.

Preguntas frecuentes

Acerca del endpoint Buscar usuarios de la API de X / Twitter

El endpoint Buscar usuarios de AnyAPI para X / Twitter devuelve datos de X / Twitter como JSON normalizado con una sola llamada POST a /v1/run/twitter.search_users. Busca cuentas de X (Twitter) por palabra clave: la pestaña Personas de la búsqueda de X. Coincide con nombres de usuario, nombres visibles y biografías de perfil, y devuelve registros de perfil normalizados con número de seguidores, seguidos y publicaciones, además de paginación por cursor. Usa twitter.search para publicaciones. AnyAPI enruta cada solicitud entre 3 fuentes y recurre automáticamente a otra cuando una falla. Cuesta desde US$0.54 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. En los últimos 30 días, el 98.3% de las llamadas al endpoint Buscar usuarios de la API de X / Twitter a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 1.2 segundos en 106.743 llamadas medidas.

Cuesta desde US$0.54 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. Agregas fondos a una billetera en dólares y cada llamada descuenta de ella. Algunas solicitudes fallidas pagadas con la billetera generan cargos de procesamiento que trasladamos al costo, sin margen; la respuesta de error muestra el monto cobrado.

Busca cuentas de X (Twitter) por palabra clave: la pestaña Personas de la búsqueda de X. Coincide con nombres de usuario, nombres visibles y biografías de perfil, y devuelve registros de perfil normalizados con número de seguidores, seguidos y publicaciones, además de paginación por cursor. Usa twitter.search para publicaciones. La respuesta es JSON normalizado con el mismo envoltorio que devuelve cada endpoint de AnyAPI, así que procesar un segundo endpoint es solo cambiar la URL.

En los últimos 30 días, el 98.3% de las llamadas al endpoint Buscar usuarios de la API de X / Twitter a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 1.2 segundos en 106.743 llamadas medidas. Estas son mediciones propias de AnyAPI sobre el tráfico que pasa por el gateway, recalculadas continuamente, no un objetivo de nivel de servicio publicado.

Sí. Una cuenta nueva de AnyAPI empieza con US$0.10 de saldo gratis, sin tarjeta, que alcanza para 185 llamadas a Buscar usuarios de X / Twitter a US$0.00054 cada una.

AnyAPI consulta la siguiente de sus 3 fuentes en la misma solicitud, empezando por la más barata, así que la caída de una fuente no hace fallar tu llamada.

Envía una solicitud POST a https://api.getanyapi.com/v1/run/twitter.search_users con tu clave de AnyAPI en un encabezado "Authorization: Bearer" y la entrada como cuerpo JSON. La misma clave y la misma billetera sirven para todos los endpoints de AnyAPI.

No. Agregas dólares a un solo saldo prepagado de AnyAPI y cada solicitud descuenta de él. No hay plan mensual ni mínimo, y el mismo saldo paga todos los endpoints de AnyAPI.

Sí. Instala @getanyapi/sdk desde npm para TypeScript o getanyapi desde pip para Python. Ambos llaman a todos los endpoints de AnyAPI con la misma clave, y también sirve cualquier cliente HTTP.

Sí. Un agente puede conectarse al servidor MCP de AnyAPI en https://api.getanyapi.com/mcp, o crear su propia clave de prueba gratis con un solo POST sin autenticar a https://api.getanyapi.com/agent/signup y llamar a este endpoint por HTTP.