> ## Documentation Index > Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Obtener Spaces por id > Obtiene los detalles de varios Espacios por sus id. ## OpenAPI ````yaml /es/openapi.json GET /2/spaces openapi: 3.0.0 info: description: Endpoints disponibles en X API v2 version: '2.157' title: X API v2 termsOfService: https://developer.x.com/en/developer-terms/agreement-and-policy.html contact: name: X Developers url: https://developer.x.com/ license: name: X Developer Agreement and Policy url: https://developer.x.com/en/developer-terms/agreement-and-policy.html servers: - description: X API url: https://api.x.com security: [] tags: - name: Account Activity description: Endpoints para recuperar y administrar suscripciones AAA externalDocs: description: Más información url: >- https://docs.x.com/x-api/enterprise-gnip-2.0/fundamentals/account-activity - name: Bookmarks description: >- Endpoints relacionados con la recuperación y gestión de los marcadores de un usuario externalDocs: description: Más información url: https://developer.twitter.com/en/docs/twitter-api/bookmarks - name: Compliance description: >- Endpoints relacionados con garantizar que los datos de X en tus sistemas cumplan la normativa externalDocs: description: Más información url: >- https://developer.twitter.com/en/docs/twitter-api/compliance/batch-tweet/introduction - name: Connections description: Endpoints relacionados con conexiones de streaming externalDocs: description: Más información url: https://developer.x.com/en/docs/x-api/connections - name: Direct Messages description: Endpoints relacionados con la recuperación y gestión de Mensajes Directos externalDocs: description: Más información url: https://developer.twitter.com/en/docs/twitter-api/direct-messages - name: General description: Endpoints diversos para la funcionalidad general de la API externalDocs: description: Más información url: https://developer.twitter.com/en/docs/twitter-api - name: Lists description: Endpoints relacionados con la obtención y gestión de Listas externalDocs: description: Más información url: https://developer.twitter.com/en/docs/twitter-api/lists - name: Media description: Endpoints relacionados con Media externalDocs: description: Más información url: https://developer.x.com - name: MediaUpload description: Endpoints relacionados con la carga de Media externalDocs: description: Más información url: https://developer.x.com - name: News description: Endpoint para obtener noticias externalDocs: description: Más información url: https://developer.twitter.com/en/docs/twitter-api/news - name: Spaces description: Endpoints relacionados con la obtención y gestión de Spaces externalDocs: description: Más información url: https://developer.twitter.com/en/docs/twitter-api/spaces - name: Stream description: Endpoints relacionados con la transmisión en tiempo real externalDocs: description: Más información url: https://developer.x.com - name: Tweets description: Endpoints relacionados con la obtención, búsqueda y modificación de Tweets externalDocs: description: Más información url: https://developer.twitter.com/en/docs/twitter-api/tweets/lookup - name: Users description: >- Endpoints relacionados con la obtención y gestión de relaciones entre usuarios externalDocs: description: Más información url: https://developer.twitter.com/en/docs/twitter-api/users/lookup paths: /2/spaces: get: tags: - Spaces summary: Obtener Spaces por id description: Obtiene los detalles de varios Espacios por sus id. operationId: getSpacesByIds parameters: - name: ids in: query description: La lista de id de Espacios que se devolverán. required: true schema: type: array minItems: 1 maxItems: 100 items: type: string description: El identificador único de este Espacio. pattern: ^[a-zA-Z0-9]{1,13}$ example: 1SLjjRYNejbKM style: form - $ref: '#/components/parameters/SpaceFieldsParameter' - $ref: '#/components/parameters/SpaceExpansionsParameter' - $ref: '#/components/parameters/UserFieldsParameter' - $ref: '#/components/parameters/TopicFieldsParameter' responses: '200': description: La solicitud se ha realizado correctamente. content: application/json: schema: $ref: '#/components/schemas/Get2SpacesResponse' default: description: La solicitud ha fallado. content: application/json: schema: $ref: '#/components/schemas/Error' application/problem+json: schema: $ref: '#/components/schemas/Problem' security: - BearerToken: [] - OAuth2UserToken: - space.read - tweet.read - users.read externalDocs: url: >- https://developer.twitter.com/en/docs/twitter-api/spaces/lookup/api-reference/get-spaces components: parameters: SpaceFieldsParameter: name: space.fields in: query description: Una lista de campos de Space, separados por comas, que se mostrarán. required: false schema: type: array description: Los campos disponibles para un objeto Space. minItems: 1 uniqueItems: true items: type: string enum: - created_at - creator_id - ended_at - host_ids - id - invited_user_ids - is_ticketed - lang - participant_count - scheduled_start - speaker_ids - started_at - state - subscriber_count - title - topic_ids - updated_at example: - created_at - creator_id - ended_at - host_ids - id - invited_user_ids - is_ticketed - lang - participant_count - scheduled_start - speaker_ids - started_at - state - subscriber_count - title - topic_ids - updated_at explode: false style: form SpaceExpansionsParameter: name: expansions in: query description: Una lista, separada por comas, de campos que se van a expandir. schema: type: array description: >- La lista de campos que puedes ampliar para un objeto [Space](#Space). Si el campo contiene un ID, puede ampliarse a un objeto completo. minItems: 1 uniqueItems: true items: type: string enum: - creator_id - host_ids - invited_user_ids - speaker_ids - topic_ids example: - creator_id - host_ids - invited_user_ids - speaker_ids - topic_ids explode: false style: form UserFieldsParameter: name: user.fields in: query description: Una lista separada por comas de campos de User que se deben devolver. required: false schema: type: array description: Los campos disponibles para un objeto User. minItems: 1 uniqueItems: true items: type: string enum: - affiliation - confirmed_email - connection_status - created_at - description - entities - id - is_identity_verified - location - most_recent_tweet_id - name - parody - pinned_tweet_id - profile_banner_url - profile_image_url - protected - public_metrics - receives_your_dm - subscription - subscription_type - url - username - verified - verified_followers_count - verified_type - withheld example: - affiliation - confirmed_email - connection_status - created_at - description - entities - id - is_identity_verified - location - most_recent_tweet_id - name - parody - pinned_tweet_id - profile_banner_url - profile_image_url - protected - public_metrics - receives_your_dm - subscription - subscription_type - url - username - verified - verified_followers_count - verified_type - withheld explode: false style: form TopicFieldsParameter: name: topic.fields in: query description: Una lista de campos de Topic, separados por comas, que se mostrarán. required: false schema: type: array description: Los campos disponibles para un objeto Topic. minItems: 1 uniqueItems: true items: type: string enum: - description - id - name example: - description - id - name explode: false style: form schemas: Get2SpacesResponse: type: object properties: data: type: array minItems: 1 items: $ref: '#/components/schemas/Space' errors: type: array minItems: 1 items: $ref: '#/components/schemas/Problem' includes: $ref: '#/components/schemas/Expansions' Error: type: object required: - code - message properties: code: type: integer format: int32 message: type: string Problem: type: object description: >- Un objeto HTTP Problem Details, tal como se define en el IETF RFC 7807 (https://tools.ietf.org/html/rfc7807). required: - type - title properties: detail: type: string status: type: integer title: type: string type: type: string discriminator: propertyName: type mapping: about:blank: $ref: '#/components/schemas/GenericProblem' https://api.twitter.com/2/problems/client-disconnected: $ref: '#/components/schemas/ClientDisconnectedProblem' https://api.twitter.com/2/problems/client-forbidden: $ref: '#/components/schemas/ClientForbiddenProblem' https://api.twitter.com/2/problems/conflict: $ref: '#/components/schemas/ConflictProblem' https://api.twitter.com/2/problems/disallowed-resource: $ref: '#/components/schemas/DisallowedResourceProblem' https://api.twitter.com/2/problems/duplicate-rules: $ref: '#/components/schemas/DuplicateRuleProblem' https://api.twitter.com/2/problems/invalid-request: $ref: '#/components/schemas/InvalidRequestProblem' https://api.twitter.com/2/problems/invalid-rules: $ref: '#/components/schemas/InvalidRuleProblem' https://api.twitter.com/2/problems/noncompliant-rules: $ref: '#/components/schemas/NonCompliantRulesProblem' https://api.twitter.com/2/problems/not-authorized-for-field: $ref: '#/components/schemas/FieldUnauthorizedProblem' https://api.twitter.com/2/problems/not-authorized-for-resource: $ref: '#/components/schemas/ResourceUnauthorizedProblem' https://api.twitter.com/2/problems/operational-disconnect: $ref: '#/components/schemas/OperationalDisconnectProblem' https://api.twitter.com/2/problems/resource-not-found: $ref: '#/components/schemas/ResourceNotFoundProblem' https://api.twitter.com/2/problems/resource-unavailable: $ref: '#/components/schemas/ResourceUnavailableProblem' https://api.twitter.com/2/problems/rule-cap: $ref: '#/components/schemas/RulesCapProblem' https://api.twitter.com/2/problems/streaming-connection: $ref: '#/components/schemas/ConnectionExceptionProblem' https://api.twitter.com/2/problems/unsupported-authentication: $ref: '#/components/schemas/UnsupportedAuthenticationProblem' https://api.twitter.com/2/problems/usage-capped: $ref: '#/components/schemas/UsageCapExceededProblem' Space: type: object description: '' required: - id - state properties: created_at: type: string description: Hora de creación del Space. format: date-time example: '2021-07-06T18:40:40.000Z' creator_id: $ref: '#/components/schemas/UserId' ended_at: type: string description: Hora de finalización del Space. format: date-time example: '2021-07-06T18:40:40.000Z' host_ids: type: array description: Los id de usuario de los anfitriones del Space. items: $ref: '#/components/schemas/UserId' id: $ref: '#/components/schemas/SpaceId' invited_user_ids: type: array description: >- Un array de id de usuario de las personas que fueron invitadas a un Space. items: $ref: '#/components/schemas/UserId' is_ticketed: type: boolean description: Indica si el Space es un Space con entradas. example: 'false' lang: type: string description: El idioma del Space. example: en participant_count: type: integer description: El número de participantes en un Space. format: int32 example: 10 scheduled_start: type: string description: >- Una marca de tiempo de fecha y hora que indica cuándo está programado que comience un Space. format: date-time example: '2021-07-06T18:40:40.000Z' speaker_ids: type: array description: >- Un array de id de usuario de las personas que fueron oradores en un Space. items: $ref: '#/components/schemas/UserId' started_at: type: string description: Cuándo se inició el Space, como una cadena de fecha. format: date-time example: '2021-7-14T04:35:55Z' state: type: string description: El estado actual del Space. enum: - live - scheduled - ended example: live subscriber_count: type: integer description: >- La cantidad de personas que han comprado una entrada o han configurado un recordatorio para este Space. format: int32 example: 10 title: type: string description: El título del Space. example: Spaces are Awesome topics: type: array description: Los temas de un Space, según los seleccionados por su creador. items: type: object description: El objeto X Topic. required: - id - name properties: description: type: string description: La descripción del tema indicado. id: type: string description: Un identificador adecuado para su uso en la API REST. name: type: string description: El nombre del tema indicado. example: description: Todo sobre tecnología id: '848920371311001600' name: Technology updated_at: type: string description: Cuándo se actualizó por última vez el Space. format: date-time example: '2021-7-14T04:35:55Z' Expansions: type: object properties: media: type: array minItems: 1 items: $ref: '#/components/schemas/Media' places: type: array minItems: 1 items: $ref: '#/components/schemas/Place' polls: type: array minItems: 1 items: $ref: '#/components/schemas/Poll' topics: type: array minItems: 1 items: $ref: '#/components/schemas/Topic' tweets: type: array minItems: 1 items: $ref: '#/components/schemas/Tweet' users: type: array minItems: 1 items: $ref: '#/components/schemas/User' GenericProblem: description: >- Un problema genérico sin información adicional aparte de la proporcionada por el código de estado HTTP. allOf: - $ref: '#/components/schemas/Problem' ClientDisconnectedProblem: description: Tu cliente se ha desconectado. allOf: - $ref: '#/components/schemas/Problem' ClientForbiddenProblem: description: >- Un Problem que indica que tu cliente no tiene permiso para realizar esta solicitud. allOf: - $ref: '#/components/schemas/Problem' - type: object properties: reason: type: string enum: - official-client-forbidden - client-not-enrolled registration_url: type: string format: uri ConflictProblem: description: No puedes crear un nuevo trabajo si ya hay uno en ejecución. allOf: - $ref: '#/components/schemas/Problem' DisallowedResourceProblem: description: >- Un Problem que indica que el recurso solicitado infringe las normas de esta API. allOf: - $ref: '#/components/schemas/Problem' - type: object required: - resource_id - resource_type - section properties: resource_id: type: string resource_type: type: string enum: - user - tweet - media - list - space section: type: string enum: - data - includes DuplicateRuleProblem: description: La regla enviada es un duplicado. allOf: - $ref: '#/components/schemas/Problem' - type: object properties: id: type: string value: type: string InvalidRequestProblem: description: Un problema que indica que esta solicitud no es válida. allOf: - $ref: '#/components/schemas/Problem' - type: object properties: errors: type: array minItems: 1 items: type: object properties: message: type: string parameters: type: object additionalProperties: type: array items: type: string InvalidRuleProblem: description: La regla que has enviado no es válida. allOf: - $ref: '#/components/schemas/Problem' NonCompliantRulesProblem: description: >- Un Problem que indica que el conjunto de reglas del usuario no cumple las normas. allOf: - $ref: '#/components/schemas/Problem' FieldUnauthorizedProblem: description: >- Un Problem que indica que no tienes permiso para ver un campo específico de un Tweet, un usuario, etc. allOf: - $ref: '#/components/schemas/Problem' - type: object required: - resource_type - field - section properties: field: type: string resource_type: type: string enum: - user - tweet - media - list - space section: type: string enum: - data - includes ResourceUnauthorizedProblem: description: >- Un problema que indica que no tienes permiso para ver un Tweet, un usuario, etc. específicos. allOf: - $ref: '#/components/schemas/Problem' - type: object required: - value - resource_id - resource_type - section - parameter properties: parameter: type: string resource_id: type: string resource_type: type: string enum: - user - tweet - media - list - space section: type: string enum: - data - includes value: type: string OperationalDisconnectProblem: description: Se te ha desconectado por motivos operativos. allOf: - $ref: '#/components/schemas/Problem' - type: object properties: disconnect_type: type: string enum: - OperationalDisconnect - UpstreamOperationalDisconnect - ForceDisconnect - UpstreamUncleanDisconnect - SlowReader - InternalError - ClientApplicationStateDegraded - InvalidRules ResourceNotFoundProblem: description: Un objeto Problem que indica que un Tweet, un usuario, etc., no existe. allOf: - $ref: '#/components/schemas/Problem' - type: object required: - parameter - value - resource_id - resource_type properties: parameter: type: string minLength: 1 resource_id: type: string resource_type: type: string enum: - user - tweet - media - list - space value: type: string description: El valor coincidirá con el esquema definido para el campo. ResourceUnavailableProblem: description: >- Un problema que indica que un Tweet, un usuario, etc. específicos no están disponibles para ti. allOf: - $ref: '#/components/schemas/Problem' - type: object required: - parameter - resource_id - resource_type properties: parameter: type: string minLength: 1 resource_id: type: string resource_type: type: string enum: - user - tweet - media - list - space RulesCapProblem: description: Has excedido el número máximo de reglas permitido. allOf: - $ref: '#/components/schemas/Problem' ConnectionExceptionProblem: description: Un Problem que indica que algo va mal con la conexión. allOf: - $ref: '#/components/schemas/Problem' - type: object properties: connection_issue: type: string enum: - TooManyConnections - ProvisioningSubscription - RuleConfigurationIssue - RulesInvalidIssue UnsupportedAuthenticationProblem: description: Un Problem que indica que la autenticación utilizada no es compatible. allOf: - $ref: '#/components/schemas/Problem' UsageCapExceededProblem: description: Un problema que indica que se ha superado un límite de uso. allOf: - $ref: '#/components/schemas/Problem' - type: object properties: period: type: string enum: - Daily - Monthly scope: type: string enum: - Account - Product UserId: type: string description: >- Identificador único de este usuario. Se devuelve como una cadena para evitar complicaciones con lenguajes de programación y herramientas que no pueden manejar números enteros grandes. pattern: ^[0-9]{1,19}$ example: '2244994945' SpaceId: type: string description: El identificador único de este Space. pattern: ^[a-zA-Z0-9]{1,13}$ example: 1SLjjRYNejbKM Media: type: object required: - type properties: height: $ref: '#/components/schemas/MediaHeight' media_key: $ref: '#/components/schemas/MediaKey' type: type: string width: $ref: '#/components/schemas/MediaWidth' discriminator: propertyName: type mapping: animated_gif: $ref: '#/components/schemas/AnimatedGif' photo: $ref: '#/components/schemas/Photo' video: $ref: '#/components/schemas/Video' Place: type: object required: - id - full_name properties: contained_within: type: array minItems: 1 items: $ref: '#/components/schemas/PlaceId' country: type: string description: Nombre completo del condado en el que se encuentra este lugar. example: United States country_code: $ref: '#/components/schemas/CountryCode' full_name: type: string description: Nombre completo de este lugar. example: Lakewood, CO geo: $ref: '#/components/schemas/Geo' id: $ref: '#/components/schemas/PlaceId' name: type: string description: El nombre legible por humanos de este lugar. example: Lakewood place_type: $ref: '#/components/schemas/PlaceType' Poll: type: object description: Representa una encuesta (objeto Poll) adjunta a un Tweet. required: - id - options properties: duration_minutes: type: integer minimum: 5 maximum: 10080 format: int32 end_datetime: type: string format: date-time id: $ref: '#/components/schemas/PollId' options: type: array minItems: 2 maxItems: 4 items: $ref: '#/components/schemas/PollOption' voting_status: type: string enum: - open - closed Topic: type: object description: El tema de un Space, según lo seleccionado por su creador. required: - id - name properties: description: type: string description: Descripción del tema indicado. example: All about technology id: $ref: '#/components/schemas/TopicId' name: type: string description: Nombre del tema indicado. example: Technology Tweet: type: object properties: attachments: type: object description: >- Especifica el tipo de archivos adjuntos (si los hay) presentes en este Tweet. properties: media_keys: type: array description: >- Una lista de media keys para cada uno de los archivos multimedia adjuntos (si hay medios adjuntos). minItems: 1 items: $ref: '#/components/schemas/MediaKey' media_source_tweet_id: type: array description: >- Una lista de Publicaciones en las que se publicó originalmente el contenido multimedia de este Tweet. Por ejemplo, si el contenido multimedia de un Tweet se reutiliza en otro Tweet, esto hace referencia al Tweet original de origen. minItems: 1 items: $ref: '#/components/schemas/TweetId' poll_ids: type: array description: Una lista de IDs de encuestas (si hay encuestas adjuntas). minItems: 1 items: $ref: '#/components/schemas/PollId' author_id: $ref: '#/components/schemas/UserId' community_id: $ref: '#/components/schemas/CommunityId' context_annotations: type: array minItems: 1 items: $ref: '#/components/schemas/ContextAnnotation' conversation_id: $ref: '#/components/schemas/TweetId' created_at: type: string description: Fecha y hora de creación del Tweet. format: date-time example: '2021-01-06T18:40:40.000Z' display_text_range: $ref: '#/components/schemas/DisplayTextRange' edit_controls: type: object required: - is_edit_eligible - editable_until - edits_remaining properties: editable_until: type: string description: Fecha y hora en que el Tweet deja de ser editable. format: date-time example: '2021-01-06T18:40:40.000Z' edits_remaining: type: integer description: Número de veces que este Tweet puede editarse. is_edit_eligible: type: boolean description: Indica si este Tweet se puede editar. example: false edit_history_tweet_ids: type: array description: Una lista de identificadores de Tweet en esta cadena de Tweets. minItems: 1 items: $ref: '#/components/schemas/TweetId' entities: $ref: '#/components/schemas/FullTextEntities' geo: type: object description: La ubicación etiquetada en el Tweet, si el usuario la proporcionó. properties: coordinates: $ref: '#/components/schemas/Point' place_id: $ref: '#/components/schemas/PlaceId' id: $ref: '#/components/schemas/TweetId' in_reply_to_user_id: $ref: '#/components/schemas/UserId' lang: type: string description: >- Idioma del Tweet, si es detectado por X. Se devuelve como una etiqueta de idioma BCP 47. example: en non_public_metrics: type: object description: >- Métricas de interacción no públicas del Tweet en el momento de la solicitud. properties: impression_count: type: integer description: Número de veces que se ha visto este Tweet. format: int32 note_tweet: type: object description: >- El contenido completo del Tweet, incluido cualquier texto que exceda los 280 caracteres. properties: entities: type: object properties: cashtags: type: array minItems: 1 items: $ref: '#/components/schemas/CashtagEntity' hashtags: type: array minItems: 1 items: $ref: '#/components/schemas/HashtagEntity' mentions: type: array minItems: 1 items: $ref: '#/components/schemas/MentionEntity' urls: type: array minItems: 1 items: $ref: '#/components/schemas/UrlEntity' text: $ref: '#/components/schemas/NoteTweetText' organic_metrics: type: object description: >- Métricas orgánicas de interacción del Tweet que no son públicas en el momento de la solicitud. required: - impression_count - retweet_count - reply_count - like_count properties: impression_count: type: integer description: Número de veces que se ha visto este Tweet. like_count: type: integer description: Número de veces que se ha indicado que gusta este Tweet. reply_count: type: integer description: Número de veces que se ha respondido a este Tweet. retweet_count: type: integer description: Número de veces que se ha hecho Retweet de este Tweet. possibly_sensitive: type: boolean description: >- Indica si este Tweet contiene URL marcadas como sensibles, por ejemplo, contenido apto solo para audiencias adultas. example: false promoted_metrics: type: object description: >- Métricas de interacción promocionadas no públicas del Tweet en el momento de la solicitud. properties: impression_count: type: integer description: Número de veces que se ha visto este Tweet. format: int32 like_count: type: integer description: Número de veces que se ha indicado que les gusta este Tweet. format: int32 reply_count: type: integer description: Número de veces que se ha respondido a este Tweet. format: int32 retweet_count: type: integer description: Número de veces que este Tweet se ha retuiteado. format: int32 public_metrics: type: object description: Métricas de interacción del Tweet en el momento de la solicitud. required: - retweet_count - reply_count - like_count - impression_count - bookmark_count properties: bookmark_count: type: integer description: Número de veces que este Tweet se ha añadido a marcadores. format: int32 impression_count: type: integer description: Número de veces que se ha visto este Tweet. format: int32 like_count: type: integer description: Número de veces que se ha indicado que les gusta este Tweet. quote_count: type: integer description: Número de veces que se ha citado este Tweet. reply_count: type: integer description: Número de veces que se ha respondido a este Tweet. retweet_count: type: integer description: Número de veces que se ha retuiteado este Tweet. referenced_tweets: type: array description: >- Una lista de Publicaciones a las que hace referencia este Tweet. Por ejemplo, si el Tweet principal es un Retweet, un Tweet citado o una respuesta, incluirá el Tweet relacionado al que hace referencia ese Tweet principal. minItems: 1 items: type: object required: - type - id properties: id: $ref: '#/components/schemas/TweetId' type: type: string enum: - retweeted - quoted - replied_to reply_settings: $ref: '#/components/schemas/ReplySettingsWithVerifiedUsers' scopes: type: object description: Ámbitos (scopes) de este Tweet. properties: followers: type: boolean description: >- Indica si este Tweet es visible para los seguidores sin disponer del id del Tweet. example: false source: type: string description: Esto está en desuso. suggested_source_links: type: array minItems: 0 items: $ref: '#/components/schemas/UrlEntity' suggested_source_links_with_counts: type: object description: >- Enlaces de origen sugeridos y número de solicitudes que incluyeron cada enlace. properties: count: type: integer description: >- Número de solicitudes de notas que incluyeron el enlace de origen. url: $ref: '#/components/schemas/UrlEntity' text: $ref: '#/components/schemas/TweetText' username: $ref: '#/components/schemas/UserName' withheld: $ref: '#/components/schemas/TweetWithheld' example: author_id: '2244994945' created_at: Wed Jan 06 18:40:40 +0000 2021 id: '1346889436626259968' text: >- Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\u2026 https:\/\/t.co\/56a0vZUx7i username: XDevelopers User: type: object description: Objeto de usuario de X. required: - id - name - username properties: affiliation: type: object description: Metadatos sobre la afiliación de un usuario. properties: badge_url: type: string description: URL de la insignia correspondiente a la afiliación. format: uri description: type: string description: Descripción de la afiliación. url: type: string description: URL, si está disponible, con detalles sobre una afiliación. format: uri user_id: type: array minItems: 1 items: $ref: '#/components/schemas/UserId' connection_status: type: array description: Devuelve información detallada sobre la relación entre dos usuarios. minItems: 0 items: type: string description: Tipo de conexión entre usuarios. enum: - follow_request_received - follow_request_sent - blocking - followed_by - following - muting created_at: type: string description: Momento de creación de este usuario. format: date-time description: type: string description: >- El texto de la descripción del perfil de este Usuario (también llamado biografía), si el Usuario proporcionó una. entities: type: object description: >- Una lista de metadatos detectados en la descripción del perfil del Usuario. properties: description: $ref: '#/components/schemas/FullTextEntities' url: type: object description: >- Detalles ampliados de la URL especificada en el perfil del Usuario, con índices de inicio y fin. properties: urls: type: array minItems: 1 items: $ref: '#/components/schemas/UrlEntity' id: $ref: '#/components/schemas/UserId' location: type: string description: >- La ubicación especificada en el perfil del Usuario, si el Usuario proporcionó una. Como se trata de un valor de texto libre, puede que no indique una ubicación válida, pero puede evaluarse de forma aproximada al realizar búsquedas con consultas de ubicación. most_recent_tweet_id: $ref: '#/components/schemas/TweetId' name: type: string description: >- El nombre para mostrar de este Usuario, tal como aparece en su perfil. pinned_tweet_id: $ref: '#/components/schemas/TweetId' profile_banner_url: type: string description: La URL del banner de perfil de este Usuario. format: uri profile_image_url: type: string description: La URL de la imagen de perfil de este Usuario. format: uri protected: type: boolean description: >- Indica si este Usuario ha decidido proteger sus Publicaciones (es decir, si las Publicaciones de este Usuario son privadas). public_metrics: type: object description: Una lista de métricas de este Usuario. required: - followers_count - following_count - tweet_count - listed_count properties: followers_count: type: integer description: Número de Usuarios que siguen a este Usuario. following_count: type: integer description: Número de Usuarios a los que este Usuario sigue. like_count: type: integer description: El número de Me gusta creados por este Usuario. listed_count: type: integer description: El número de Listas que incluyen a este Usuario. tweet_count: type: integer description: >- Número de Publicaciones (incluidos los Retweets) creadas por este usuario. receives_your_dm: type: boolean description: Indica si puedes enviarle un DM a este usuario. subscription_type: type: string description: >- El type de suscripción a X Blue del usuario, por ejemplo: Basic, Premium, PremiumPlus o None. enum: - Basic - Premium - PremiumPlus - None url: type: string description: La URL especificada en el perfil del usuario. username: $ref: '#/components/schemas/UserName' verified: type: boolean description: Indica si este usuario es un usuario verificado de X. verified_type: type: string description: >- El type de verificación de X Blue del usuario, por ejemplo: blue, government, business o none. enum: - blue - government - business - none withheld: $ref: '#/components/schemas/UserWithheld' example: created_at: '2013-12-14T04:35:55Z' id: '2244994945' name: X Dev protected: false username: TwitterDev MediaHeight: type: integer description: La altura del contenido multimedia en píxeles. minimum: 0 MediaKey: type: string description: El identificador Media Key para este archivo adjunto. pattern: ^([0-9]+)_([0-9]+)$ MediaWidth: type: integer description: El ancho del contenido multimedia en píxeles. minimum: 0 AnimatedGif: allOf: - $ref: '#/components/schemas/Media' - type: object properties: preview_image_url: type: string format: uri variants: $ref: '#/components/schemas/Variants' Photo: allOf: - $ref: '#/components/schemas/Media' - type: object properties: alt_text: type: string url: type: string format: uri Video: allOf: - $ref: '#/components/schemas/Media' - type: object properties: duration_ms: type: integer non_public_metrics: type: object description: >- Métricas de interacción no públicas para el contenido multimedia en el momento de la solicitud. properties: playback_0_count: type: integer description: "Número de usuarios que alcanzaron el 0\_% de reproducción del video." format: int32 playback_100_count: type: integer description: "Número de usuarios que alcanzaron el 100\_% de reproducción del video." format: int32 playback_25_count: type: integer description: "Número de usuarios que alcanzaron el 25\_% de reproducción del video." format: int32 playback_50_count: type: integer description: "Número de usuarios que alcanzaron el 50\_% de reproducción del video." format: int32 playback_75_count: type: integer description: "Número de usuarios que alcanzaron el 75\_% de reproducción del video." format: int32 organic_metrics: type: object description: >- Métricas orgánicas de interacción no públicas para el contenido multimedia, obtenidas en el momento de la solicitud. properties: playback_0_count: type: integer description: "Número de usuarios que alcanzaron el 0\_% de reproducción del video." format: int32 playback_100_count: type: integer description: Número de usuarios que vieron el 100 % del video. format: int32 playback_25_count: type: integer description: Número de usuarios que vieron el 25 % del video. format: int32 playback_50_count: type: integer description: Número de usuarios que vieron el 50 % del video. format: int32 playback_75_count: type: integer description: Número de usuarios que vieron el 75 % del video. format: int32 view_count: type: integer description: Número de veces que se reprodujo este video. format: int32 preview_image_url: type: string format: uri promoted_metrics: type: object description: >- Métricas de participación promocionadas y no públicas para el contenido multimedia en el momento de la solicitud. properties: playback_0_count: type: integer description: Número de usuarios que vieron el 0 % del video. format: int32 playback_100_count: type: integer description: Número de usuarios que vieron el 100 % del video. format: int32 playback_25_count: type: integer description: Número de usuarios que vieron el 25 % del video. format: int32 playback_50_count: type: integer description: Número de usuarios que vieron el 50 % del video. format: int32 playback_75_count: type: integer description: Número de usuarios que vieron el 75 % del video. format: int32 view_count: type: integer description: Número de veces que se ha reproducido este video. format: int32 public_metrics: type: object description: >- Métricas de interacción del contenido multimedia en el momento de la solicitud. properties: view_count: type: integer description: Número de veces que se ha reproducido este video. format: int32 variants: $ref: '#/components/schemas/Variants' PlaceId: type: string description: El identificador de este lugar. example: f7eb2fa2fea288b1 CountryCode: type: string description: Un código de país de dos letras según la norma ISO 3166-1 alfa-2. pattern: ^[A-Z]{2}$ example: US Geo: type: object required: - type - bbox - properties properties: bbox: type: array minItems: 4 maxItems: 4 items: type: number minimum: -180 maximum: 180 format: double example: - -105.193475 - 39.60973 - -105.053164 - 39.761974 geometry: $ref: '#/components/schemas/Point' properties: type: object type: type: string enum: - Feature PlaceType: type: string enum: - poi - neighborhood - city - admin - country - unknown example: city PollId: type: string description: Identificador único de esta encuesta. pattern: ^[0-9]{1,19}$ example: '1365059861688410112' PollOption: type: object description: Describe una opción de un objeto Poll. required: - position - label - votes properties: label: $ref: '#/components/schemas/PollOptionLabel' position: type: integer description: Posición de esta opción en la encuesta. votes: type: integer description: Número de usuarios que votaron por esta opción. TopicId: type: string description: Identificador único de este tema. TweetId: type: string description: >- Identificador único de este Tweet. Se devuelve como cadena para evitar complicaciones con lenguajes y herramientas que no pueden manejar enteros de gran tamaño. pattern: ^[0-9]{1,19}$ example: '1346889436626259968' CommunityId: type: string description: El identificador único de esta Comunidad. pattern: ^[0-9]{1,19}$ example: '1146654567674912769' ContextAnnotation: type: object description: Anotación inferida a partir del texto del Tweet. required: - domain - entity properties: domain: $ref: '#/components/schemas/ContextAnnotationDomainFields' entity: $ref: '#/components/schemas/ContextAnnotationEntityFields' DisplayTextRange: type: array description: >- Representa un intervalo de límites (índices de inicio y fin basados en cero) para la porción de texto que se muestra de una Publicación. `start` debe ser menor que `end`. El índice de inicio es inclusivo y el índice de fin es exclusivo. minItems: 2 maxItems: 2 items: type: integer minimum: 0 FullTextEntities: type: object properties: annotations: type: array minItems: 1 items: description: Anotación de entidades basada en el texto del Tweet. allOf: - $ref: '#/components/schemas/EntityIndicesInclusiveInclusive' - type: object description: Representa los datos de la anotación. properties: normalized_text: type: string description: Texto utilizado para determinar la anotación. example: Barack Obama probability: type: number description: Nivel de confianza para el tipo de anotación. minimum: 0 maximum: 1 format: double type: type: string description: Tipo de anotación. example: Person cashtags: type: array minItems: 1 items: $ref: '#/components/schemas/CashtagEntity' hashtags: type: array minItems: 1 items: $ref: '#/components/schemas/HashtagEntity' mentions: type: array minItems: 1 items: $ref: '#/components/schemas/MentionEntity' urls: type: array minItems: 1 items: $ref: '#/components/schemas/UrlEntity' Point: type: object description: >- Un objeto de geometría de tipo [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2). required: - type - coordinates properties: coordinates: $ref: '#/components/schemas/Position' type: type: string enum: - Point example: Point CashtagEntity: allOf: - $ref: '#/components/schemas/EntityIndicesInclusiveExclusive' - $ref: '#/components/schemas/CashtagFields' HashtagEntity: allOf: - $ref: '#/components/schemas/EntityIndicesInclusiveExclusive' - $ref: '#/components/schemas/HashtagFields' MentionEntity: allOf: - $ref: '#/components/schemas/EntityIndicesInclusiveExclusive' - $ref: '#/components/schemas/MentionFields' UrlEntity: description: >- Representa el segmento de texto identificado como una URL y su posición inicial y final dentro del texto. allOf: - $ref: '#/components/schemas/EntityIndicesInclusiveExclusive' - $ref: '#/components/schemas/UrlFields' NoteTweetText: type: string description: El contenido de la nota del Tweet. example: >- Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\u2026 https:\/\/t.co\/56a0vZUx7i ReplySettingsWithVerifiedUsers: type: string description: >- Indica quién puede responder a un Tweet. Los valores devueltos son everyone, mentioned_users, subscribers, verified y following. pattern: ^[A-Za-z]{1,12}$ enum: - everyone - mentionedUsers - following - other - subscribers - verified TweetText: type: string description: Texto del Tweet. example: >- Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\u2026 https:\/\/t.co\/56a0vZUx7i UserName: type: string description: El nombre de usuario de X (handle) de este usuario. pattern: ^[A-Za-z0-9_]{1,15}$ TweetWithheld: type: object description: >- Indica la información de retención para el [contenido retenido](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country). required: - copyright - country_codes properties: copyright: type: boolean description: >- Indica si el contenido se está reteniendo debido a una infracción de derechos de autor. country_codes: type: array description: >- Proporciona una lista de países en los que este contenido no está disponible. minItems: 1 uniqueItems: true items: $ref: '#/components/schemas/CountryCode' scope: type: string description: >- Indica si el contenido que se está reteniendo es un Tweet o un usuario. enum: - tweet - user UserWithheld: type: object description: >- Especifica los detalles de retención del [contenido retenido](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country). required: - country_codes properties: country_codes: type: array description: >- Proporciona la lista de países en los que este contenido no está disponible. minItems: 1 uniqueItems: true items: $ref: '#/components/schemas/CountryCode' scope: type: string description: Indica que el contenido retenido corresponde a un `user`. enum: - user Variants: type: array description: >- Una matriz (array) con todas las variantes disponibles del contenido multimedia. items: $ref: '#/components/schemas/Variant' PollOptionLabel: type: string description: Texto de una opción de la encuesta. minLength: 1 maxLength: 25 ContextAnnotationDomainFields: type: object description: Representa los datos del dominio de anotación de contexto. required: - id properties: description: type: string description: Descripción del dominio de anotación de contexto. id: type: string description: El id único de un dominio de anotaciones de contexto. pattern: ^[0-9]{1,19}$ name: type: string description: Nombre del dominio de anotaciones de contexto. ContextAnnotationEntityFields: type: object description: Representa los datos de la entidad de anotaciones de contexto. required: - id properties: description: type: string description: Descripción de la entidad de anotaciones de contexto. id: type: string description: El id único de una entidad de anotaciones de contexto. pattern: ^[0-9]{1,19}$ name: type: string description: Nombre de la entidad de anotaciones de contexto. EntityIndicesInclusiveInclusive: type: object description: >- Representa un rango delimitado (índice inicial y final) para una entidad reconocida (por ejemplo, un hashtag o una mención). `start` debe ser menor que `end`. El índice inicial es inclusivo y el índice final es inclusivo. required: - start - end properties: end: type: integer description: >- Índice (con base cero) en el que finaliza esta entidad. El índice es inclusivo. minimum: 0 example: 61 start: type: integer description: >- Índice (con base cero) en el que comienza esta entidad. El índice es inclusivo. minimum: 0 example: 50 Position: type: array description: >- Una [posición GeoJSON](https://tools.ietf.org/html/rfc7946#section-3.1.1) con el formato `[longitud, latitud]`. minItems: 2 maxItems: 2 items: type: number example: - -105.18816086351444 - 40.247749999999996 EntityIndicesInclusiveExclusive: type: object description: >- Representa un rango de índices (índice de inicio y de fin) para una entidad reconocida (por ejemplo, un hashtag o una mención). `start` debe ser menor que `end`. El índice de inicio es inclusivo y el índice de fin es exclusivo. required: - start - end properties: end: type: integer description: >- Índice (con base cero) donde termina esta entidad. El índice es exclusivo. minimum: 0 example: 61 start: type: integer description: >- Índice (con base cero) donde comienza esta entidad. El índice es inclusivo. minimum: 0 example: 50 CashtagFields: type: object description: >- Representa la parte del texto reconocida como un Cashtag y su posición inicial y final dentro del texto. required: - tag properties: tag: type: string example: TWTR HashtagFields: type: object description: >- Representa la parte del texto identificada como un hashtag y su posición inicial y final dentro del texto. required: - tag properties: tag: type: string description: El texto del hashtag. example: MondayMotivation MentionFields: type: object description: >- Representa la parte del texto reconocida como una mención de usuario y su posición inicial y final dentro del texto. required: - username properties: id: $ref: '#/components/schemas/UserId' username: $ref: '#/components/schemas/UserName' UrlFields: type: object description: Representa el segmento de texto identificado como una URL. required: - url properties: description: type: string description: Descripción de la página de destino de la URL. example: This is a description of the website. display_url: type: string description: La URL tal como se muestra en el cliente de X. example: twittercommunity.com/t/introducing-… expanded_url: $ref: '#/components/schemas/Url' images: type: array minItems: 1 items: $ref: '#/components/schemas/UrlImage' media_key: $ref: '#/components/schemas/MediaKey' status: $ref: '#/components/schemas/HttpStatusCode' title: type: string description: Título de la página de destino de la URL. example: Introducing the v2 follow lookup endpoints unwound_url: type: string description: URL completamente expandida. format: uri example: >- https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118 url: $ref: '#/components/schemas/Url' Variant: type: object properties: bit_rate: type: integer description: La tasa de bits del contenido multimedia. content_type: type: string description: El tipo de contenido (content type) del contenido multimedia. url: type: string description: La URL del contenido multimedia. format: uri Url: type: string description: Una URL con un formato válido. format: uri example: https://developer.twitter.com/en/docs/twitter-api UrlImage: type: object description: Representa la información de la imagen asociada a la URL. properties: height: $ref: '#/components/schemas/MediaHeight' url: $ref: '#/components/schemas/Url' width: $ref: '#/components/schemas/MediaWidth' HttpStatusCode: type: integer description: Código de estado HTTP. minimum: 100 maximum: 599 securitySchemes: BearerToken: type: http scheme: bearer OAuth2UserToken: type: oauth2 flows: authorizationCode: authorizationUrl: https://api.x.com/2/oauth2/authorize tokenUrl: https://api.x.com/2/oauth2/token scopes: block.read: View accounts you have blocked. bookmark.read: Read your bookmarked Posts. bookmark.write: Create and delete your bookmarks. dm.read: Read all your Direct Messages. dm.write: Send and manage your Direct Messages. follows.read: View accounts you follow and accounts following you. follows.write: Follow and unfollow accounts on your behalf. like.read: View Posts you have liked and likes you can see. like.write: Like and unlike Posts on your behalf. list.read: >- View Lists, members, and followers of Lists you created or are a member of, including private Lists. list.write: Create and manage Lists on your behalf. media.write: Upload media, such as photos and videos, on your behalf. mute.read: View accounts you have muted. mute.write: Mute and unmute accounts on your behalf. offline.access: Request a refresh token for the app. space.read: View all Spaces you have access to. timeline.read: >- View all Custom Timelines you can see, including public Custom Timelines from other developers. tweet.moderate.write: Hide and unhide replies to your Posts. tweet.read: >- View all Posts you can see, including those from protected accounts. tweet.write: Post and repost on your behalf. users.read: View any account you can see, including protected accounts. ````