/Ultimate-Facebook-Scraper

🔥 A bot which scrapes almost everything about a Facebook user's profile including all public posts/statuses available on the user's timeline, uploaded photos, tagged photos, videos, friends list and their profile photos (including Followers, Following, Work Friends, College Friends etc).

Primary LanguagePythonMIT LicenseMIT

🔥 Ultimate Facebook Scrapper

DOI

Open Source Love svg1 GitHub Forks Build Status GitHub Issues contributions welcome

A bot which scrapes almost everything about a facebook user's profile including

  • uploaded photos
  • tagged photos
  • videos
  • friends list and their profile photos (including Followers, Following, Work Friends, College Friends etc)
  • and all public posts/statuses available on the user's timeline.

The best thing about this scraper is that the data is scraped in an organized format so that it can be used for educational/research purpose by researchers. Moreover, this scraper does not use Facebook's Graph API so there are no rate limiting issues as such.

This tool is being used by thousands of developers weekly and we are pretty amazed at this response! Thankyou guys!🎉

For details regarding citing/referencing this tool for your research, check the 'Citation' section below.

Note

At its core, this tool uses xpaths of 'divs' to extract data from them. Since Facebook keeps on updating its site frequently and the 'divs' get changed. Consequently, we have to update the divs accordingly to correctly scrape the data.

The developers of this tool have devoted a lot of time and effort in developing and most importantly maintaining this tool for quite a lot time now. In order to keep this amazing tool alive, we need support from you geeks.

The code is pretty intuitive and easy to understand, so you can update the relevant xpaths in the code when you feel that you have tried many profiles and the data isn't being scraped for any of them (that's a hint that Facebook has updated their site) and generate a pull request. That's quite an easy thing to do. Thanks!

Sample

Screenshot


Usage

Installation

You will need to install latest version of Google Chrome. Moreover, you need to install selenium module as well using

pip install selenium

Run the code using Python 3. Also, the code is multi-platform and is tested on both Windows and Linux. The tool uses latest version of Chrome Web Driver. I have placed the webdriver along with the code but if that version doesn't work then replace the chrome web driver with the latest one.

How to Run

There's a file named "input.txt". You can add as many profiles as you want in the following format with each link on a new line:

https://www.facebook.com/andrew.ng.96
https://www.facebook.com/zuck

Make sure the link only contains the username or id number at the end and not any other stuff. Make sure its in the format mentioned above.

Note: There are two modes to download Friends Profile Pics and the user's Photos: Large Size and Small Size. You can change the following variables. By default they are set to Small Sized Pics because its really quick while Large Size Mode takes time depending on the number of pictures to download

# whether to download the full image or its thumbnail (small size)
# if small size is True then it will be very quick else if its False then it will open each photo to download it
# and it will take much more time
friends_small_size = True
photos_small_size = True

Citation

DOI

If you use this tool for your research, then kindly cite it. Click the above badge for more information regarding the complete citation for this tool and diffferent citation formats like IEEE, APA etc.


Important Message

This tool is for research purposes only. Hence, the developers of this tool won't be responsible for any misuse of data collected using this tool.


Authors

You can get in touch with us on our LinkedIn Profiles:

Hassaan Elahi

I am a part time Django & ReactJS Developer. Along with Web Development, I also did some amazing projects on Deep Learning and Machine Learning. For more, connect with me on linkdin.

LinkedIn Link

or Follow me for latest projects on github: GitHub Follow

Haris Muneer

LinkedIn Link

You can also follow my GitHub Profile to stay updated about my latest projects: GitHub Follow

If you liked the repo then kindly support it by giving it a star ⭐!

Contributions Welcome

forthebadge

If you find any bug in the code or have any improvements in mind then feel free to generate a pull request.

Issues

GitHub Issues

If you face any issue, you can create a new issue in the Issues Tab and I will be glad to help you out.

License

MIT

Copyright (c) 2018-present, harismuneer, Hassaan-Elahi