Heads up! This page will soon be redirected to the corresponding page on developer.twitter.com. Please plan to use the new documentation page going forward.
Poll Metadata
Poll metadata is a free enrichment available across all products (Realtime & Historical APIs) in Original format payloads. The metadata notes the presence of the poll in a Tweet, includes the list of poll choices, and includes both the poll duration and expiration time. This enrichment makes it easy to acknowledge the presence of a poll and enables proper rendering of a poll Tweet for display.
Important Details:
- Available across all Gnip APIs (PowerTrack, Replay, Search, Historical PowerTrack)
- Note: For Replay and Historical PowerTrack, this metadata will be first available starting 02/22/17 - see documented enrichment availability.
- Does not include vote information or poll results
- Does not currently have filter/operator support
- Available in Original format only
- Output format is a user controlled setting that can be changed at any time through the Console: Select a Product (PowerTrack, Replay, Search) > Settings tab > Output Format
Tweet Payload
Poll Tweets will contain the following metadata in the “entities.polls” object in the payload:
- An “options” array with up to four options that include the position (1-4) and option text
- Poll expiration date
- Poll duration
See the sample payload below for further reference.
Sample Payload 
Below is a snippet of the Original format payload highlighting the added poll metadata:
"entities":{
"hashtags":[],
"urls":[],
"user_mentions":[],
"symbols":[],
"polls":[
{
"options":[
{
"position":1,
"text":"The better answer"
},
{
"position":2,
"text":"The best answer"
}
],
"end_datetime":"Sat Feb 04 15:33:11 +0000 2017",
"duration_minutes":1440
}
]
},