¿Qué datos puedes obtener de la API de Twitter?

#Los 15 tipos de datos públicos de X que devuelve una API

Los datos públicos de X son lo que X muestra a cualquiera: posts de cuentas que no están protegidas, perfiles, listas de seguidores y los conteos que los acompañan. Una API los devuelve como JSON en 15 tipos:

• Perfiles: nombre, biografía, ubicación, fecha de registro, conteos de seguidores, seguidos y posts, avatar e insignia de verificado.
• Acerca de esta cuenta: el país que X asocia a la cuenta, cuántas veces y cuándo cambió su nombre de usuario, y su estado de X Premium.
• Seguidores y seguidos: la lista completa de ambos lados, cada cuenta con su perfil.
• Posts: texto, idioma, fecha, seis conteos de interacción (likes, reposts, respuestas, citas, vistas, marcadores), enlaces, multimedia y el autor.
• Cronologías: lo que publicó una cuenta, sus respuestas y sus reposts.
• Listas de interacción: las respuestas a un post, sus citas y las cuentas que lo repostearon.
• Búsqueda de posts: cualquier consulta de la Búsqueda avanzada de X con sus operadores, sobre el archivo desde 2006.
• Menciones: posts que etiquetan a una cuenta, filtrados por likes, respuestas, reposts y fechas.
• Búsqueda de cuentas: cuentas cuyo nombre, handle o biografía coinciden con una palabra clave.
• Listas: los miembros de una Lista, sus seguidores y un feed con los posts de sus miembros.
• Comunidades: los detalles de una Comunidad, sus miembros y sus posts, y una búsqueda dentro de ella.
• Spaces: el título, el estado, los anfitriones, los oradores, los oyentes y los conteos de oyentes de una sala de audio en vivo.
• Tendencias: lo que es tendencia en un país o en una ciudad.
• Artículos de X: el texto completo de un post de formato largo, con su imagen de portada y sus métricas.
• Comprobaciones: respuestas de sí o no, como si una cuenta sigue a otra o reposteó un post.

Los datos privados quedan fuera de esa lista. Desde junio de 2024, X muestra quién dio like a un post solo a su autor y los likes de una cuenta solo a esa cuenta, y ninguna API devuelve los likes, los marcadores ni los mensajes de otra persona; la lista completa de lo que no puedes obtener está más abajo.

La ruta hacia los datos también cambia. La API oficial de X cubre la mayoría de los 15 tipos, no tiene campos para los datos de Acerca de y cobra cada elemento que devuelve; nuestra guía de precios de la API de X lista cada tarifa.

#Obtén cada tipo de dato con Sorsa API

Para llevar un proyecto a los datos de X, usa Sorsa API: devuelve los 15 tipos a través de 45 endpoints con una sola clave API, todos los planes corren a 20 solicitudes por segundo y los precios empiezan en $0.007 por 1,000 seguidores y $0.014 por 1,000 tweets. No necesita cuenta de desarrollador de X, app ni OAuth, como explica nuestra guía de la API de Twitter sin cuenta de desarrollador.

Cada solicitud cuesta lo mismo, así que la tabla muestra cuántos elementos trae una solicitud y cuánto cuestan 1,000 elementos, junto al precio de pago por uso (se abre en una pestaña nueva) de la API oficial de X para los mismos datos. Los 45 endpoints, con sus parámetros, están en la página de endpoints de Sorsa API.

• Perfiles

  Endpoint de Sorsa API

  GET /info-batch (se abre en una pestaña nueva)

  Por solicitud

  100 perfiles

  Sorsa API, por 1,000

  desde $0.014

  API oficial de X, por 1,000

  $10.00

• Acerca de esta cuenta

  Endpoint de Sorsa API

  GET /about (se abre en una pestaña nueva)

  Por solicitud

  1 cuenta

  Sorsa API, por 1,000

  desde $1.40

  API oficial de X, por 1,000

  sin esos campos

• Seguidores, seguidos

  Endpoint de Sorsa API

  GET /followers (se abre en una pestaña nueva), GET /follows (se abre en una pestaña nueva)

  Por solicitud

  200 seguidores

  Sorsa API, por 1,000

  desde $0.007

  API oficial de X, por 1,000

  $10.00

