Announcement: Polls available in the Ads API



For the first time, Twitter is offering a way for partners to create polls. This new ad format allows advertisers to creatively engage with and collect valuable insights from target audiences on Twitter.

In addition to creating standard polls, the poll card endpoints allow advertisers to create polls with media, referred to as Media Forward Polls. Media used in these endpoints must be in the Media Library and must be specified by the object’s media_key.

Create polls—with or without media—with up to four voting options. Polls can remain open for as little as 5 minutes or as long as 10,080 minutes (7 days). This is set using the duration_in_minutes request parameter. Note that this starts as soon as the poll is created and not when it is added to a Tweet.

As always, user’s votes are private. Use our synchronous or asynchronous analytics endpoints to retrieve the total number of poll votes.

The Media Forward Polls product is in beta and requires the PROMOTED_MEDIA_POLLS account feature. Account feature whitelisting is not required for creating standard polls—polls without media. We’ll continue making improvements based on user feedback.

Twitter Ads API Team

# create an image poll
$ twurl -X POST -H "/3/accounts/18ce54d4x5t/cards/poll?media_key=3_957113581522141184&duration_in_minutes=10080&name=space&first_choice=Moon&second_choice=Mars"
  "request": {
    "params": {
      "name": "space",
      "first_choice": "Moon",
      "second_choice": "Mars",
      "media_key": "3_957113581522141184",
      "duration_in_minutes": 10080
  "data": {
    "name": "space",
    "start_time": "2018-03-06T00:09:25Z",
    "first_choice": "Moon",
    "image_display_height": "9",
    "image": "",
    "second_choice": "Mars",
    "end_time": "2018-03-13T00:09:25Z",
    "preview_url": null,
    "id": "5fgee",
    "account_id": "18ce54d4x5t",
    "created_at": "2018-03-06T00:09:25Z",
    "duration_in_minutes": "10080",
    "image_display_width": "16",
    "card_uri": "card://970813564985393152",
    "updated_at": "2018-03-06T00:09:25Z",
    "deleted": false,
    "card_type": "IMAGE_POLLS"

# add the poll to a Tweet
$ twurl -X POST -H "/3/accounts/18ce54d4x5t/tweet?text=Would rather visit&card_uri=card://970813564985393152&as_user_id=756201191646691328&trim_user=true"


Ads API Version 3