Package: facebook-scraper
Facebook ScraperScrape Facebook public pages without an API key. Inspired bytwitter-scraper.InstallTo install the latest release from PyPI:pipinstallfacebook-scraperOr, to install the latest master branch:pipinstallgit+https://github.com/kevinzg/facebook-scraper.gitUsageSend the uniquepage name, profile name, or IDas the first parameter and you're good to go:>>>fromfacebook_scraperimportget_posts>>>forpostinget_posts('nintendo',pages=1):...print(post['text'][:50])...ThefinalstepontheroadtotheSuperSmashBrosWe’reheadedtoPAXEast3/28-3/31withnewgamesOptional parameters(For theget_postsfunction).group: group id, to scrape groups instead of pages. Default isNone.pages: how many pages of posts to request, the first 2 pages may have no results, so try with a number greater than 2. Default is 10.timeout: how many seconds to wait before timing out. Default is 30.credentials: tuple of user and password to login before requesting the posts. Default isNone.extra_info: bool, if true the function will try to do an extra request to get the post reactions. Default is False.youtube_dl: bool, use Youtube-DL for (high-quality) video extraction. You need to have youtube-dl installed on your environment. Default is False.post_urls: list, URLs or post IDs to extract posts from. Alternative to fetching based on username.cookies: One of:The path to a file containing cookies in Netscape or JSON format. You can extract cookies from your browser after logging into Facebook with an extension likeGet Cookies.txt (Chrome)orCookie Quick Manager (Firefox). Make sure that you include both the c_user cookie and the xs cookie, you will get an InvalidCookies exception if you don't.ACookieJarA dictionary that can be converted to a CookieJar withcookiejar_from_dictThe string"from_browser"to try extract Facebook cookies from your browseroptions: Dictionary of options. Setoptions={"comments": True}to extract comments, setoptions={"reactors": True}to extract the people reacting to the post.
Bothcommentsandreactorscan also be set to a number to set a limit for the amount of comments/reactors to retrieve.
Setoptions={"progress": True}to get atqdmprogress bar while extracting comments and replies.
Setoptions={"allow_extra_requests": False}to disable making extra requests when extracting post data (required for some things like full text and image links).
Setoptions={"posts_per_page": 200}to request 200 posts per page. The default is 4.CLI usage$facebook-scraper--filenamenintendo_page_posts.csv--pages10nintendoRunfacebook-scraper --helpfor more details on CLI usage.Note:If you get aUnicodeEncodeErrortry adding--encoding utf-8.Post example{'available':True,'comments':459,'comments_full':None,'factcheck':None,'fetched_time':datetime.datetime(2021,4,20,13,39,53,651417),'image':'https://scontent.fhlz2-1.fna.fbcdn.net/v/t1.6435-9/fr/cp0/e15/q65/58745049_2257182057699568_1761478225390731264_n.jpg?_nc_cat=111&ccb=1-3&_nc_sid=8024bb&_nc_ohc=ygH2fPmfQpAAX92ABYY&_nc_ht=scontent.fhlz2-1.fna&tp=14&oh=7a8a7b4904deb55ec696ae255fff97dd&oe=60A36717','images':['https://scontent.fhlz2-1.fna.fbcdn.net/v/t1.6435-9/fr/cp0/e15/q65/58745049_2257182057699568_1761478225390731264_n.jpg?_nc_cat=111&ccb=1-3&_nc_sid=8024bb&_nc_ohc=ygH2fPmfQpAAX92ABYY&_nc_ht=scontent.fhlz2-1.fna&tp=14&oh=7a8a7b4904deb55ec696ae255fff97dd&oe=60A36717'],'is_live':False,'likes':3509,'link':'https://www.nintendo.com/amiibo/line-up/','post_id':'2257188721032235','post_text':'Don’t let this diminutive version of the Hero of Time fool you, ''Young Link is just as heroic as his fully grown version! Young ''Link joins the Super Smash Bros. series of amiibo figures!\n''\n''https://www.nintendo.com/amiibo/line-up/','post_url':'https://facebook.com/story.php?story_fbid=2257188721032235&id=119240841493711','reactions':{'haha':22,'like':2657,'love':706,'sorry':1,'wow':123},# if `extra_info` was set'reactors':None,'shared_post_id':None,'shared_post_url':None,'shared_text':'','shared_time':None,'shared_user_id':None,'shared_username':None,'shares':441,'text':'Don’t let this diminutive version of the Hero of Time fool you, ''Young Link is just as heroic as his fully grown version! Young Link ''joins the Super Smash Bros. series of amiibo figures!\n''\n''https://www.nintendo.com/amiibo/line-up/','time':datetime.datetime(2019,4,30,5,0,1),'user_id':'119240841493711','username':'Nintendo','video':None,'video_id':None,'video_thumbnail':None,'w3_fb_url':'https://www.facebook.com/Nintendo/posts/2257188721032235'}NotesThere is no guarantee that every field will be extracted (they might beNone).Group posts may be missing some fields liketimeandpost_url.Group scraping may return only one page and not work on private groups.If you scrape too much, Facebook might temporarily ban your IP.The vast majority of unique IDs on facebook (post IDs, video IDs, photo IDs, comment IDs, profile IDs, etc) can be appended tohttps://www.facebook.com/to result in a redirect to the corresponding object.Some functions (such as extracting reactions) require you to be logged into Facebook (pass cookies). If something isn't working as expected, try pass cookies and see if that fixes it.ProfilesTheget_profilefunction can extract information from a profile's about section. Pass in the account name or ID as the first parameter.Note that Facebook serves different information depending on whether you're logged in (cookies parameter), such as Date of birth and Gender. Usage:fromfacebook_scraperimportget_profileget_profile("zuck")# Or get_profile("zuck", cookies="cookies.txt")Outputs:{'About':"I'm trying to make the world a more open place.",'Education':'Harvard University\n''Computer Science and Psychology\n''30 August 2002 - 30 April 2004\n''Phillips Exeter Academy\n''Classics\n''School year 2002\n''Ardsley High School\n''High School\n''September 1998 - June 2000','Favourite Quotes':'"Fortune favors the bold."\n''- Virgil, Aeneid X.284\n''\n''"All children are artists. The problem is how to remain ''an artist once you grow up."\n''- Pablo Picasso\n''\n''"Make things as simple as possible but no simpler."\n''- Albert Einstein','Name':'Mark Zuckerberg','Places lived':[{'link':'/profile.php?id=104022926303756&refid=17','text':'Palo Alto, California','type':'Current town/city'},{'link':'/profile.php?id=105506396148790&refid=17','text':'Dobbs Ferry, New York','type':'Home town'}],'Work':'Chan Zuckerberg Initiative\n''1 December 2015 - Present\n''Facebook\n''Founder and CEO\n''4 February 2004 - Present\n''Palo Alto, California\n''Bringing the world closer together.'}To extract friends, pass the argumentfriends=True, or to limit the amount of friends retrieved, setfriendsto the desired number.Group infoTheget_group_infofunction can extract info about a group. Pass in the group name or ID as the first parameter.Note that in order to see the list of admins, you need to be logged in (cookies parameter).Usage:fromfacebook_scraperimportget_group_infoget_group_info("makeupartistsgroup")# or get_group_info("makeupartistsgroup", cookies="cookies.txt")Output:{'admins':[{'link':'/africanstylemagazinecom/?refid=18','name':'African Style Magazine'},{'link':'/connectfluencer/?refid=18','name':'Everythingbrightandbeautiful'},{'link':'/Kaakakigroup/?refid=18','name':'Kaakaki Group'},{'link':'/opentohelp/?refid=18','name':'Open to Help'}],'id':'579169815767106','members':6814229,'name':'HAIRSTYLES','type':'Public group'}To-DoAsync supportImage galleries(imagesentry)Profiles or post authors(get_profile())Comments(withoptions={'comments': True})Alternatives and related projectsfacebook-post-scraper. Has comments. Uses Selenium.facebook-scraper-selenium. "Scrape posts from any group or user into a .csv file without needing to register for any API access".Ultimate Facebook Scraper.  "Scrapes almost everything about a Facebook user's profile". Uses Selenium.Unofficial APIs. List of unofficial APIs for various services, none for Facebook for now, but might be worth to check in the future.major-scrapy-spiders. Has a profile spider for Scrapy.facebook-page-post-scraper. Seems abandoned.FBLYZE. Fork (?).RSSHub. Generates an RSS feed from Facebook pages.RSS-Bridge. Also generates RSS feeds from Facebook pages.