Twitter Enagement API Request Example

twitter-engagement.py

import requests
import json
from requests_oauthlib import OAuth1


API_URL = 'https://data-api.twitter.com/insights/engagement'
CONSUMER_KEY = 'YOUR_CONSUMER_KEY'
CONSUMER_SECRET = 'YOUR_CONSUMER_SECRET'
ACCESS_TOKEN = 'USER_ACCESS_TOKEN'
ACCESS_TOKEN_SECRET = 'USER_ACCESS_TOKEN_SECRET'


def get_oauth():

    oauth = OAuth1(CONSUMER_KEY,
      client_secret=CONSUMER_SECRET,
      resource_owner_key=ACCESS_TOKEN,
      resource_owner_secret=ACCESS_TOKEN_SECRET)

    return oauth


if __name__ == '__main__':

  params = {
    'tweets': {
      'tweet.id': [
        'A-TWEET-ID'
      ]
    },
    'engagements': {
      'start': '2015-04-29',
      'end': '2015-05-11',
      'types': [
        'impressions',
        'url_clicks'
      ]
    },
    'groupings': {
      'engagements_by_type': {
        'group_by': [
          'engagement.type'
        ]
      }  
    }
  }
  
  headers = { 'content-type': 'application/json' }

  oauth = get_oauth()
  req = requests.post(url=API_URL, data=json.dumps(params), headers=headers, auth=oauth)
  print req.text

pip install requests