> ## 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. # Casos de uso Sorsa API ofrece acceso de solo lectura a datos públicos de X (antes Twitter): publicaciones, perfiles, redes de seguidores, métricas de interacción, comunidades y más. Aquí encontrarás los endpoints y las guías correspondientes a cada caso de uso. *** ## Escucha social y seguimiento de marca Supervisa en tiempo real qué se dice sobre tu marca, producto o sector. Detecta sentimiento negativo antes de que aumente, mide el impacto de campañas y comprende la percepción pública. **Endpoints principales:** * `/search-tweets`: busca palabras clave, hashtags o frases en publicaciones públicas. * `/mentions`: rastrea menciones de una cuenta y filtra por interacción para reducir el ruido. * `/list-tweets`: supervisa varias cuentas mediante listas de X. **Guías:** [Búsqueda de publicaciones](https://docs.sorsa.io/es/search-tweets) | [Seguimiento de menciones](https://docs.sorsa.io/es/search-mentions) | [Supervisión en tiempo real](https://docs.sorsa.io/es/real-time-monitoring) | [Operadores de búsqueda](https://docs.sorsa.io/es/search-operators) *** ## Análisis de la competencia Compara perfiles de competidores, analiza su estrategia de contenido y la composición de su audiencia, y supervisa lo que se dice sobre ellos. **Endpoints principales:** * `/info` e `/info-batch`: datos de perfiles (seguidores, publicaciones y biografía) de una o varias cuentas. * `/user-tweets`: cronología de un competidor para analizar sus contenidos y las publicaciones con mejores resultados. * `/mentions`: comentarios de usuarios sobre un competidor, filtrados por interacción. * `/followers` y `/verified-followers`: seguidores de un competidor. * `/score`: comparación de influencia en el ecosistema de criptomonedas para cuentas Web3. **Guías:** [Análisis de competidores](https://docs.sorsa.io/es/Competitor-Analysis) | [Seguidores y cuentas seguidas](https://docs.sorsa.io/es/followers-and-following) | [Sorsa Score y análisis de criptomonedas](https://docs.sorsa.io/es/sorsa-score-and-crypto-analytics) *** ## Captación de clientes potenciales y descubrimiento de audiencias Encuentra clientes potenciales, socios o miembros de una comunidad buscando perfiles, obteniendo seguidores de cuentas relevantes, consultando miembros de comunidades o identificando personas que hablan sobre temas concretos. **Endpoints principales:** * `/search-users`: encuentra cuentas por palabras clave de su biografía, como cargos, intereses o especialidades. * `/followers`: obtén seguidores de un competidor o referente del sector. * `/community-members`: consulta miembros de comunidades temáticas de X. * `/search-tweets`: encuentra personas que publican sobre problemas que resuelve tu producto. **Guías:** [Descubrimiento del público objetivo](https://docs.sorsa.io/es/target-audiences-Discovery) | [Seguidores y cuentas seguidas](https://docs.sorsa.io/es/followers-and-following) | [Listas y comunidades](https://docs.sorsa.io/es/lists-and-communities) *** ## Campañas de marketing y verificación de sorteos Organiza campañas con tareas como seguir, retuitear, comentar, citar o unirse a una comunidad. Comprueba que cada participante haya completado las acciones y automatiza la entrega de recompensas según el resultado. **Endpoints principales:** * `/check-follow`: ¿el usuario sigue tu cuenta? * `/check-retweet`: ¿ha retuiteado una publicación concreta? * `/check-comment`: ¿ha dejado un comentario? * `/check-quoted`: ¿ha citado la publicación? * `/check-community-member`: ¿se ha unido a tu comunidad? **Guía:** [Verificación de campañas de marketing](https://docs.sorsa.io/es/Marketing-Campaign-Verification) *** ## Investigación histórica y recopilación de datos Accede al archivo de publicaciones públicas desde 2006. Analiza acontecimientos pasados, crea conjuntos de entrenamiento, estudia la evolución de las conversaciones o revisa el historial de publicaciones de una marca. **Endpoints principales:** * `/search-tweets` con `since:` y `until:`: búsqueda por palabras clave en un intervalo histórico. * `/user-tweets`: recorre las páginas de la cronología de una cuenta. * `/tweet-info-bulk`: completa una lista de IDs de publicaciones con sus datos actuales de interacción. **Guías:** [Datos históricos](https://docs.sorsa.io/es/historical-data) | [Operadores de búsqueda](https://docs.sorsa.io/es/search-operators) *** ## Supervisión en tiempo real y alertas Detecta nuevas publicaciones de cuentas concretas o que coincidan con palabras clave pocos segundos después de su publicación. Envía alertas a Slack, Discord, bases de datos o webhooks propios. **Endpoints principales:** * `/list-tweets`: supervisa una lista de X de hasta 5.000 cuentas con una solicitud por ciclo. * `/user-tweets`: sigue una cuenta prioritaria. * `/search-tweets` con `order: "latest"`: supervisa una palabra clave o hashtag. * `/mentions`: detecta nuevas menciones con @. **Guía:** [Supervisión en tiempo real](https://docs.sorsa.io/es/real-time-monitoring) *** ## Análisis de publicaciones Analiza quién respondió, citó o retuiteó una publicación y qué dijo. Evalúa el alcance, identifica comentaristas destacados y compara resultados del contenido. **Endpoints principales:** * `/tweet-info` y `/tweet-info-bulk`: métricas completas de una o varias publicaciones. * `/comments`: respuestas a una publicación. * `/quotes`: publicaciones que la citan. * `/retweeters`: usuarios que la retuitearon. * `/article`: contenido completo de artículos largos de X. **Guías:** [Interacción con publicaciones](https://docs.sorsa.io/es/tweet-engagement) | [Artículos de X](https://docs.sorsa.io/es/x-articles) *** ## Geografía y demografía de la audiencia Comprende dónde se encuentra la audiencia de una cuenta. Analiza la distribución de seguidores por país para orientar anuncios, evaluar influencers o investigar nuevos mercados. **Endpoints principales:** * `/followers`: obtén la lista de seguidores. * `/about`: consulta el país asociado a cada cuenta. **Guía:** [Geografía de la audiencia](https://docs.sorsa.io/es/Audience-Geography) *** ## Análisis de criptomonedas y Web3 Evalúa la influencia de cuentas de criptomonedas con la puntuación propia de Sorsa, que mide su reconocimiento entre líderes de opinión, proyectos y fondos de capital riesgo del sector. Sigue su evolución, identifica proyectos emergentes y detecta crecimiento no orgánico. **Endpoints principales:** * `/score` y `/score-changes`: puntuación de influencia y variaciones semanales y mensuales. * `/followers-stats`: desglose por categorías (influencers, proyectos y fondos). * `/top-followers` y `/top-following`: los 20 principales por puntuación. * `/new-followers-7d` y `/new-following-7d`: actividad reciente de seguimiento entre cuentas del sector. **Guía:** [Sorsa Score y análisis de criptomonedas](https://docs.sorsa.io/es/sorsa-score-and-crypto-analytics) *** ## Datos de entrenamiento para IA y LLM Recopila grandes conjuntos de publicaciones para ajustar modelos de lenguaje, entrenar clasificadores de sentimiento o crear flujos de generación aumentada por recuperación (RAG). Sorsa devuelve JSON estructurado que puedes incorporar a tus procesos de aprendizaje automático. **Endpoints principales:** * `/search-tweets`: recopila publicaciones por tema, idioma e intervalo de fechas. * `/user-tweets`: consulta cronologías para crear corpus. * `/comments` y `/quotes`: recopila conversaciones, pares de preguntas y respuestas y debates. **Guías:** [Búsqueda de publicaciones](https://docs.sorsa.io/es/search-tweets) | [Datos históricos](https://docs.sorsa.io/es/historical-data) | [Optimización del uso de la API](https://docs.sorsa.io/es/optimizing-api-usage) *** ## Desarrollo de plataformas SaaS y de análisis Crea tu herramienta de análisis social, panel o plataforma de supervisión sobre los datos de Sorsa. El precio uniforme (una llamada equivale a una solicitud, independientemente de cuántos datos devuelva) y el límite de 20 solicitudes por segundo permiten atender a varios usuarios finales con una sola clave. **Endpoints principales:** todos los endpoints están disponibles en todos los planes. Consulta la especificación en la [referencia de la API](https://docs.sorsa.io/es/api-reference-guide). **Guías:** [Optimización del uso de la API](https://docs.sorsa.io/es/optimizing-api-usage) | [Precios](https://docs.sorsa.io/es/pricing) | [Límites de solicitudes](https://docs.sorsa.io/es/rate-limits) *** ## Encuentra el endpoint adecuado Si ya sabes qué datos necesitas, busca aquí el endpoint correspondiente: | Necesito… | Endpoint | Guía | | :--------------------------------------------- | :------------------------- | :--------------------------------------------------------------------------------------------------- | | Publicaciones con una palabra clave | `/search-tweets` | [Búsqueda de publicaciones](https://docs.sorsa.io/es/search-tweets) | | Menciones de una cuenta | `/mentions` | [Seguimiento de menciones](https://docs.sorsa.io/es/search-mentions) | | Datos de un perfil de usuario | `/info` or `/info-batch` | [Referencia de la API](https://docs.sorsa.io/es/api-reference-guide) | | Seguidores de una cuenta | `/followers` | [Seguidores y cuentas seguidas](https://docs.sorsa.io/es/followers-and-following) | | Cuentas que sigue un usuario | `/follows` | [Seguidores y cuentas seguidas](https://docs.sorsa.io/es/followers-and-following) | | Historial de publicaciones de un usuario | `/user-tweets` | [Datos históricos](https://docs.sorsa.io/es/historical-data) | | Respuestas a una publicación | `/comments` | [Interacción con publicaciones](https://docs.sorsa.io/es/tweet-engagement) | | Citas de una publicación | `/quotes` | [Interacción con publicaciones](https://docs.sorsa.io/es/tweet-engagement) | | Usuarios que retuitearon una publicación | `/retweeters` | [Interacción con publicaciones](https://docs.sorsa.io/es/tweet-engagement) | | Métricas completas de una publicación | `/tweet-info` | [Interacción con publicaciones](https://docs.sorsa.io/es/tweet-engagement) | | Métricas de 100 publicaciones a la vez | `/tweet-info-bulk` | [Optimización del uso de la API](https://docs.sorsa.io/es/optimizing-api-usage) | | Publicaciones de una lista de X | `/list-tweets` | [Listas y comunidades](https://docs.sorsa.io/es/lists-and-communities) | | Miembros de una lista de X | `/list-members` | [Listas y comunidades](https://docs.sorsa.io/es/lists-and-communities) | | Miembros de una comunidad | `/community-members` | [Listas y comunidades](https://docs.sorsa.io/es/lists-and-communities) | | Publicaciones de una comunidad | `/community-tweets` | [Listas y comunidades](https://docs.sorsa.io/es/lists-and-communities) | | Comprobar si un usuario sigue una cuenta | `/check-follow` | [Verificación de campañas](https://docs.sorsa.io/es/Marketing-Campaign-Verification) | | Comprobar si un usuario retuiteó | `/check-retweet` | [Verificación de campañas](https://docs.sorsa.io/es/Marketing-Campaign-Verification) | | Comprobar si un usuario comentó | `/check-comment` | [Verificación de campañas](https://docs.sorsa.io/es/Marketing-Campaign-Verification) | | Comprobar si un usuario citó | `/check-quoted` | [Verificación de campañas](https://docs.sorsa.io/es/Marketing-Campaign-Verification) | | Comprobar la pertenencia a una comunidad | `/check-community-member` | [Verificación de campañas](https://docs.sorsa.io/es/Marketing-Campaign-Verification) | | País de una cuenta | `/about` | [Geografía de la audiencia](https://docs.sorsa.io/es/Audience-Geography) | | Sorsa Score (influencia en criptomonedas) | `/score` | [Sorsa Score y análisis de criptomonedas](https://docs.sorsa.io/es/sorsa-score-and-crypto-analytics) | | Convertir nombre de usuario en ID | `/username-to-id` | [Conversión de IDs](https://docs.sorsa.io/es/ID-Conversion) | | Convertir ID en nombre de usuario | `/id-to-username` | [Conversión de IDs](https://docs.sorsa.io/es/ID-Conversion) | | Convertir URL de perfil en ID | `/link-to-id` | [Conversión de IDs](https://docs.sorsa.io/es/ID-Conversion) | | Estadísticas de consumo de la clave | `/key-usage-info` | [Precios](https://docs.sorsa.io/es/pricing) | | Contenido de un artículo de X | `/article` | [Artículos de X](https://docs.sorsa.io/es/x-articles) | | Usuarios con una palabra clave en la biografía | `/search-users` | [Descubrimiento del público objetivo](https://docs.sorsa.io/es/target-audiences-Discovery) | | Seguidores verificados de una cuenta | `/verified-followers` | [Seguidores y cuentas seguidas](https://docs.sorsa.io/es/followers-and-following) | | Seguidores de una lista de X | `/list-followers` | [Listas y comunidades](https://docs.sorsa.io/es/lists-and-communities) | | Buscar publicaciones dentro de una comunidad | `/community-search-tweets` | [Listas y comunidades](https://docs.sorsa.io/es/lists-and-communities) | | Desglose de seguidores por categoría | `/followers-stats` | [Sorsa Score y análisis de criptomonedas](https://docs.sorsa.io/es/sorsa-score-and-crypto-analytics) | | Evolución de la puntuación | `/score-changes` | [Sorsa Score y análisis de criptomonedas](https://docs.sorsa.io/es/sorsa-score-and-crypto-analytics) | | Principales seguidores por Sorsa Score | `/top-followers` | [Sorsa Score y análisis de criptomonedas](https://docs.sorsa.io/es/sorsa-score-and-crypto-analytics) | | Principales cuentas seguidas por Sorsa Score | `/top-following` | [Sorsa Score y análisis de criptomonedas](https://docs.sorsa.io/es/sorsa-score-and-crypto-analytics) | | Nuevos seguidores de los últimos 7 días | `/new-followers-7d` | [Sorsa Score y análisis de criptomonedas](https://docs.sorsa.io/es/sorsa-score-and-crypto-analytics) | | Nuevas cuentas seguidas de los últimos 7 días | `/new-following-7d` | [Sorsa Score y análisis de criptomonedas](https://docs.sorsa.io/es/sorsa-score-and-crypto-analytics) | *** ## ¿No sabes por dónde empezar? 1. **Obtén tu clave de API:** sigue la guía de [inicio rápido](https://docs.sorsa.io/es/quickstart). Cada cuenta incluye 100 solicitudes gratuitas, sin tarjeta y sin caducidad. 2. **Prueba una búsqueda:** pega este ejemplo en la terminal para ver datos en 10 segundos: ```bash theme={null} curl -X POST https://api.sorsa.io/v3/search-tweets \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "your topic here", "order": "popular"}' ``` 3. **Explora sin escribir código:** prueba cualquier endpoint en la interfaz de [API Playground](https://api.sorsa.io/playground). 4. **Elige una guía** de la lista anterior que corresponda a tu caso de uso. 5. **Consulta los precios:** estima el coste mensual en [Precios](https://docs.sorsa.io/es/pricing).