Image App Download Cards

GET accounts/:account_id/cards/image_app_download

Retrieve details for some or all image app download cards associated with the current account.

This card is part of our Mobile App Promotion product suite.

Resource URL

https://ads-api.twitter.com/2/accounts/:account_id/cards/image_app_download

Parameters

Name Description
account_id
required

The identifier for the leveraged account. Appears within the resource’s path and is generally a required parameter for all Advertiser API requests excluding GET accounts. The specified account must be associated with the authenticated user.

Type: string

Example: 18ce54d4x5t

card_ids
optional

Scope the response to just the desired image app download cards by specifying a comma-separated list of identifiers. Up to 200 IDs may be provided.

Type: string

Example: 4ca39

count
optional

Specifies the number of records to try and retrieve per distinct request.

Type: int

Default: 200
Min, Max: 1, 1000
cursor
optional

Specifies a cursor to get the next page of results. See Pagination for more information.

Type: string

Example: 8x7v00oow

sort_by
optional

Sorts by supported attribute in ascending or descending order. See Sorting for more information.

Type: string

Example: created_at-asc

with_deleted
optional

Include deleted results in your request.

Type: boolean

Default: false
Possible values: true, false
with_total_count
optional

Include the total_count response attribute.

Note: This parameter will be ignored if cursor is specified.

Note: Requests which include total_count will have lower rate limits, currently set at 200 per 15 minutes.

Type: boolean

Default: false
Possible values: true, false

Example Request

GET https://ads-api.twitter.com/2/accounts/18ce54d4x5t/cards/image_app_download?card_ids=4ca39

Example Response

{
  "request": {
    "params": {
      "card_type": "image_app_download",
      "card_ids": [
        "4ca39"
      ],
      "account_id": "18ce54d4x5t"
    }
  },
  "next_cursor": null,
  "data": [
    {
      "name": "image app download card",
      "googleplay_app_id": "com.twitter.android",
      "image_display_height": "100",
      "preview_url": "https://cards.twitter.com/cards/18ce54d4x5t/4ca39",
      "id": "4ca39",
      "account_id": "18ce54d4x5t",
      "app_country_code": "US",
      "wide_app_image": "https://pbs.twimg.com/ad_img/872683756951183360/K2ZDG0ii?format=jpg&name=orig",
      "created_at": "2017-06-08T05:18:03Z",
      "image_display_width": "191",
      "card_uri": null,
      "updated_at": "2017-06-08T05:18:03Z",
      "app_cta": "INSTALL_OPEN",
      "deleted": false,
      "card_type": "IMAGE_APP_DOWNLOAD"
    }
  ]
}

GET accounts/:account_id/cards/image_app_download/:card_id

Retrieve a specific image app download card associated with the current account.

This card is part of our Mobile App Promotion product suite.

Resource URL

https://ads-api.twitter.com/2/accounts/:account_id/cards/image_app_download/:card_id

Parameters

Name Description
account_id
required

The identifier for the leveraged account. Appears within the resource’s path and is generally a required parameter for all Advertiser API requests excluding GET accounts. The specified account must be associated with the authenticated user.

Type: string

Example: 18ce54d4x5t

card_id
required

A reference to the image app download card you are operating with in the request.

Type: string

Example: 4hudo

with_deleted
optional

Include deleted results in your request.

Type: boolean

Default: false
Possible values: true, false

Example Request

GET https://ads-api.twitter.com/2/accounts/18ce54d4x5t/cards/image_app_download/4hudo

Example Response

{
  "request": {
    "params": {
      "card_type": "image_app_download",
      "card_id": "4hudo",
      "account_id": "18ce54d4x5t"
    }
  },
  "data": {
    "name": "image app download",
    "googleplay_app_id": "com.twitter.android",
    "image_display_height": "100",
    "preview_url": "https://cards.twitter.com/cards/18ce54d4x5t/4hudo",
    "id": "4hudo",
    "account_id": "18ce54d4x5t",
    "app_country_code": "US",
    "wide_app_image": "https://pbs.twimg.com/ad_img/882829247282388993/KsExq7Ir?format=jpg&name=orig",
    "created_at": "2017-07-05T22:22:54Z",
    "image_display_width": "191",
    "card_uri": null,
    "updated_at": "2017-07-05T22:22:54Z",
    "app_cta": "CONNECT",
    "deleted": false,
    "card_type": "IMAGE_APP_DOWNLOAD"
  }
}

