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
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
{"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}
Precios y proveedores
Precios del endpoint Buscar usuarios de la API de X / Twitter: una API, 3 proveedores intercambiables
El proveedor más barato responde primero. Si falla, el siguiente toma el relevo en la misma llamada.
con un tope de US$0.0021 por solicitud1 resultadoUS$0.000210 resultadosUS$0.001120 resultadostope de US$0.0021Se te cobra por lo que se devuelve. Baja el límite para pagar menos, y ninguna solicitud puede costar más que el tope, sin importar cuánto se devuelva.
Pruébalo
Obtén Buscar usuarios de X / Twitter en una sola solicitud
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ó.
Respuesta
JSON, un valor de ejemplo por campo.
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.
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.
- 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.
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.