GET accounts/:account_id/cards/image_app_download¶

Retrieve card information about image app download cards for a given account. This card is part of our Mobile App Promotion suite of endpoints.

Resource URL¶

https://ads-api.twitter.com/1/accounts/:account_id/cards/image_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.		43853bhii879
card_ids	optional	Include specific cards in your request.		g9z
with_deleted	optional	Include deleted results in your request. Defaults to false .		true
count	optional	Specifies the number of records to try and retrieve, up to a maximum of 1000 per distinct request.
cursor	optional	Specifies a cursor to get the next page of results. See Pagination for more information.		gc-ddf4a
sort_by	optional	Sorts by supported attribute in ascending or descending order. See Sorting for more information.		created_at-asc updated_at-desc

Example Request¶

GET https://ads-api.twitter.com/1/accounts/abc1/cards/image_app_download

Example Response¶

{
  "total_count": 1,
  "data": [
    {
      "card_type": "IMAGE_APP_DOWNLOAD",
      "ipad_app_id": "333903271",
      "app_country_code": "US",
      "created_at": "2014-06-17T23:25:47Z",
      "wide_app_image": "https://pbs.twimg.com/peacock/uploads/abc1/5_2_aspect_ratio_image.jpg",
      "name": "Sample Image App Card",
      "updated_at": "2014-06-17T23:25:47Z",
      "iphone_app_id": "333903271",
      "googleplay_app_id": "com.twitter.android",
      "deleted": false,
      "account_id": "abc1",
      "id": "u9w",
      "preview_url": "https://cards.twitter.com/cards/abc1/u9w"
    }
  ],
  "next_cursor": null,
  "data_type": "card",
  "request": {
    "params": {
      "card_type": "image_app_download",
      "account_id": "abc1"
    }
  }
}