POST accounts/:account_id/cards/image_app_download

Create a new image app download card associated with the current account.

This card is part of our Mobile App Promotion product suite.

Resource URL

https://ads-api.twitter.com/2/accounts/:account_id/cards/image_app_download

Parameters

Name Description
account_id
required

The identifier for the leveraged account. Appears within the resource’s path and is generally a required parameter for all Advertiser API requests excluding GET accounts. The specified account must be associated with the authenticated user.

Type: string

Example: 18ce54d4x5t

name
required

The name for the card.

Type: string

Example: image app download card

app_country_code
required

The two-letter ISO code for the country where the app is sold.

Type: string

Example: US

wide_app_image_media_id
required

A media_id of an image which will be used instead of the app store’s icon.

This is a write-only field. In response, the API will provide a Twitter URL for this image, that can be reused.

Note: A minimum image width of 800px and a width:height aspect ratio of either 1.91:1 or 5:2 is required.

Type: long

Example: 882726458191298561

ipad_app_id
sometimes required

The iPad app ID.

Note: At least one of following is required: ipad_app_id, iphone_app_id, or googleplay_app_id.

Note: This can be retrieved from the Apple App Store URL.

Type: long

Example: 333903271

iphone_app_id
sometimes required

The iPhone app ID.

Note: At least one of following is required: ipad_app_id, iphone_app_id, or googleplay_app_id.

Note: This can be retrieved from the Apple App Store URL.

Type: long

Example: 333903271

googleplay_app_id
sometimes required

The Google Play application package name.

Note: At least one of following is required: ipad_app_id, iphone_app_id, or googleplay_app_id.

Type: string

Example: com.twitter.android

app_cta
optional

The Call-To-Action (CTA) text for the card button.

Type: enum

Possible values: BOOK, CONNECT, INSTALL, OPEN, ORDER, PLAY, SHOP

ipad_deep_link
optional

A deep link into the iPad app you’re promoting.

Note: Can only be used if an ipad_app_id has been provided.

Type: string

iphone_deep_link
optional

A deep link into the iPhone app you’re promoting.

Note: Can only be used if an iphone_app_id has been provided.

Type: string

googleplay_deep_link
optional

A deep link into the Android app you’re promoting.

Note: Can only be used if a googleplay_app_id has been provided.

Type: string

Example Request

POST https://ads-api.twitter.com/2/accounts/18ce54d4x5t/cards/image_app_download?name=image app download&app_country_code=US&googleplay_app_id=com.twitter.android&app_cta=CONNECT&wide_app_image_media_id=882726458191298561

Example Response

{
  "data": {
    "name": "image app download",
    "googleplay_app_id": "com.twitter.android",
    "image_display_height": "100",
    "preview_url": "https://cards.twitter.com/cards/18ce54d4x5t/4hudo",
    "id": "4hudo",
    "account_id": "18ce54d4x5t",
    "app_country_code": "US",
    "wide_app_image": "https://pbs.twimg.com/ad_img/882726458191298561/sIWo2La0?format=jpg&name=orig",
    "created_at": "2017-07-05T22:22:54Z",
    "image_display_width": "191",
    "card_uri": null,
    "updated_at": "2017-07-05T22:22:54Z",
    "app_cta": "CONNECT",
    "deleted": false,
    "card_type": "IMAGE_APP_DOWNLOAD"
  },
  "request": {
    "params": {
      "name": "image app download",
      "googleplay_app_id": "com.twitter.android",
      "image_display_height": "100",
      "account_id": "18ce54d4x5t",
      "app_country_code": "US",
      "wide_app_image": "https://pbs.twimg.com/ad_img/882726458191298561/sIWo2La0?format=jpg&name=orig",
      "image_display_width": "191",
      "app_cta": "CONNECT",
      "card_type": "IMAGE_APP_DOWNLOAD"
    }
  }
}

PUT accounts/:account_id/cards/image_app_download/:card_id

Update the specified image app download card belonging to the current account.

This card is part of our Mobile App Promotion product suite.

Resource URL

https://ads-api.twitter.com/2/accounts/:account_id/cards/image_app_download/:card_id

Parameters

Name Description
account_id
required

The identifier for the leveraged account. Appears within the resource’s path and is generally a required parameter for all Advertiser API requests excluding GET accounts. The specified account must be associated with the authenticated user.

Type: string

Example: 18ce54d4x5t

