Analytics stats for scheduled promoted tweet


The analytics endpoints allow you to request stats for PROMOTED_TWEET entities, but is it possible to request stats for a scheduled promoted tweet? Do you use the PROMOTED_TWEET entity but with a scheduled_promoted_tweet id?


Thanks for the question, @joe-vidmob!

When Scheduled Tweets go live—this is based on the scheduled_at time—the following happens:

  • An actual Tweet is created, with its own Tweet ID
  • The Tweet ID (tweet_id) is added to the response for the following entities:
    • scheduled_tweets
    • scheduled_promoted_tweets
  • A new promoted_tweets entity is created

Once this happens, the actual Tweet is promoted (during the campaign flight dates). This means that metrics (promoted or otherwise) for any scheduled-related entity do not exist. To get promoted metrics, you’ll use entity=PROMOTED_TWEET with the ID for the promoted_tweets entity that is created.

You can map it in the following way.

  1. Get the line item ID and the Tweet ID from the scheduled_promoted_tweets entity
  2. Make a request to the GET accounts/:account_id/promoted_tweets endpoint and specify the line item ID from #1 in the line_item_ids parameter
  3. Using the response from #2, use the Tweet ID to find the specific promoted_tweets entity that corresponds to the scheduled_promoted_tweets entity from #1

I hope this helps!


Thank you! That makes sense.