> ## Documentation Index > Fetch the complete documentation index at: https://docs.sorsa.io/llms.txt > Use this file to discover all available pages before exploring further. # Guía de referencia de la API # Referencia completa: todos los endpoints de Sorsa Estos son los endpoints de Sorsa API organizados por categoría. Todos utilizan la URL base `https://api.sorsa.io/v3` y el encabezado `ApiKey` para autenticarse. Cada llamada consume exactamente 1 solicitud de tu cuota. Las cuentas nuevas incluyen 100 solicitudes gratuitas para probar todos los endpoints, sin tarjeta de crédito. Pulsa **Ver referencia** junto a un endpoint para consultar parámetros, esquemas y pruebas interactivas. La pestaña **Endpoints** incluye la referencia interactiva en español. También puedes probarlos sin código en [API Playground](https://api.sorsa.io/playground). *** ## Datos de usuarios Consulta perfiles, seguidores, cuentas seguidas y metadatos de cuentas. | Endpoint | Método | Descripción | Documentación | | :-------------------- | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------- | | `/info` | GET | Perfil completo de una cuenta: biografía, contadores, verificación y avatar. Acepta `username`, `user_id` o `user_link`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/usuarios/perfil-de-usuario) | | `/info-batch` | GET | Perfiles de hasta 100 cuentas en una solicitud. Acepta `usernames[]` o `user_ids[]`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/usuarios/perfiles-de-usuario-por-lotes) | | `/about` | GET | Metadatos de la cuenta: país, número y fecha de cambios de nombre, estado y fecha de inicio de X Premium (Blue), origen de la cuenta y nombre de la cuenta afiliada. | [Ver referencia](https://docs.sorsa.io/es/api-reference/usuarios/informaci%C3%B3n-de-la-cuenta) | | `/followers` | GET | Lista paginada de seguidores con perfiles completos. Hasta 200 usuarios por página. | [Ver referencia](https://docs.sorsa.io/es/api-reference/usuarios/seguidores) | | `/follows` | GET | Lista paginada de cuentas seguidas con perfiles completos. Hasta 200 usuarios por página. | [Ver referencia](https://docs.sorsa.io/es/api-reference/usuarios/cuentas-seguidas) | | `/verified-followers` | GET | Lista paginada de seguidores verificados. | [Ver referencia](https://docs.sorsa.io/es/api-reference/usuarios/seguidores-verificados) | **Guías relacionadas:** [Seguidores y cuentas seguidas](https://docs.sorsa.io/es/followers-and-following) | [Geografía de la audiencia](https://docs.sorsa.io/es/Audience-Geography) | [Análisis de competidores](https://docs.sorsa.io/es/Competitor-Analysis) *** ## Publicaciones Obtén contenido, métricas de interacción, respuestas, citas, usuarios que retuitearon, artículos largos y tendencias. | Endpoint | Método | Descripción | Documentación | | :----------------- | :----- | :--------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------- | | `/tweet-info` | POST | Datos completos de una publicación: texto, métricas y autor. Cuerpo: `tweet_link`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/publicaciones/datos-de-la-publicaci%C3%B3n) | | `/tweet-info-bulk` | POST | Datos completos de hasta 100 publicaciones en una solicitud. Cuerpo: `tweet_links[]`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/publicaciones/datos-de-publicaciones-por-lotes) | | `/user-tweets` | POST | Cronología paginada de un usuario. Cuerpo: `user_link`, `username` o `user_id`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/publicaciones/publicaciones-del-usuario) | | `/comments` | POST | Respuestas a una publicación. Cuerpo: `tweet_link`; `order_by` opcional: `Relevance`, `Recency` o `Likes`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/publicaciones/comentarios-de-la-publicaci%C3%B3n) | | `/quotes` | POST | Citas de una publicación. Cuerpo: `tweet_link`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/publicaciones/publicaciones-con-cita) | | `/retweeters` | POST | Usuarios que retuitearon una publicación: devuelve perfiles, no publicaciones. Cuerpo: `tweet_link`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/publicaciones/usuarios-que-repostearon) | | `/article` | POST | Contenido completo de un artículo largo de X. Cuerpo: `tweet_link`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/publicaciones/datos-del-art%C3%ADculo) | | `/trends` | GET | Tendencias de una ubicación. Parámetro: `woeid` (Where On Earth IDentifier). | [Ver referencia](https://docs.sorsa.io/es/api-reference/publicaciones/tendencias) | **Guías relacionadas:** [Búsqueda de publicaciones](https://docs.sorsa.io/es/search-tweets) | [Interacción con publicaciones](https://docs.sorsa.io/es/tweet-engagement) | [Artículos de X](https://docs.sorsa.io/es/x-articles) | [Datos históricos](https://docs.sorsa.io/es/historical-data) *** ## Búsquedas Busca publicaciones, menciones y perfiles, y consulta Spaces de X. | Endpoint | Método | Descripción | Documentación | | :--------------- | :----- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------ | | `/search-tweets` | POST | Búsqueda por palabras clave con los operadores de X. Cuerpo: `query`, `order`, `next_cursor`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/b%C3%BAsqueda/buscar-publicaciones) | | `/mentions` | POST | Publicaciones que mencionan una cuenta, con filtros de interacción y fecha. Cuerpo: `query`, `order`, `min_likes`, `min_retweets`, `min_replies`, `since_date`, `until_date`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/b%C3%BAsqueda/buscar-menciones) | | `/search-users` | POST | Búsqueda por palabras clave en biografías, nombres públicos y nombres de usuario. Cuerpo: `query`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/b%C3%BAsqueda/buscar-usuarios) | | `/spaces` | GET | Datos completos de un Space de X: metadatos, creador, participantes, ajustes y estadísticas. Parámetro: `id` o `link`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/b%C3%BAsqueda/informaci%C3%B3n-de-spaces) | **Guías relacionadas:** [Búsqueda de publicaciones](https://docs.sorsa.io/es/search-tweets) | [Seguimiento de menciones](https://docs.sorsa.io/es/search-mentions) | [Operadores de búsqueda](https://docs.sorsa.io/es/search-operators) | [Descubrimiento del público objetivo](https://docs.sorsa.io/es/target-audiences-Discovery) *** ## Verificación Comprueba si un usuario siguió, retuiteó, comentó, citó o se unió a una comunidad. Estos endpoints están diseñados para verificar campañas y sorteos. | Endpoint | Método | Descripción | Documentación | | :------------------------ | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------- | | `/check-follow` | POST | Comprueba si `user_2` sigue a `user_1`: user\_1 es la cuenta seguida; user\_2, el posible seguidor. Cuerpo: un identificador por cada cuenta (`username_1`/`user_id_1`/`user_link_1` y `username_2`/`user_id_2`/`user_link_2`). | [Ver referencia](https://docs.sorsa.io/es/api-reference/verificaci%C3%B3n/comprobar-seguimiento) | | `/check-comment` | GET | Comprueba si un usuario comentó una publicación y devuelve el comentario si lo encuentra. Parámetros: `tweet_link` y `username`/`user_id`/`user_link`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/verificaci%C3%B3n/comprobar-comentario) | | `/check-retweet` | POST | Comprueba si un usuario retuiteó una publicación. Examina hasta 100 retuits por solicitud. Cuerpo: `tweet_link` e identificador del usuario. | [Ver referencia](https://docs.sorsa.io/es/api-reference/verificaci%C3%B3n/comprobar-repost) | | `/check-quoted` | POST | Comprueba si un usuario citó o retuiteó una publicación. Devuelve `status`: `quoted`, `retweet` o `not_found`. Cuerpo: `tweet_link` e identificador del usuario. | [Ver referencia](https://docs.sorsa.io/es/api-reference/verificaci%C3%B3n/comprobar-cita-o-repost) | | `/check-community-member` | POST | Comprueba si un usuario pertenece a una comunidad de X. Cuerpo: `community_id` e identificador del usuario. | [Ver referencia](https://docs.sorsa.io/es/api-reference/verificaci%C3%B3n/comprobar-pertenencia-a-una-comunidad) | | `/check-shadowban` | GET | Comprobaciones de visibilidad con resultados `clean`, `banned` o `unknown`. Parámetro: `username`. Revisa `checked_at` para conocer la antigüedad de la caché. | [Ver referencia](https://docs.sorsa.io/es/api-reference/verificaci%C3%B3n/comprobar-shadowban) | **Guía relacionada:** [Verificación de campañas de marketing](https://docs.sorsa.io/es/Marketing-Campaign-Verification) *** ## Comunidades Accede a listas de miembros, publicaciones y búsquedas dentro de comunidades de X. | Endpoint | Método | Descripción | Documentación | | :------------------------- | :----- | :--------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------- | | `/community-tweets` | POST | Publicaciones de una comunidad. Cuerpo: `community_id`, `order` (`popular` o `latest`). | [Ver referencia](https://docs.sorsa.io/es/api-reference/comunidades/publicaciones-de-la-comunidad) | | `/community-search-tweets` | POST | Busca publicaciones dentro de una comunidad. Cuerpo: `community_link`, `query`, `order`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/comunidades/buscar-publicaciones-en-una-comunidad) | | `/community-members` | POST | Lista de miembros de una comunidad con perfiles. Cuerpo: `community_link`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/comunidades/miembros-de-la-comunidad) | **Guía relacionada:** [Listas y comunidades](https://docs.sorsa.io/es/lists-and-communities) *** ## Listas Consulta los perfiles de miembros, los suscriptores y las publicaciones combinadas de listas de X. | Endpoint | Método | Descripción | Documentación | | :---------------- | :----- | :-------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------- | | `/list-members` | GET | Perfiles de las cuentas incluidas en una lista. Parámetro: `list_id`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/listas/miembros-de-la-lista) | | `/list-followers` | GET | Perfiles de usuarios que siguen una lista. Parámetro: `list_link`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/listas/seguidores-de-la-lista) | | `/list-tweets` | GET | Publicaciones recientes de los miembros de una lista. Parámetro: `list_id`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/listas/publicaciones-de-la-lista) | **Guías relacionadas:** [Listas y comunidades](https://docs.sorsa.io/es/lists-and-communities) | [Supervisión en tiempo real](https://docs.sorsa.io/es/real-time-monitoring) *** ## Sorsa Score: análisis de criptomonedas Consulta puntuaciones de influencia, categorías de seguidores y actividad reciente de seguimiento entre las cuentas de criptomonedas de la base de Sorsa. Aceptan `username`, `user_id` o `user_link`. | Endpoint | Método | Descripción | Documentación | | :------------------ | :----- | :------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------- | | `/score` | GET | Sorsa Score actual: métrica de influencia en criptomonedas. | [Ver referencia](https://docs.sorsa.io/es/api-reference/sorsa-y-cripto/sorsa-score) | | `/score-changes` | GET | Variación de la puntuación durante la última semana y el último mes. | [Ver referencia](https://docs.sorsa.io/es/api-reference/sorsa-y-cripto/variaci%C3%B3n-del-sorsa-score) | | `/followers-stats` | GET | Desglose de seguidores: influencers, proyectos y fondos de capital riesgo. | [Ver referencia](https://docs.sorsa.io/es/api-reference/sorsa-y-cripto/estad%C3%ADsticas-de-categor%C3%ADas-de-seguidores) | | `/top-followers` | GET | Los 20 principales seguidores por Sorsa Score. Cada entrada incluye su puntuación. | [Ver referencia](https://docs.sorsa.io/es/api-reference/sorsa-y-cripto/20-seguidores-con-mayor-puntuaci%C3%B3n) | | `/top-following` | GET | Las 20 principales cuentas seguidas por Sorsa Score. | [Ver referencia](https://docs.sorsa.io/es/api-reference/sorsa-y-cripto/20-cuentas-seguidas-con-mayor-puntuaci%C3%B3n) | | `/new-followers-7d` | GET | Cuentas del sector de criptomonedas que empezaron a seguir al usuario en los últimos 7 días. | [Ver referencia](https://docs.sorsa.io/es/api-reference/sorsa-y-cripto/nuevos-seguidores-en-7-d%C3%ADas) | | `/new-following-7d` | GET | Cuentas del sector que el usuario empezó a seguir en los últimos 7 días. | [Ver referencia](https://docs.sorsa.io/es/api-reference/sorsa-y-cripto/nuevas-cuentas-seguidas-en-7-d%C3%ADas) | **Guía relacionada:** [Sorsa Score y análisis de criptomonedas](https://docs.sorsa.io/es/sorsa-score-and-crypto-analytics) *** ## Utilidades técnicas Conversión de IDs y supervisión del consumo de la clave de API. | Endpoint | Método | Descripción | Documentación | | :------------------------------ | :----- | :----------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------- | | `/username-to-id/{user_handle}` | GET | Convierte un nombre de usuario en su ID permanente. | [Ver referencia](https://docs.sorsa.io/es/api-reference/utilidades/convertir-nombre-de-usuario-en-id) | | `/id-to-username/{user_id}` | GET | Convierte un ID en el nombre de usuario actual. | [Ver referencia](https://docs.sorsa.io/es/api-reference/utilidades/convertir-id-en-nombre-de-usuario) | | `/link-to-id` | GET | Extrae el ID de una URL de perfil. Parámetro: `link`. | [Ver referencia](https://docs.sorsa.io/es/api-reference/utilidades/convertir-enlace-de-perfil-en-id) | | `/key-usage-info` | GET | Consumo actual, cuota restante y fecha de caducidad del saldo. Sin parámetros. | [Ver referencia](https://docs.sorsa.io/es/api-reference/utilidades/uso-de-la-clave-de-api) | **Guías relacionadas:** [Conversión de IDs](https://docs.sorsa.io/es/ID-Conversion) | [Precios](https://docs.sorsa.io/es/pricing) *** ## Modelos de datos Dos objetos principales aparecen en la mayoría de los endpoints. Consulta todas sus variantes, tipos y casos especiales en [Formato de respuesta](https://docs.sorsa.io/es/response-format). ### Objeto User Lo devuelven `/info`, `/info-batch` y los endpoints de seguidores, cuentas seguidas y búsqueda de usuarios. También aparece dentro de cada publicación en `user`. Algunos endpoints de criptomonedas añaden `followerDate`; `/followers` y `/follows` utilizan el modelo User estándar. Consulta sus variantes en [Formato de respuesta](https://docs.sorsa.io/es/response-format). | Campo | Tipo | Descripción | | :----------------------------- | :-------- | :------------------------------------ | | `id` | string | ID permanente del usuario (Snowflake) | | `username` | string | Nombre de usuario actual | | `display_name` | string | Nombre público | | `description` | string | Biografía | | `location` | string | Ubicación indicada por el usuario | | `created_at` | string | Fecha de creación (ISO 8601) | | `followers_count` | integer | Número de seguidores | | `followings_count` | integer | Número de cuentas seguidas | | `favourites_count` | integer | Total de Me gusta dados | | `tweets_count` | integer | Total de publicaciones | | `media_count` | integer | Número de publicaciones multimedia | | `verified` | boolean | Estado de verificación | | `protected` | boolean | Cuenta protegida (privada) | | `can_dm` | boolean | Mensajes directos abiertos | | `possibly_sensitive` | boolean | Indicador de contenido sensible | | `profile_image_url` | string | URL del avatar | | `profile_background_image_url` | string | URL de la portada | | `bio_urls` | string\[] | URL extraídas de la biografía | | `pinned_tweet_ids` | string\[] | IDs de publicaciones fijadas | ### Objeto Tweet Lo devuelven `/tweet-info`, `/search-tweets`, `/user-tweets`, `/comments`, `/quotes`, `/mentions`, `/list-tweets` y los endpoints de publicaciones de comunidades. | Campo | Tipo | Descripción | | :--------------------- | :------------- | :------------------------------------------------- | | `id` | string | ID de la publicación (Snowflake) | | `full_text` | string | Texto completo | | `created_at` | string | Fecha y hora (ISO 8601) | | `lang` | string | Código de idioma | | `likes_count` | integer | Me gusta | | `retweet_count` | integer | Retuits | | `reply_count` | integer | Respuestas | | `quote_count` | integer | Citas | | `bookmark_count` | integer | Veces guardada | | `view_count` | integer | Visualizaciones | | `conversation_id_str` | string | ID del hilo o conversación | | `in_reply_to_tweet_id` | string | ID de la publicación original, si es una respuesta | | `in_reply_to_username` | string | Autor original, si es una respuesta | | `is_reply` | boolean | Indica si es una respuesta | | `is_quote_status` | boolean | Indica si es una cita | | `is_replies_limited` | boolean | Respuestas restringidas por el autor | | `made_with_ai` | boolean | Etiquetada como creada con IA | | `paid_partnership` | boolean | Colaboración pagada (contenido de marca) | | `user` | User | Perfil completo del autor | | `entities` | TweetEntity\[] | Archivos multimedia y enlaces adjuntos | | `quoted_status` | Tweet | Publicación citada anidada, si corresponde | | `retweeted_status` | Tweet | Publicación retuiteada anidada, si corresponde | ### Objeto TweetEntity | Campo | Tipo | Descripción | | :-------- | :----- | :----------------------------------------- | | `type` | string | Tipo de elemento: `photo`, `video` o `url` | | `link` | string | Enlace directo (URL t.co) | | `preview` | string | URL de la vista previa o miniatura | *** ## Patrones comunes **Autenticación:** todas las solicitudes requieren `ApiKey`. Consulta [Autenticación](https://docs.sorsa.io/es/authentication). **Paginación:** los endpoints paginados utilizan cursores. Las consultas por lotes y listas de criptomonedas como `/top-followers` no los usan. Envía el `next_cursor` de la respuesta anterior para obtener la siguiente página. Si falta o es nulo, has llegado al final. Consulta [Paginación](https://docs.sorsa.io/es/pagination). **Formato de error:** los endpoints devuelven `{ "message": "..." }` para errores `400`, `401`, `403`, `404`, `429` y `500`. Consulta [Códigos de error](https://docs.sorsa.io/es/error-codes). **Límite de frecuencia:** 20 solicitudes por segundo en todos los planes estándar. Consulta [Límites de solicitudes](https://docs.sorsa.io/es/rate-limits). **Flexibilidad de entrada:** la mayoría de los endpoints de usuarios aceptan `username`, `user_id` o `user_link` (URL del perfil). Proporciona exactamente uno. *** ## Próximos pasos * [Inicio rápido](https://docs.sorsa.io/es/quickstart): realiza tu primera llamada en menos de un minuto. * [Formato de respuesta](https://docs.sorsa.io/es/response-format): tipos, valores nulos y esquemas de objetos. * [Operadores de búsqueda](https://docs.sorsa.io/es/search-operators): consultas avanzadas para `/search-tweets`. * [Optimización del uso de la API](https://docs.sorsa.io/es/optimizing-api-usage): reduce solicitudes con lotes, deduplicación y caché.