• Posts por ID o enlace

  Endpoint de Sorsa API

  POST /tweet-info-bulk (se abre en una pestaña nueva)

  Por solicitud

  100 posts

  Sorsa API, por 1,000

  desde $0.014

  API oficial de X, por 1,000

  $5.00, más $10.00 por los autores desde el 22 de nov.

• Cronologías

  Endpoint de Sorsa API

  POST /user-tweets (se abre en una pestaña nueva)

  Por solicitud

  20 posts

  Sorsa API, por 1,000

  desde $0.07

  API oficial de X, por 1,000

  $5.00

• Respuestas, citas, reposters

  Endpoint de Sorsa API

  POST /comments (se abre en una pestaña nueva), POST /quotes (se abre en una pestaña nueva), POST /retweeters (se abre en una pestaña nueva)

  Por solicitud

  20

  Sorsa API, por 1,000

  desde $0.07

  API oficial de X, por 1,000

  $5.00 posts, $10.00 cuentas

• Búsqueda de posts

  Endpoint de Sorsa API

  POST /search-tweets (se abre en una pestaña nueva)

  Por solicitud

  20 posts

  Sorsa API, por 1,000

  desde $0.07

  API oficial de X, por 1,000

  $5.00

• Menciones

  Endpoint de Sorsa API

  POST /mentions (se abre en una pestaña nueva)

  Por solicitud

  20 posts

  Sorsa API, por 1,000

  desde $0.07

  API oficial de X, por 1,000

  $5.00

• Búsqueda de cuentas

  Endpoint de Sorsa API

  POST /search-users (se abre en una pestaña nueva)

  Por solicitud

  20 cuentas

  Sorsa API, por 1,000

  desde $0.07

  API oficial de X, por 1,000

  $10.00

• Listas

  Endpoint de Sorsa API

  GET /list-tweets (se abre en una pestaña nueva), GET /list-members (se abre en una pestaña nueva)

  Por solicitud

  20

  Sorsa API, por 1,000

  desde $0.07

  API oficial de X, por 1,000

  $5.00 posts, $10.00 miembros

• Comunidades

  Endpoint de Sorsa API

  POST /community-tweets (se abre en una pestaña nueva), POST /community-members (se abre en una pestaña nueva)

  Por solicitud

  20

  Sorsa API, por 1,000

  desde $0.07

  API oficial de X, por 1,000

  $5.00 Comunidades, luego cada post o miembro

• Spaces

  Endpoint de Sorsa API

  GET /spaces (se abre en una pestaña nueva)

  Por solicitud

  1 Space

  Sorsa API, por 1,000

  desde $1.40

  API oficial de X, por 1,000

  $5.00

• Tendencias

  Endpoint de Sorsa API

  GET /trends (se abre en una pestaña nueva)

  Por solicitud

  1 ubicación

  Sorsa API, por 1,000

  desde $1.40

  API oficial de X, por 1,000

  $10.00

• Artículos de X

  Endpoint de Sorsa API

  POST /article (se abre en una pestaña nueva)

  Por solicitud

  1 Artículo

  Sorsa API, por 1,000

  desde $1.40

  API oficial de X, por 1,000

  $5.00, leído como posts

• Comprobaciones

  Endpoint de Sorsa API

  POST /check-follow (se abre en una pestaña nueva) y 5 más

  Por solicitud

  1 respuesta

  Sorsa API, por 1,000

  desde $1.40

  API oficial de X, por 1,000

  sin llamada única: listas a $10.00

Qué datos necesita cada trabajo

La mayoría de los proyectos leen dos o tres de los 15 tipos, y cada trabajo corresponde a un conjunto corto de endpoints:

• Monitoreo de marca y palabras clave

  Datos que lee

  Búsqueda de posts, menciones

  Endpoints de Sorsa API

  POST /search-tweets, POST /mentions

• Investigación de audiencia e influencers

  Datos que lee

  Seguidores, perfiles, datos de Acerca de

  Endpoints de Sorsa API

  GET /followers, GET /info-batch, GET /about

