instagram graph api insights with python

Author: jstolpe

instagram_graph_api/python/insights.py

@@ -0,0 +1,95 @@
+from defines import getCreds, makeApiCall
+
+def getUserMedia( params ) :
+	""" Get users media
+	
+	API Endpoint:
+		https://graph.facebook.com/{graph-api-version}/{ig-user-id}/media?fields={fields}
+
+	Returns:
+		object: data from the endpoint
+
+	"""
+
+	endpointParams = dict() # parameter to send to the endpoint
+	endpointParams['fields'] = 'id,caption,media_type,media_url,permalink,thumbnail_url,timestamp,username' # fields to get back
+	endpointParams['access_token'] = params['access_token'] # access token
+
+	url = params['endpoint_base'] + params['instagram_account_id'] + '/media' # endpoint url
+
+	return makeApiCall( url, endpointParams, params['debug'] ) # make the api call
+
+def getMediaInsights( params ) :
+	""" Get insights for a specific media id
+	
+	API Endpoint:
+		https://graph.facebook.com/{graph-api-version}/{ig-media-id}/insights?metric={metric}
+
+	Returns:
+		object: data from the endpoint
+
+	"""
+	endpointParams = dict() # parameter to send to the endpoint
+	endpointParams['metric'] = params['metric'] # fields to get back
+	endpointParams['access_token'] = params['access_token'] # access token
+
+	url = params['endpoint_base'] + params['latest_media_id'] + '/insights' # endpoint url
+
+	return makeApiCall( url, endpointParams, params['debug'] ) # make the api call
+
+def getUserInsights( params ) :
+	""" Get insights for a users account
+	
+	API Endpoint:
+		https://graph.facebook.com/{graph-api-version}/{ig-user-id}/insights?metric={metric}&period={period}
+
+	Returns:
+		object: data from the endpoint
+
+	"""
+
+	endpointParams = dict() # parameter to send to the endpoint
+	endpointParams['metric'] = 'follower_count,impressions,profile_views,reach' # fields to get back
+	endpointParams['period'] = 'day' # period
+	endpointParams['access_token'] = params['access_token'] # access token
+
+	url = params['endpoint_base'] + params['instagram_account_id'] + '/insights' # endpoint url
+
+	return makeApiCall( url, endpointParams, params['debug'] ) # make the api call
+
+params = getCreds() # get creds
+response = getUserMedia( params ) # get users media from the api
+
+print "\n---- LATEST POST -----\n" # section header
+print "\tLink to post:" # link to post
+print "\t" + response['json_data']['data'][0]['permalink'] # link to post
+print "\n\tPost caption:" # post caption
+print "\t" + response['json_data']['data'][0]['caption'] # post caption
+print "\n\tMedia Type:" # type of media
+print "\t" + response['json_data']['data'][0]['media_type'] # type of media
+print "\n\tPosted at:" # when it was posted
+print "\t" + response['json_data']['data'][0]['timestamp'] # when it was posted
+
+params['latest_media_id'] = response['json_data']['data'][0]['id'] # store latest post id
+
+if 'VIDEO' == response['json_data']['data'][0]['media_type'] : # media is a video
+	params['metric'] = 'engagement,impressions,reach,saved,video_views'
+else : # media is an image
+	params['metric'] = 'engagement,impressions,reach,saved'
+
+response = getMediaInsights( params ) # get insights for a specific media id
+
+print "\n---- LATEST POST INSIGHTS -----\n" # section header
+
+for insight in response['json_data']['data'] : # loop over post insights
+	print "\t" + insight['title'] + " (" + insight['period'] + "): " + str( insight['values'][0]['value'] ) # display info
+
+response = getUserInsights( params ) # get insights for a user
+
+print "\n---- DAILY USER ACCOUNT INSIGHTS -----\n" # section header
+
+for insight in response['json_data']['data'] : # loop over user account insights
+	print "\t" + insight['title'] + " (" + insight['period'] + "): " + str( insight['values'][0]['value'] ) # display info
+
+	for value in insight['values'] : # loop over each value
+		print "\t\t" + value['end_time'] + ": " + str( value['value'] ) # print out counts for the date