GET accounts/:account_id/cards/video_app_download¶

Retrieve card information about all Video App Download Cards for the specified account. This card is part of our Mobile App Promotion suite of endpoints.

Related endpoints: - GET /cards/video_app_download/:id - DELETE /cards/video_app_download/:id - PUT /cards/video_app_download/:id - POST /cards/video_app_download

For a short guide on how promoted video in the Ads API works please see our Promoted Video Overview.

Resource URL¶

GET accounts/:account_id/cards/video_app_download

Resource Information¶

Response formats	JSON
Requires authentication?	Yes (user context only)
Rate limited?	Yes

Parameters¶

Name	Required	Description	Default Value	Example
account_id	required	The identifier for the leveraged account. Appears within the resource’s path and is generally a required parameter for all Advertising API requests excluding GET accounts . The specified account must be associated with the authenticating user.		c5575wz03o
with_deleted	optional	Include deleted results in your request. Defaults to false .		true
count	optional	Specifies the number of Video App Download Card items to try and retrieve.
cursor	optional	Specifies a cursor to get the next page of Video App Download Cards. See Pagination for more information.		gc-ddf4a

Example Request¶

GET https://ads-api.twitter.com/1/accounts/c5575wz03o/cards/video_app_download

Example Response¶

{
  "request": {
    "params": {
      "with_deleted": true,
      "card_type": "video_app_download",
      "account_id": "c5575wz03o"
    }
  },
  "data": [
    {
      "name": "video_app_download_1",
      "preview_url": "https://cards.twitter.com/cards/c5575wz03o/55xwt",
      "id": "55xwt",
      "account_id": "c5575wz03o",
      "created_at": "2015-07-28T04:57:27Z",
      "updated_at": "2015-07-28T05:03:58Z",
      "app_cta": "INSTALL_OPEN",
      "deleted": true,
      "card_type": "VIDEO_APP_DOWNLOAD"
    },
    {
      "name": "video_app_download_2",
      "googleplay_app_id": "com.twitter.android",
      "ipad_app_id": "333903271",
      "iphone_app_id": "333903271",
      "preview_url": "https://cards.twitter.com/cards/c5575wz03o/zy6bv",
      "id": "zy6bv",
      "account_id": "c5575wz03o",
      "app_country_code": "US",
      "created_at": "2015-07-28T04:57:32Z",
      "updated_at": "2015-07-28T04:57:32Z",
      "video_poster_url": "https://pbs.twimg.com/media-preview/snf:62585678429059584/-j2JnQzb.png",
      "app_cta": "CONNECT",
      "deleted": false,
      "card_type": "VIDEO_APP_DOWNLOAD"
    }
  ],
  "data_type": "card",
  "total_count": 2,
  "next_cursor": null
}