> ## 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.

# Publicaciones de la comunidad

> Devuelve un feed paginado de publicaciones de la comunidad de Twitter/X especificada. Hasta 20 publicaciones por página. Cada publicación incluye texto, fecha de creación, métricas de interacción y perfil del autor. Los resultados se pueden ordenar por `popular` o `latest` (predeterminado: `latest`).



## OpenAPI

````yaml /openapi-es.json post /community-tweets
openapi: 3.0.3
info:
  contact: {}
  title: API Sorsa.io
  version: '3.0'
servers:
  - url: https://api.sorsa.io/v3
security: []
paths:
  /community-tweets:
    post:
      tags:
        - Comunidades
      summary: Publicaciones de la comunidad
      description: >-
        Devuelve un feed paginado de publicaciones de la comunidad de Twitter/X
        especificada. Hasta 20 publicaciones por página. Cada publicación
        incluye texto, fecha de creación, métricas de interacción y perfil del
        autor. Los resultados se pueden ordenar por `popular` o `latest`
        (predeterminado: `latest`).
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/community.CommunityTweetsReq'
        description: community_id es obligatorio; next_cursor y order son opcionales.
        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:
    community.CommunityTweetsReq:
      properties:
        community_id:
          description: ID numérico de la comunidad.
          example: '1966045657589813686'
          type: string
        next_cursor:
          description: Cursor de paginación de una respuesta anterior.
          example: '123'
          type: string
        order:
          description: 'Orden: `popular` o `latest`. El valor predeterminado es `latest`.'
          example: popular
          type: string
      required:
        - community_id
      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

````