• Seguimiento de competidores

  Datos que lee

  Cronologías, respuestas, citas

  Endpoints de Sorsa API

  POST /user-tweets, POST /comments, POST /quotes

• Datasets para investigación e IA

  Datos que lee

  Búsqueda desde 2006, posts por ID

  Endpoints de Sorsa API

  POST /search-tweets, POST /tweet-info-bulk

• Sorteos y campañas

  Datos que lee

  Comprobaciones

  Endpoints de Sorsa API

  POST /check-follow, POST /check-retweet

• Vigilar muchas cuentas o un mercado

  Datos que lee

  Listas, tendencias

  Endpoints de Sorsa API

  GET /list-tweets, GET /trends

Tu primera solicitud

Tres pasos te llevan de no tener cuenta a tu primer perfil:

1. Obtén una clave. Regístrate y copia tu clave API desde el panel. Las primeras 100 solicitudes son gratis.

2. Pide un perfil. Llama a GET /info (se abre en una pestaña nueva) con la clave en el encabezado ApiKey e indica la cuenta con exactamente uno de username, user_id o user_link.

   curl -G "https://api.sorsa.io/v3/info" \
     -H "ApiKey: YOUR_API_KEY" \
     --data-urlencode "username=orbit_data_studio"
   

   {
     "id": "1593004418823766016",
     "username": "orbit_data_studio",
     "display_name": "Orbit Data Studio",
     "description": "Charts and notes on public conversation.",
     "location": "Lisbon",
     "created_at": "2022-11-16T09:41:12Z",
     "followers_count": 18420,
     "followings_count": 312,
     "tweets_count": 4127,
     "favourites_count": 9230,
     "media_count": 688,
     "verified": false,
     "protected": false,
     "can_dm": true,
     "possibly_sensitive": false,
     "bio_urls": ["https://orbit-data.example"],
     "pinned_tweet_ids": ["1981442093318201344"],
     "profile_image_url": "https://pbs.twimg.com/profile_images/orbit.jpg"
   }
   

   Ver respuesta completa

3. Sigue el cursor en las listas. Los endpoints que devuelven listas agregan next_cursor; envíalo de vuelta con la siguiente solicitud hasta que regrese vacío. Un 401 significa una clave incorrecta, un 403 que falta la clave o que no quedan solicitudes, y un 429 más de 20 solicitudes en un segundo.

#Qué contiene un post: 22 campos y su autor

Un post de Sorsa API trae 22 campos, y el perfil completo del autor va dentro: POST /tweet-info (se abre en una pestaña nueva) devuelve un post por enlace o ID, y POST /tweet-info-bulk devuelve hasta 100 en una solicitud. Las respuestas, las citas y los reposts traen consigo el post original, también con su autor.

La API oficial de X empieza con menos. Su consulta de posts devuelve tres campos por defecto, id, text y edit_history_tweet_ids, como indica su guía de campos (se abre en una pestaña nueva); el resto requiere tweet.fields, y el autor requiere una expansión que X cobra como una lectura de usuario de $0.010 desde el 22 de noviembre de 2026, según el aviso de X (se abre en una pestaña nueva).

Aquí está cada campo, con el nombre que usa la API v2 oficial de X para lo mismo, para que el código escrito para cualquiera de las dos se pueda trasladar:

• id, created_at, lang

  Qué contiene

  El ID del post como cadena, su fecha ISO 8601 y su código de idioma

  Campo de la API v2 oficial de X

  id, created_at, lang

• full_text

  Qué contiene

  El texto completo, incluidos los posts largos

  Campo de la API v2 oficial de X

  text, o note_tweet.text para posts largos

• likes_count, retweet_count, reply_count, quote_count, bookmark_count

  Qué contiene

  Conteos de interacción en el momento de la solicitud

  Campo de la API v2 oficial de X

  public_metrics.like_count, retweet_count, reply_count, quote_count, bookmark_count

• view_count

  Qué contiene

  Vistas, que X llama impresiones

  Campo de la API v2 oficial de X

  public_metrics.impression_count

• conversation_id_str

  Qué contiene

  ID del primer post del hilo

  Campo de la API v2 oficial de X

  conversation_id

