Interested in exploring Labs?
The endpoints we release in Labs are previews of tools that may be released more broadly in the future, but will likely undergo changes before then. We encourage you to take that into consideration as you explore. Before getting started, please read more about Twitter Developer Labs.

Overview

Expansions enable requests to expand the complementary objects referenced in API responses. Expanding an object returns its default fields and embeds it in a single response. Complementary objects are referenced by ID. Many ID fields within the main data payload are eligible for expansion. A request can specify which IDs should be expanded by specifying a comma-separated list of nouns and fields within the expansions request parameter.

Available expansions for /tweets

• author_id
• referenced_tweets.id
• in_reply_to_user_id 
• attachments.media_keys
• attachments.poll_ids
• geo.place_id
• entities.mentions.username
• referenced_tweets.id.author_id

Available expansions for /users

• pinned_tweet_id

Example response:
 

Expansions with /tweets
 

{
  "data": [
    {
      "id": "1108050885639168000",
      "text": "Today we are previewing changes to the rate limits of two commonly used Twitter standard API endpoints – user and mentions timeline. Read more about the new limit that we’ll implement on June 19, 2019 here:\n\nhttps://t.co/RfrrSo4H27"
    }
  ]
}

"includes": {
  "users": [
    {
      "id": "2244994945",
      "name": "Twitter Dev",
      "username": "TwitterDev"
    }
  ]
}

"includes": {
    "tweets": [
      {
        "id": "1115482402795610112",
        "text": "Good night again"
      }
    ]
  }

"includes": {
    "users": [
      {
        "id": "6253282",
        "name": "Twitter API",
        "username": "TwitterAPI"
      }
    ]
  }

"includes": {
    "media": [
      {
        "media_key": "3_1136066841225207808"
      }
    ]
  }

"includes": {
  "polls": [
    {
      "id": "1117897901294772224"
    }
  ]
}

"includes": {
  "places": [
    {
      "id": "5a110d312052166f"
    }
  ]
}

Expansions with /users
 

"includes": {
    "tweets": [
      {
        "id": "1214281000932593667",
        "text": "Hello… is it me you’re searching for? 🔎\n\nSearch the conversation as it unfolds with this new addition to Labs. We're making it easier than ever to find the Tweets you care about. https://t.co/HmuuUC6PKZ https://t.co/QgEXeL9XzX"
      }
    ]
  }
        

Additional resources

• Learn more about the new Developer Labs on the "About Labs" page.
• Learn more about What’s new.
• Dive into our documentation on Tweets and Users.
• Get started building with our quick start guides.
• Check out our API reference to learn more about what’s available.
• Give feedback on Twitter Developer Labs.
• Tell us about your experience using the Twitter Developer Labs endpoints by filling out this survey.