Saltar al contenido principal
Con las expansions, los desarrolladores pueden expandir objetos referenciados en el payload. Los objetos disponibles para expansión se referencian por id. Por ejemplo, los campos referenced_tweets.id y author_id devueltos en el payload de Posts lookup pueden expandirse en objetos completos. Si desea solicitar fields relacionados con el usuario que publicó ese Post, o con el contenido multimedia, la encuesta o el lugar incluidos en ese Post, deberá pasar el parámetro de query de expansión correspondiente en su solicitud para recibir esos data en su respuesta. Actualmente, los endpoints de v2 que devuelven Posts, usuarios, List, Spaces y objetos de eventos de Mensajes Directos admiten expansions (vea los ejemplos a continuación). Al incluir una expansión en su solicitud, incluiremos los fields predeterminados de ese objeto expandido dentro de la misma respuesta. Esto ayuda a devolver data adicional en la misma respuesta sin necesidad de solicitudes independientes. Si desea solicitar fields adicionales relacionados con el objeto expandido, puede incluir el parámetro de fields asociado con ese objeto expandido, junto con una lista de fields separada por comas que desea recibir en su respuesta. Tenga en cuenta que los fields no siempre se devuelven en el mismo orden en que se solicitaron en la query. El payload del Post a continuación contiene id de referencia para objetos complementarios que podemos expandir, incluido el author_id de quien publicó el Post, el id de un Post de referencia y un media_key para un archivo multimedia adjunto. 
{
    "data": {
        "attachments": {
            "media_keys": ["16_1211797899316740096"]
        },
        "author_id": "2244994945",
        "id": "1212092628029698048",
        "referenced_tweets": [
            {
                "type": "replied_to",
                "id": "1212092627178287104"
            }
        ],
        "text": "Creemos que la mejor versión futura de nuestra API surgirá de construirla CONTIGO. Brindamos por otro gran año junto a todos los que desarrollan sobre la plataforma de Twitter. Estamos deseando seguir trabajando contigo en el nuevo año. https://t.co/yvxdK6aOo2"
    }
}

​
Expansiones disponibles para cargas útiles de Post

ExpansionDescripción
author_idDevuelve un objeto de usuario que representa al autor del Post
referenced_tweets.idDevuelve un Objeto de Post al que este Post hace referencia (ya sea como Retweet, Tweet citado o respuesta)
edit_history_tweet_idsDevuelve Objetos de Post que forman parte del historial de edición de un Post
in_reply_to_user_idDevuelve un objeto de usuario que representa al autor del Post al que este Post responde
attachments.media_keysDevuelve un objeto de media que representa las imágenes, videos y GIF incluidos en el Post
attachments.poll_idsDevuelve un objeto de encuesta que contiene metadata de la encuesta incluida en el Post
geo.place_idDevuelve un objeto de lugar que contiene metadata de la ubicación etiquetada en el Post
entities.mentions.usernameDevuelve un objeto de usuario del usuario mencionado en el Post
referenced_tweets.id.author_idDevuelve un objeto de usuario del autor del Post referenciado

​
Expansión disponible para cargas útiles de usuario

ExpansiónDescripción
pinned_tweet_idDevuelve un Objeto de Post que representa el Post fijado en la parte superior del perfil del usuario

​
Expansions disponibles para cargas útiles de eventos de Mensaje Directo

ExpansionDescription
attachments.media_keysDevuelve un objeto Media adjunto a un Mensaje Directo
referenced_tweets.idDevuelve un Objeto de Post al que se hizo referencia en un Mensaje Directo
sender_idDevuelve un objeto User que representa al autor de un Mensaje Directo y a quien invitó a un participante a unirse a una conversación
participant_idsDevuelve un objeto User que representa a un participante que se unió o abandonó una conversación

​
Expansions disponibles para cargas útiles de Spaces

ExpansionDescripción
invited_user_idsDevuelve objetos de usuario que representan las cuentas que fueron invitadas
speaker_idsDevuelve objetos de usuario que representan las cuentas que hablaron durante un Space
creator_idDevuelve un objeto de usuario que representa la cuenta que creó el Space
host_idsDevuelve objetos de usuario que representan las cuentas que se establecieron como anfitrionas
topics_idsDevuelve descripciones de temas que fueron establecidas por el creador

​
Expansión disponible para cargas útiles de Lists

ExpansiónDescripción
owner_idDevuelve un objeto de usuario que representa la cuenta que creó y mantiene la List

​
Ampliación del objeto Media

En la siguiente solicitud, pedimos la expansión geo.place_id para incluirla junto con los campos predeterminados de Post: Solicitud de ejemplo 
{`curl 'https://api.x.com/2/tweets/:ID?expansions=geo.place_id' --header 'Authorization: Bearer $ACCESS_TOKEN'`}
Respuesta de muestra 
{`{
  "data": {
      "geo": {
          "place_id": "01a9a39529b27f36"
      },
      "id": "ID",
      "text": "Prueba"
  },
  "includes": {
      "places": [
          {
              "full_name": "Manhattan, NY"
              "id": "01a9a39529b27f36"
          }
      ]
  }
}`}

​
Ampliar el objeto Poll

En la siguiente solicitud, pedimos la expansión attachments.poll_ids para incluirla junto con los campos predeterminados de Post: Solicitud de ejemplo Respuesta de ejemplo 
{`{
  "data": {
      "attachments": {
          "poll_ids": ["1199786642468413448"]
      },
      "id": "1199786642791452673",
      "text": "C#"
  },
  "includes": {
      "polls": [
          {
              "id": "1199786642468413448",
              "options": [
                  {
                      "position": 1,
                      "label": "“C sharp”"
                      "votes": 795
                  },
                  {
                      "position": 2,
                      "label": "“C hashtag”"
                      "votes": 156
                  }
              ]
          }
      ]
  }
}`}

​
Ampliación del objeto Place

En la siguiente solicitud, pedimos la expansión geo.place_id para incluirla junto con los campos predeterminados de Post: Solicitud de ejemplo Respuesta de ejemplo 
{`{
  "data": {
      "geo": {
          "place_id": "01a9a39529b27f36"
      },
      "id": "ID",
      "text": "Prueba"
  },
  "includes": {
      "places": [
          {
              "full_name": "Manhattan, NY"
              "id": "01a9a39529b27f36"
          }
      ]
  }
}`}
⌘I