• is_reply, in_reply_to_tweet_id, in_reply_to_username

  Qué contiene

  Si es una respuesta, a qué post y a quién

  Campo de la API v2 oficial de X

  referenced_tweets, in_reply_to_user_id

• is_quote_status, quoted_status, retweeted_status

  Qué contiene

  El post citado o el original de un repost, completo

  Campo de la API v2 oficial de X

  referenced_tweets más una expansión

• entities

  Qué contiene

  Fotos, videos y enlaces: tipo, enlace, vista previa

  Campo de la API v2 oficial de X

  entities, attachments más una expansión de multimedia

• user

  Qué contiene

  El perfil completo del autor

  Campo de la API v2 oficial de X

  author_id más una expansión

• is_replies_limited, paid_partnership, made_with_ai

  Qué contiene

  Límites de respuesta y las etiquetas de X de colaboración pagada y hecho con IA

  Campo de la API v2 oficial de X

  reply_settings, paid_partnership

Para leer 100 posts a la vez, envía sus IDs o enlaces al endpoint por lotes:

import requests

URL = "https://api.sorsa.io/v3/tweet-info-bulk"
HEADERS = {"ApiKey": "YOUR_API_KEY"}

ids = ["1985274530112847105", "1985190021774452736"]  # up to 100
r = requests.post(URL, headers=HEADERS, json={"tweet_links": ids})
r.raise_for_status()
for t in r.json()["tweets"]:
    print(t["id"], t["view_count"], t["likes_count"], t["user"]["username"])

