Additional information about embeddable media

extended-entities
media
video

#1

We’ve recently added some additional fields to Tweet objects, specifically the extended_entities relating to media content. The Entities in Twitter Objects documentation has been updated to describe the additional_media_info field, which may be added when publishers use Twitter’s Media Studio tooling to upload and manage their content.

additional_media_info
Contains additional media info provided by the publisher, such as title, description and embeddable flag. Video content is made available only to Twitter official clients when embeddable=false. If embeddable=false and there is no video in the Tweet response, the t.co link should be included in the result displayed to the user, so that the user can open the video in a Twitter owned property by clicking the link.

Example JSON for a Tweet containing these fields:

{
  "created_at": "Sat Sep 02 19:50:06 +0000 2017",
  "id": 904068938580992000,
  "id_str": "904068938580992000",
  "text": "A cheetah can only reach 75 mph –– one animal can go 3x as fast https://t.co/kxBf76FjsJ",
  "truncated": false,
  "entities": {
    "hashtags": [

    ],
    "symbols": [

    ],
    "user_mentions": [

    ],
    "urls": [

    ],
    "media": [
      {
        "id": 874657870977085443,
        "id_str": "874657870977085443",
        "indices": [
          64,
          87
        ],
        "media_url": "http://pbs.twimg.com/media/DCNz63FXUAAlCBS.jpg",
        "media_url_https": "https://pbs.twimg.com/media/DCNz63FXUAAlCBS.jpg",
        "url": "https://t.co/kxBf76FjsJ",
        "display_url": "pic.twitter.com/kxBf76FjsJ",
        "expanded_url": "https://twitter.com/businessinsider/status/904068938580992000/video/1",
        "type": "photo",
        "sizes": {
          "large": {
            "w": 1079,
            "h": 1079,
            "resize": "fit"
          },
          "medium": {
            "w": 1079,
            "h": 1079,
            "resize": "fit"
          },
          "thumb": {
            "w": 150,
            "h": 150,
            "resize": "crop"
          },
          "small": {
            "w": 680,
            "h": 680,
            "resize": "fit"
          }
        }
      }
    ]
  },
  "extended_entities": {
    "media": [
      {
        "id": 874657870977085443,
        "id_str": "874657870977085443",
        "indices": [
          64,
          87
        ],
        "media_url": "http://pbs.twimg.com/media/DCNz63FXUAAlCBS.jpg",
        "media_url_https": "https://pbs.twimg.com/media/DCNz63FXUAAlCBS.jpg",
        "url": "https://t.co/kxBf76FjsJ",
        "display_url": "pic.twitter.com/kxBf76FjsJ",
        "expanded_url": "https://twitter.com/businessinsider/status/904068938580992000/video/1",
        "type": "photo",
        "sizes": {
          "large": {
            "w": 1079,
            "h": 1079,
            "resize": "fit"
          },
          "medium": {
            "w": 1079,
            "h": 1079,
            "resize": "fit"
          },
          "thumb": {
            "w": 150,
            "h": 150,
            "resize": "crop"
          },
          "small": {
            "w": 680,
            "h": 680,
            "resize": "fit"
          }
        },
        "additional_media_info": {
          "title": "The fastest animals in the world: cheetah, ostrich, peregrine falcon",
          "description": "While cheetahs may be able to reach speeds of 75 mph, it's nothing compared to the top speeds of other animals. It's not even the fastest mammal! Here are the fastest animals on Earth.",
          "call_to_actions": {
            "watch_now": {
              "url": "https://www.youtube.com/channel/UCVLZmDKeT-mV4H3ToYXIFYg"
            }
          },
          "embeddable": false,
          "monetizable": true
        }
      }
    ]
  },
  "source": "<a href=\"https://studio.twitter.com\" rel=\"nofollow\">Media Studio</a>",
  "in_reply_to_status_id": null,
  "in_reply_to_status_id_str": null,
  "in_reply_to_user_id": null,
  "in_reply_to_user_id_str": null,
  "in_reply_to_screen_name": null,
  "user": {
    "id": 20562637,
    "id_str": "20562637",
    "name": "Business Insider",
    "screen_name": "businessinsider",
    "location": "New York, NY",
    "description": "What you need to know. \n\nFor corporate news from Business Insider and INSIDER follow @BI_Corporate.",
    "url": "https://t.co/RMkf7jACew",
    "entities": {
      "url": {
        "urls": [
          {
            "url": "https://t.co/RMkf7jACew",
            "expanded_url": "http://businessinsider.com/",
            "display_url": "businessinsider.com",
            "indices": [
              0,
              23
            ]
          }
        ]
      },
      "description": {
        "urls": [

        ]
      }
    },
    "protected": false,
    "followers_count": 2116562,
    "friends_count": 188,
    "listed_count": 28264,
    "created_at": "Wed Feb 11 01:18:18 +0000 2009",
    "favourites_count": 493,
    "utc_offset": -14400,
    "time_zone": "Eastern Time (US & Canada)",
    "geo_enabled": false,
    "verified": true,
    "statuses_count": 415819,
    "lang": "en",
    "contributors_enabled": false,
    "is_translator": false,
    "is_translation_enabled": false,
    "profile_background_color": "185F7C",
    "profile_background_image_url": "http://pbs.twimg.com/profile_background_images/563745973810110464/LOuV92MN.jpeg",
    "profile_background_image_url_https": "https://pbs.twimg.com/profile_background_images/563745973810110464/LOuV92MN.jpeg",
    "profile_background_tile": false,
    "profile_image_url": "http://pbs.twimg.com/profile_images/887662979902304257/azSzxYkB_normal.jpg",
    "profile_image_url_https": "https://pbs.twimg.com/profile_images/887662979902304257/azSzxYkB_normal.jpg",
    "profile_banner_url": "https://pbs.twimg.com/profile_banners/20562637/1423242532",
    "profile_link_color": "185F7C",
    "profile_sidebar_border_color": "EEEEEE",
    "profile_sidebar_fill_color": "EFEFEF",
    "profile_text_color": "333333",
    "profile_use_background_image": false,
    "has_extended_profile": false,
    "default_profile": false,
    "default_profile_image": false,
    "following": false,
    "follow_request_sent": false,
    "notifications": false,
    "translator_type": "none"
  },
  "geo": null,
  "coordinates": null,
  "place": null,
  "contributors": null,
  "is_quote_status": false,
  "retweet_count": 631,
  "favorite_count": 801,
  "favorited": false,
  "retweeted": false,
  "possibly_sensitive": false,
  "possibly_sensitive_appealable": false,
  "lang": "en"
}

For questions relating to media objects in the Twitter developer platform, please use the Media APIs category.


Can't find the video element in extended_entities
#2