card_id
required

A reference to the image app download card you are operating with in the request.

Type: string

Example: 4hudo

app_country_code
optional

The two-letter ISO code for the country where the app is sold.

Type: string

Example: US

app_cta
optional

The Call-To-Action (CTA) text for the card button.

Type: enum

Possible values: BOOK, CONNECT, INSTALL, OPEN, ORDER, PLAY, SHOP

ipad_app_id
optional

The iPad app ID.

Note: At least one of following is required: ipad_app_id, iphone_app_id, or googleplay_app_id.

Note: This can be retrieved from the Apple App Store URL.

Type: long

Example: 333903271

ipad_deep_link
optional

A deep link into the iPad app you’re promoting.

Note: Can only be used if an ipad_app_id has been provided.

Type: string

iphone_app_id
optional

The iPhone app ID.

Note: At least one of following is required: ipad_app_id, iphone_app_id, or googleplay_app_id.

Note: This can be retrieved from the Apple App Store URL.

Type: long

Example: 333903271

iphone_deep_link
optional

A deep link into the iPhone app you’re promoting.

Note: Can only be used if an iphone_app_id has been provided.

Type: string

googleplay_app_id
optional

The Google Play application package name.

Note: At least one of following is required: ipad_app_id, iphone_app_id, or googleplay_app_id.

Type: string

Example: com.twitter.android

googleplay_deep_link
optional

A deep link into the Android app you’re promoting.

Note: Can only be used if a googleplay_app_id has been provided.

Type: string

name
optional

The name for the card.

Type: string

Example: image app download card

wide_app_image_media_id
optional

A media_id of an image which will be used instead of the app store’s icon.

This is a write-only field. In response, the API will provide a Twitter URL for this image, that can be reused.

Note: A minimum image width of 800px and a width:height aspect ratio of either 1.91:1 or 5:2 is required.

Type: long

Example: 882829247282388993

Example Request

PUT https://ads-api.twitter.com/2/accounts/18ce54d4x5t/cards/image_app_download/4hudo?wide_app_image_media_id=882829247282388993

Example Response

{
  "data": {
    "name": "image app download",
    "image_display_height": "100",
    "preview_url": "https://cards.twitter.com/cards/18ce54d4x5t/4hudo",
    "id": "4hudo",
    "account_id": "18ce54d4x5t",
    "wide_app_image": "https://pbs.twimg.com/ad_img/882829247282388993/KsExq7Ir?format=jpg&name=orig",
    "created_at": "2017-07-05T22:22:54Z",
    "image_display_width": "191",
    "card_uri": null,
    "updated_at": "2017-07-05T22:22:54Z",
    "app_cta": "INSTALL_OPEN",
    "deleted": false,
    "card_type": "IMAGE_APP_DOWNLOAD"
  },
  "request": {
    "params": {
      "image_display_height": "100",
      "account_id": "18ce54d4x5t",
      "card_id": "4hudo",
      "wide_app_image": "https://pbs.twimg.com/ad_img/882829247282388993/KsExq7Ir?format=jpg&name=orig",
      "image_display_width": "191",
      "card_type": "IMAGE_APP_DOWNLOAD"
    }
  }
}

DELETE accounts/:account_id/cards/image_app_download/:card_id

Delete the specified image app download card.

This card is part of our Mobile App Promotion product suite.

Resource URL

https://ads-api.twitter.com/2/accounts/:account_id/cards/image_app_download/:card_id

Parameters

Name Description
account_id
required

The identifier for the leveraged account. Appears within the resource’s path and is generally a required parameter for all Advertiser API requests excluding GET accounts. The specified account must be associated with the authenticated user.

Type: string

Example: 18ce54d4x5t

card_id
required

A reference to the image app download card you are operating with in the request.

Type: string

Example: 4ca39

Example Request

DELETE https://ads-api.twitter.com/2/accounts/18ce54d4x5t/cards/image_app_download/4ca39

Example Response

{
  "data": {
    "name": "img",
    "id": "4ca39",
    "account_id": "18ce54d4x5t",
    "created_at": "2017-06-08T05:18:03Z",
    "updated_at": "2017-08-23T13:20:04Z",
    "deleted": true,
    "card_type": "IMAGE_APP_DOWNLOAD"
  },
  "request": {
    "params": {
      "card_id": "4ca39",
      "card_type": "image_app_download",
      "account_id": "18ce54d4x5t"
    }
  }
}