Prerequisite: Facebook API | Set-1, Set-2
In this article we will be discussing three methods:
- search
- get_connections
- get_allconnections
search method:
The valid value types are place and placetopic.
Parameters:
id: It is a string containing a valid value.
args: This is optional and they need to passed a query params.
Example: Get details of all places that are near Connaught Place Delhi. The Latitude and Longitude of Connaught Place are – 28.6304, 77.2177
import json import facebook   def main():     token = "Please replace with your access token"    graph = facebook.GraphAPI(token)       places = graph.search(type ='place', center ='28.6304, 77.2177',                                             fields ='name, location')       for place in places['data']:         print('%s %s' %(place['name'].encode(), place['location'].get('zip')))       if __name__ == '__main__':     main() |
Please refer to the link Search Reference for complete list of fields that can used.
get_connections method :
This methods aims at returning all connections or we can say Edges for the mentioned object as dict.
Parameters:
id:A string specifying the unique id for the resource under question.
connection name: A string specifying the connection or edges between the objects.
If connection name parameter is left empty then get_connections method will simply return the basic information of the authenticated user.
Example #1: We want to find out the total count of the number of Friends of the active user.
import json import facebook   def main():     token = "Please replace this with your access token"    graph = facebook.GraphAPI(token)     friends = graph.get_connections(id ='me', connection_name ='friends')     print(json.dumps(friends, indent = 4))   if __name__ == '__main__':     main() |
Example #2: We want to get list of all posts from a page. For this, we will be using get_connections and later on, we will demonstrate how to use get_all_connections method.
import json import facebook   def main():     token = "Please replace this with your PAGE Access Token"    graph = facebook.GraphAPI(token)     posts_25 = graph.get_connections(id ='PAGE_ID', connection_name ='posts',                                                   fields ='id, created_time')       print(json.dumps(posts_25, indent = 4))   if __name__ == '__main__':     main() |
Note: This example by default print latest 25 posts. You can add a filter for the post using limit(…) to set the limit for the number of the posts.
Example #3: In this example we will use get_connections method to print all the comments for the posts in reverse_chronological order, show sub comments including hidden comments and also show the total count of the comments.
import json import facebook   def main():     token = "Please replace this with your PAGE Access Token"    graph = facebook.GraphAPI(token)     posts_25 = graph.get_connections(id ='POST_ID', connection_name ='comments',                                      include_hidden = True, order ='reverse_chronological',                                      filter ='stream', summary ='total_count')       print(json.dumps(posts_25, indent = 4))   if __name__ == '__main__':     main() |
get_all_connections method :
Iterates over all pages returned by a get_connections call and yields the individual items.
Parameters:
id:A string specifying the unique id for the resource under question.
connection name: A string specifying the connection or edges between the objects.
Example #1: In this example I have used get_all_connections to list all the posts from a Page listed using the since datetime parameter.
import json import facebook from datetime import datetime    def main():     token = "Please replace this with your PAGE Access Token"    graph = facebook.GraphAPI(token)     posts_all = graph.get_all_connections(id ='PAGE_ID', connection_name ='posts',                                            fields ='created_time, id',                                            since = datetime(2017, 1, 1, 0, 0, 0))       for ind, post in enumerate(posts_all):      print(json.dumps(ind, indent = 4))      print(json.dumps(post, indent = 4))          if __name__ == '__main__':     main() |
References:
- https://developers.facebook.com/docs/marketing-api/insights/parameters
- https://developers.facebook.com/docs/graph-api/
