GET accounts/:account_id/promoted_tweets

Retrieve references to the Promoted Tweets associated with one or more line items.

Use GET statuses/show/:id to obtain tweet data for the tweets identified by tweet_id in the response.

Note: An HTTP 400 will be returned if none of the specified line items are configured to contain Promoted Tweets.

Resource URL

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

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. Note that this parameter is part of the resources path and should not be included as an additional parameter in your request.   43853bhii879
line_item_ids optional Scope the response to just the desired line items by specifying a comma-separated list of identifiers. Up to 200 ids may be provided.   43853bh6lk3n,43853bh6lk5d
line_item_id deprecated Specify an identifier for a single line item by specifying its line item identifier.   43853bh6lk3n
with_deleted optional Include deleted results for your request. Defaults to false .   true
count optional Specifies the number of results to try to return per response, up to a maximum of 1000 200 1000
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
draft_only optional Scope the response to Promoted Tweets under draft campaigns. false true

Example Request

GET https://ads-api.twitter.com/1/accounts/hkk5/promoted_tweets?line_item_id=5woz

Example Response

{
  "data": [
    {
      "tweet_id": "57583424575246337",
      "created_at": "2012-11-20T23:29:10Z",
      "updated_at": "2012-11-20T23:29:10Z",
      "deleted": false,
      "id": "n4zr",
      "paused": false,
      "approval_status": "ACCEPTED",
      "line_item_id": "5woz"
    }
  ],
  "data_type": "promoted_tweet",
  "request": {
    "params": {
      "account_id": "hkk5",
      "line_item_id": "5woz"
    }
  },
  "total_count": 1
}