Announcement: Video app download card aspect ratio



Video app download card videos currently render at 16:9, regardless of the video’s aspect ratio. This causes videos outside of this specification to get cropped. In order to ensure that videos in cards display as intended, we will be adding a validation to only accept 16:9 videos for video app download cards. This will take effect as early as 2017-09-04.

Twitter Ads API Team

Announcement: Square video app download cards



In order to identify the videos that can be used in video app download cards once this change goes into effect, we’ve added the aspect_ratio response attribute.

$ twurl -H "/2/accounts/18ce54d4x5t/videos?video_ids=13_887777498917777408"
  "data": [
      "tweeted": true,
      "ready_to_tweet": true,
      "duration": 14380,
      "reasons_not_servable": [],
      "description": null,
      "preview_url": "",
      "id": "13_887777498917777408",
      "poster_url": "",
      "media_key": "13_887777498917777408",
      "created_at": "2017-07-19T20:53:44Z",
      "title": null,
      "aspect_ratio": "16:9",
      "updated_at": "2017-07-19T20:55:57Z",
      "deleted": false
  "request": {
    "params": {
      "video_ids": [
      "account_id": "18ce54d4x5t"
  "next_cursor": null


This change was implemented at the beginning of September. Trying to use a video outside of the 16:9 aspect ratio in a video app download card will result in the following error:

$ twurl -X POST -H "/2/accounts/18ce54d4x5t/cards/video_app_download?app_country_code=US&name=tall video&video_id=13_915281557014831104&"
  "errors": [
      "code": "INVALID_ASPECT_RATIO",
      "message": "Currently supported video aspect ratios: AspectRatio(16,9)",
      "attribute": "video"
  "request": {
    "params": {}