const res = await fetch("https://api.sorsa.io/v3/tweet-info-bulk", {
  method: "POST",
  headers: { ApiKey: "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ tweet_links: ["1985274530112847105"] }),
});
const { tweets } = await res.json();
for (const t of tweets) console.log(t.id, t.view_count, t.user.username);

Para tener en cuenta

Cada conteo es una instantánea. likes_count, view_count y los demás son los valores en el momento de tu solicitud y siguen creciendo después, así que guarda la hora de cada lectura antes de comparar un post con otro.

#Qué contiene un perfil, y los datos de Acerca de

Un perfil de Sorsa API tiene 19 campos, desde GET /info para una cuenta o GET /info-batch para hasta 100. GET /about agrega 7 más que X muestra solo en la página "Acerca de esta cuenta" ("About this account") de una cuenta.

• id

  Qué contiene

  El ID permanente de la cuenta, como cadena

  Campo de la API v2 oficial de X

  id

• username, display_name

  Qué contiene

  El handle sin @ y el nombre visible

  Campo de la API v2 oficial de X

  username, name

• description, bio_urls, location, created_at

  Qué contiene

  Biografía, los enlaces en ella, ubicación tal como se escribió, fecha de registro

  Campo de la API v2 oficial de X

  description, entities, location, created_at

• followers_count, followings_count, tweets_count, favourites_count, media_count

  Qué contiene

  Seguidores, seguidos, posts, posts con like, multimedia publicada

  Campo de la API v2 oficial de X

  conteos de public_metrics

• verified, protected, possibly_sensitive, can_dm

  Qué contiene

  Insignia, posts protegidos, marca de contenido sensible, abierta a mensajes directos

  Campo de la API v2 oficial de X

  verified, protected, receives_your_dm

• pinned_tweet_ids, profile_image_url, profile_background_image_url

  Qué contiene

  Posts fijados, avatar y banner

  Campo de la API v2 oficial de X

  pinned_tweet_id, profile_image_url, profile_banner_url

Los datos de Acerca de no tienen equivalente en la API oficial de X: su diccionario de datos (se abre en una pestaña nueva) no lista ningún país ni historial de nombres de usuario para un usuario. GET /about devuelve:

• country: el país que X asocia a la cuenta;
• username_change_count y last_username_change_at: cuántas veces cambió el handle y cuándo fue la última vez;
• is_blue_verified y premium_start_at: la marca de verificación de X Premium y desde cuándo;
• source y affiliate_username: el origen de la cuenta tal como lo muestra X y la cuenta detrás de su insignia de afiliación.

Para una sola cuenta, el localizador de país de cuentas de Twitter gratuito muestra el mismo país en el navegador.

Para tener en cuenta

Guarda los IDs como cadenas. Los IDs de posts y de cuentas son números de 64 bits que JavaScript redondea cuando los interpreta como números. Guarda el id de la cuenta, no el username, que su dueño puede cambiar en cualquier momento.

#Seguidores, listas de interacción y comprobaciones de sí o no

Las listas de cuentas vienen en páginas de perfiles completos. GET /followers, GET /follows y GET /verified-followers (se abre en una pestaña nueva) devuelven hasta 200 por solicitud, así que 1 millón de seguidores toma 5K solicitudes, desde $7; la guía para exportar seguidores de Twitter incluye el ciclo del cursor y el CSV.

En torno a un solo post, tres endpoints devuelven su interacción pública, 20 elementos por página:

• POST /comments: las respuestas debajo de él, ordenadas por relevancia, recencia o likes;
• POST /quotes: los posts que lo citan, cada uno con su autor;
• POST /retweeters: las cuentas que lo repostearon, las más recientes primero, como perfiles completos.

Lo que publica una cuenta sale de POST /user-tweets, con type en posts, replies o retweets. Recorre toda la cronología hacia atrás, más allá de los 3,200 posts más recientes donde se detiene el endpoint de cronologías de la API oficial de X; la guía para descargar todos los tweets de un usuario lo convierte en un archivo.

Las comprobaciones responden una pregunta por solicitud, desde $0.0014 cada una:

• POST /check-follow: si una cuenta sigue a otra;
• POST /check-retweet (se abre en una pestaña nueva): si una cuenta reposteó un post, revisando 100 reposts por solicitud;
• POST /check-quoted (se abre en una pestaña nueva): quoted, retweet o not_found;
• GET /check-comment (se abre en una pestaña nueva): si una cuenta respondió, y la propia respuesta;
• POST /check-community-member (se abre en una pestaña nueva): si una cuenta está en una Comunidad;
• GET /check-shadowban (se abre en una pestaña nueva): search ban y search suggestion ban, clean, banned o unknown, guardado en caché por una hora.

La guía de la API de verificación de Twitter las usa en un sorteo o una campaña.

#Búsqueda, Listas, Comunidades, Spaces, tendencias y Artículos

POST /search-tweets acepta cualquier consulta de la Búsqueda avanzada de X, con from:, to:, since:, until:, frases exactas y hashtags, ordenada por popular o latest, sobre el archivo desde 2006. La guía de datos históricos de Twitter explica las extracciones por rango de fechas.

POST /mentions encuentra posts que etiquetan a una cuenta y agrega filtros: min_likes, min_replies, min_retweets, y since_date y until_date en YYYY-MM-DD. POST /search-users encuentra cuentas por una palabra en su nombre, handle o biografía.

Una Lista vigila muchas cuentas a la vez: una sola solicitud a GET /list-tweets devuelve los posts más recientes de todos sus miembros, y una Lista admite hasta 5,000 cuentas. GET /list-members y GET /list-followers (se abre en una pestaña nueva) devuelven sus cuentas como perfiles.

Las Comunidades tienen cinco endpoints: POST /community-info (se abre en una pestaña nueva) (nombre, descripción, cantidad de miembros, banner, creador y hora de creación como marca de tiempo Unix), POST /community-members, POST /community-tweets y POST /community-search-tweets (se abre en una pestaña nueva) (populares o recientes), y POST /search-communities (se abre en una pestaña nueva), hasta 10 por solicitud.

GET /spaces recibe un ID o enlace de Space y devuelve su título, estado, inicio programado y creador, los participantes divididos en administradores, oradores y oyentes, sus ajustes como la repetición y los clips, y sus estadísticas: oyentes en vivo, participantes y reproducciones de la repetición. Sus horas llegan como números Unix, mientras que el resto de la API usa fechas ISO 8601.

GET /trends recibe un WOEID, el Where On Earth ID de un país o una ciudad, y devuelve el nombre, la consulta de búsqueda y el enlace de cada tendencia. POST /article devuelve un Artículo de X: texto completo, vista previa, imagen de portada, fecha de publicación, sus conteos con las vistas en views_count y el perfil del autor.

#Lo que ninguna API de Twitter devuelve

Ninguna API devuelve datos que X mantiene privados, y la API oficial de X no es la excepción. El 11 de junio de 2024, X anunció (se abre en una pestaña nueva) que sus endpoints de likes devuelven likes y quiénes los dieron solo para los posts de la propia cuenta autenticada, y un resultado vacío para todos los demás posts.

Cada fila de abajo tiene una señal pública que puedes leer en su lugar:

• Quién dio like a un post

  Por qué ninguna API los devuelve

  Privado desde junio de 2024: solo lo ve el autor del post

  Qué puedes leer en su lugar

  likes_count, más las respuestas, citas y reposters públicos

• Los likes de una cuenta

  Por qué ninguna API los devuelve

  Privados para esa cuenta desde junio de 2024

  Qué puedes leer en su lugar

  favourites_count, cuántos posts le dieron like

• Marcadores

  Por qué ninguna API los devuelve

  Privados para la cuenta que los guardó

  Qué puedes leer en su lugar

  bookmark_count en cada post

• Mensajes directos

  Por qué ninguna API los devuelve

  Privados entre sus participantes

  Qué puedes leer en su lugar

  can_dm, si la cuenta los acepta

• Posts de cuentas protegidas

  Por qué ninguna API los devuelve

  Visibles solo para seguidores aprobados

  Qué puedes leer en su lugar

  El perfil, con protected: true

• Posts eliminados

  Por qué ninguna API los devuelve

  Desaparecen de X al eliminarse

  Qué puedes leer en su lugar

  Solo las copias que guardaste antes

• Quién vio un post o un perfil

  Por qué ninguna API los devuelve

  X muestra las vistas solo como un número

  Qué puedes leer en su lugar

  view_count

• Listas de seguidores pasadas, fechas de follow

  Por qué ninguna API los devuelve

  X no guarda un historial público de quién siguió y cuándo

  Qué puedes leer en su lugar

  Exporta la lista de forma programada y compara por id

• Correo, número de teléfono

  Por qué ninguna API los devuelve

  Nunca son públicos en X

  Qué puedes leer en su lugar

  Nada

Incluso la API oficial de X lee likes, marcadores y mensajes solo de la cuenta que autorizó la app mediante OAuth, y nunca los de nadie más.

Lo que Sorsa API deja fuera a propósito

Sorsa API lee y nunca escribe: no publica, no da like, no sigue ni envía mensajes directos. Nunca pide tu inicio de sesión de X, así que tu cuenta no corre ningún riesgo; para publicar también, combínala con la API oficial de X. Funciona por solicitud, sin streaming ni webhook: los posts nuevos llegan consultando POST /search-tweets o GET /list-tweets, a 20 solicitudes por segundo en todos los planes.

#Cuánto cuesta cada tipo de dato por 1,000

Sorsa API cobra una solicitud sin importar lo que devuelva, así que el precio por 1,000 baja a medida que crecen las páginas: desde $0.007 por 1,000 seguidores (200 por página), $0.014 por 1,000 posts o perfiles consultados por ID (100 por solicitud) y $0.07 por 1,000 resultados de búsqueda (unos 20 por página). La API oficial de X cobra cada elemento: $5.00 por 1,000 posts y $10.00 por 1,000 perfiles o seguidores, y desde el 22 de noviembre el autor de cada post suma $0.010.

Las solicitudes fallidas nunca se cobran, y la API oficial de X se detiene en 3 millones de lecturas de posts al mes, a partir de lo cual X vende solo contratos Enterprise. Las 100 solicitudes gratis que recibe cada cuenta nueva cubren hasta 10K tweets o 20K seguidores.

#Lee los 15 tipos con una sola clave

Una API devuelve 15 tipos de datos públicos de X y ninguno de los privados. Para leerlos, usa Sorsa API: una clave, 45 endpoints, tweets desde $0.014 por 1,000 y seguidores desde $0.007, y 100 solicitudes gratis para empezar, sin tarjeta.

#Preguntas frecuentes