GET accounts/:account_id/cards/image_conversation¶

Retrieve information about image conversation cards for a given account.

Resource URL¶

https://ads-api.twitter.com/1/accounts/:account_id/cards/image_conversation

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.		xyz1
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_conversation

Example Response¶

{
  "total_count": 1,
  "data": [
    {
      "name": "image conversation card",
      "title": "Tell the world!",
      "first_cta": "#TweetNow",
      "image": "https://pbs.twimg.com/media-preview/snf:649331432767098880/alHX6sAW.png",
      "thank_you_text": "Thank you",
      "thank_you_url": "https://example.com/thankyou",
      "preview_url": "https://cards.twitter.com/cards/abc1/xyz1",
      "id": "xyz1",
      "account_id": "abc1",
      "first_cta_tweet": "I #Heart @AdsAPI!",
      "created_at": "2015-09-03T00:03:16Z",
      "updated_at": "2015-09-03T00:03:16Z",
      "deleted": false,
      "card_type": "IMAGE_CONVERSATION"
    }
  ],
  "next_cursor": null,
  "data_type": "card",
  "request": {
    "params": {
      "card_type": "IMAGE_CONVERSATION",
      "account_id": "abc1"
    }
  }
}