Poll metadata

Poll metadata

Poll metadata is a free enrichment available across all products (Realtime & Historical APIs) in enriched native format payloads. The metadata notes the presence of the poll in a Post, 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 Post for display.

Important Details:
  • Available across all enterprise APIs (PowerTrack, Replay, Search, Historical PowerTrack)
    • Note: For Replay and Historical PowerTrack, this metadata was first made available on 02/22/17 - see documented enrichment availability.
  • Does not include vote information or poll results
  • Does not currently have filter/operator support
  • Available in enriched native format only
    • Enriched native 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 (Leave data in its original format)

Post Payload

Poll Post 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 enriched native 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
         }
      ]
   },