> ## 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. # Buscar menciones > Devuelve publicaciones que mencionan al nombre de usuario especificado. Hasta 20 resultados por página, ordenados por la fecha de la mención (las más recientes primero de forma predeterminada). Ofrece el conjunto más amplio de filtros entre los endpoints de búsqueda: mínimos de Me gusta, respuestas y reposts, además de un intervalo de fechas. También permite ordenar por `popular` o `latest`. ## OpenAPI ````yaml /openapi-es.json post /mentions openapi: 3.0.3 info: contact: {} title: API Sorsa.io version: '3.0' servers: - url: https://api.sorsa.io/v3 security: [] paths: /mentions: post: tags: - Búsqueda summary: Buscar menciones description: >- Devuelve publicaciones que mencionan al nombre de usuario especificado. Hasta 20 resultados por página, ordenados por la fecha de la mención (las más recientes primero de forma predeterminada). Ofrece el conjunto más amplio de filtros entre los endpoints de búsqueda: mínimos de Me gusta, respuestas y reposts, además de un intervalo de fechas. También permite ordenar por `popular` o `latest`. requestBody: content: application/json: schema: $ref: '#/components/schemas/search.SearchMentionsReq' description: query es obligatorio; next_cursor es opcional. required: true x-originalParamName: payload responses: '200': content: application/json: schema: $ref: '#/components/schemas/common.TweetsResponse' description: OK '400': content: application/json: schema: $ref: '#/components/schemas/handler.ErrorResponse' description: Solicitud incorrecta '401': content: application/json: schema: $ref: '#/components/schemas/handler.ErrorResponse' description: No autorizado '403': content: application/json: schema: $ref: '#/components/schemas/handler.ErrorResponse' description: Acceso prohibido '404': content: application/json: schema: $ref: '#/components/schemas/handler.ErrorResponse' description: No encontrado '429': content: application/json: schema: $ref: '#/components/schemas/handler.ErrorResponse' description: Demasiadas solicitudes '500': content: application/json: schema: $ref: '#/components/schemas/handler.ErrorResponse' description: Error interno del servidor security: - ApiKeyAuth: [] components: schemas: search.SearchMentionsReq: properties: min_likes: example: 100 type: integer min_replies: example: 100 type: integer min_retweets: example: 100 type: integer next_cursor: example: JKHSJFHADUYJKSDy2y3u123 type: string order: example: popular type: string query: example: elonmusk type: string since_date: example: '2026-01-01' type: string until_date: example: '2026-01-01' type: string type: object common.TweetsResponse: properties: next_cursor: description: >- Cursor para obtener la siguiente página de resultados. Es nulo o no aparece si no hay más páginas. type: string tweets: description: Lista de objetos de publicación. items: $ref: '#/components/schemas/common.Tweet' type: array type: object handler.ErrorResponse: properties: message: type: string type: object common.Tweet: properties: bookmark_count: description: Número de veces que la publicación se ha guardado en marcadores. example: 15 type: integer conversation_id_str: description: ID de la publicación inicial del hilo de conversación. example: '1782368585664626774' type: string created_at: description: Fecha de la publicación en formato ISO 8601. example: '2024-01-15T10:30:00Z' type: string entities: description: >- Contenido multimedia, enlaces y otras entidades integradas en la publicación. items: $ref: '#/components/schemas/common.TweetEntity' type: array full_text: description: Texto completo de la publicación. example: Hello world type: string id: description: ID único de la publicación. example: '1782368585664626774' type: string in_reply_to_tweet_id: description: >- ID de la publicación a la que responde. Es nulo si no es una respuesta. example: '1782368585664626000' type: string in_reply_to_username: description: Nombre de usuario de la cuenta a la que responde la publicación. example: username type: string is_quote_status: description: Indica si esta publicación cita otra publicación. example: false type: boolean is_replies_limited: description: Indica si el autor ha restringido las respuestas a esta publicación. example: false type: boolean is_reply: description: Indica si esta publicación responde a otra publicación. example: false type: boolean lang: description: >- Código del idioma detectado de la publicación (por ejemplo, `en`, `es`). example: en type: string likes_count: description: Número de Me gusta de la publicación. example: 200 type: integer made_with_ai: description: Indica si la publicación se creó con IA. example: false type: boolean paid_partnership: description: Indica si la publicación es una colaboración pagada. example: false type: boolean quote_count: description: Número de publicaciones con cita. example: 5 type: integer quoted_status: allOf: - $ref: '#/components/schemas/common.Tweet' description: >- Publicación original citada. Solo aparece si `is_quote_status` es true. reply_count: description: Número de respuestas a la publicación. example: 10 type: integer retweet_count: description: Número de reposts. example: 50 type: integer retweeted_status: allOf: - $ref: '#/components/schemas/common.Tweet' description: >- Publicación original que se ha reposteado. Solo aparece en los reposts. user: allOf: - $ref: '#/components/schemas/common.User' description: Autor de la publicación. view_count: description: Número de visualizaciones (impresiones). example: 10000 type: integer type: object common.TweetEntity: properties: link: description: URL directa de la entidad. example: https://t.co/example type: string preview: description: URL de la vista previa o miniatura de la entidad. example: https://pbs.twimg.com/preview type: string type: description: Tipo de entidad (por ejemplo, `photo`, `video`, `url`). example: photo type: string type: object common.User: properties: bio_urls: description: URLs encontradas en la biografía del usuario. items: type: string type: array can_dm: description: Indica si la cuenta acepta mensajes directos. example: false type: boolean created_at: description: Fecha de creación de la cuenta en formato ISO 8601. example: '2009-06-02T20:12:29Z' type: string description: description: Texto de la biografía del perfil. example: Bio text type: string display_name: description: Nombre visible del usuario. example: Elon Musk type: string favourites_count: description: Número total de publicaciones que le han gustado al usuario. example: 1200 type: integer followers_count: description: Número de cuentas que siguen a este usuario. example: 100000 type: integer followings_count: description: Número de cuentas que sigue este usuario. example: 500 type: integer id: description: ID único del usuario de Twitter/X. example: '44196397' type: string location: description: Texto de ubicación del perfil del usuario. example: Austin, TX type: string media_count: description: Número total de elementos multimedia publicados por este usuario. example: 300 type: integer pinned_tweet_ids: description: IDs de las publicaciones fijadas del usuario. items: type: string type: array possibly_sensitive: description: >- Indica si la cuenta está marcada como posible fuente de contenido sensible. example: false type: boolean profile_background_image_url: description: URL de la imagen de fondo del perfil del usuario. example: https://pbs.twimg.com/profile_banners/44196397/123 type: string profile_image_url: description: URL de la imagen de avatar del usuario. example: https://pbs.twimg.com/profile_images/123/photo.jpg type: string protected: description: >- Indica si las publicaciones de la cuenta están protegidas (son privadas). example: false type: boolean tweets_count: description: Número total de publicaciones de este usuario. example: 5000 type: integer username: description: Nombre de usuario actual en Twitter/X (sin @). example: elonmusk type: string verified: description: Indica si la cuenta tiene una insignia de verificación. example: true type: boolean type: object securitySchemes: ApiKeyAuth: in: header name: ApiKey type: apiKey ````