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&nbsp

Below is a snippet of the Original format payload highlighting the added poll metadata:

                  "text":"The better answer"
                  "text":"The best answer"
            "end_datetime":"Sat Feb 04 15:33:11 +0000 2017",