==============================
facebook-page-info-scraper
==============================
.. image:: https://img.shields.io/pypi/v/facebook-page-info-scraper.svg
:target: https://pypi.python.org/pypi/facebook-page-info-scraper
:alt: Latest Version
.. image:: https://img.shields.io/pypi/pyversions/facebook-page-info-scraper.svg
:target: https://pypi.python.org/pypi/facebook-page-info-scraper
:alt: Supported Python Versions
.. image:: https://static.pepy.tech/badge/facebook-page-info-scraper
:target: https://pepy.tech/project/facebook-page-info-scraper
:alt: Downloads
.. image:: https://static.pepy.tech/badge/facebook-page-info-scraper/month
:target: https://pepy.tech/project/facebook-page-info-scraper
:alt: Monthly Downloads
.. image:: https://static.pepy.tech/badge/facebook-page-info-scraper/week
:target: https://pepy.tech/project/facebook-page-info-scraper
:alt: Weekly Downloads
Introduction
------------
`facebook-page-info-scraper` is a Python package that provides a convenient way to crawl information from Facebook pages. With this package, you can scrape Facebook data with unlimited calls. Whether you're a researcher, a data enthusiast, or a developer working on Facebook-related projects, this library simplifies the data extraction process. It uses Selenium for web scraping and retrieves Facebook page details such as the page name, category, address, email, follower count, and more.
Support the Project
-------------------
If you find this project helpful, consider supporting by buying me a sandwich! 🥪
.. image:: https://github.com/wael-sudo2/bumecoffe/blob/main/buy-me-a-sandiwch-button.png
:alt: Buy Me A Sandwich
:target: https://www.buymeacoffee.com/sp0t__
Dictionary Contents
-------------------
This section provides an overview of the dictionary contents.
Dictionary Fields
~~~~~~~~~~~~~~~~~
- `page_name`: The name of the page.
- `location`: The location of the page.
- `email`: The email associated with the page.
- `phone_number`: The phone number associated with the page.
- `social_media_links`: Links to the page's social media accounts.
- `page_website`: The website link associated with the page.
- `page_category`: The category of the page.
- `page_followers`: The number of followers.
- `page_following`: The number of following.
- `page_likes`: The number of likes.
- `page_rate`: The page rate.
- `review_number`: The number of reviews.
This section provides an overview of the dictionary keys and types.
Dictionary Keys
~~~~~~~~~~~~~~~
- `page_name`: string
- `location`: string or None
- `email`: string or None
- `phone_number`: string or list of strings or None
- `social_media_links`: string or list of strings or None
- `page_website`: string or list of strings or None
- `page_category`: string
- `page_followers`: string
- `page_following`: string
- `page_likes`: string
- `page_rate`: string
- `review_number`: string
Installation
------------
Use pip to install the package:
.. code-block:: shell
pip install facebook_page_info_scraper
Usage
-----
To use the package, import the `FacebookPageInfoScraper` class and create an instance:
.. code-block:: python
from facebook_page_info_scraper import FacebookPageInfoScraper
# providing the page URL
page_url = 'https://www.facebook.com/example-page'
# Create an instance of the scraper
scraper = FacebookPageInfoScraper(link=page_url)
page_info = scraper.get_page_info()
# Print page details
print(page_info)
page_info = {
'page_name': 'Example Page',
'location': 'Some Location',
'email': 'example@example.com',
'phone_number': '+33 536337',
'social_media_links': 'www.instagram.com/example',
'page_website': 'http://example.com',
'page_category': 'Some category',
'page_likes': '36,565',
'page_followers': '38,225'
'page_following': '120'
'page_rate': '33'
'review_number': '4.6'
}
To use the `facebook_page_info_scraper` with a specific user profile:
.. code-block:: python
from facebook_page_info_scraper import FacebookPageInfoScraper
# providing the page URL
page_url = 'https://www.facebook.com/example-page'
# provide location where Chrome stores profiles
profiles_path = r'C:\Users\<username>\AppData\Local\Google\Chrome\User Data' # make sure to prefix the path with r'' to create a raw string
# provide the profile name with which we want to open browser
profile = r'Profile 1' # make sure to prefix it with r'' to create a raw string
# Create an instance of the scraper
scraper = FacebookPageInfoScraper(link=page_url, browser_profiles_path=profiles_path, profile_name=profile)
page_info = scraper.get_page_info()
* To locate your Chrome profile path, you can usually find it at:
- **Windows:**
``C:\Users\<username>\AppData\Local\Google\Chrome\User Data``
- **macOS:**
``/Users/<username>/Library/Application Support/Google/Chrome/``
- **Linux:**
``~/.config/google-chrome/`` (replace `~` with your home directory)
Contributing
------------
Contributions are welcome! If you find any issues or have suggestions for improvement, please feel free to open an issue or submit a pull request on the GitHub repository.
License
-------
This project is licensed under the MIT License. See the LICENSE file for more information.
Raw data
{
"_id": null,
"home_page": "https://github.com/wael-sudo2/facebook-page-info-scraper",
"name": "facebook-page-info-scraper",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "facebook scraping, scraping, facebook crawler, facebook page, selenium, crawler, scraper, facebook",
"author": "Wael Hkiri",
"author_email": "wael.hkiri.dev@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/09/53/b8a0729d012539e30b3a5891ba378925b4f3e008808460445dca1d167111/facebook_page_info_scraper-1.1.6.tar.gz",
"platform": null,
"description": "==============================\nfacebook-page-info-scraper\n==============================\n\n.. image:: https://img.shields.io/pypi/v/facebook-page-info-scraper.svg\n :target: https://pypi.python.org/pypi/facebook-page-info-scraper\n :alt: Latest Version\n.. image:: https://img.shields.io/pypi/pyversions/facebook-page-info-scraper.svg\n :target: https://pypi.python.org/pypi/facebook-page-info-scraper\n :alt: Supported Python Versions\n.. image:: https://static.pepy.tech/badge/facebook-page-info-scraper\n :target: https://pepy.tech/project/facebook-page-info-scraper\n :alt: Downloads\n.. image:: https://static.pepy.tech/badge/facebook-page-info-scraper/month\n :target: https://pepy.tech/project/facebook-page-info-scraper\n :alt: Monthly Downloads\n.. image:: https://static.pepy.tech/badge/facebook-page-info-scraper/week\n :target: https://pepy.tech/project/facebook-page-info-scraper\n :alt: Weekly Downloads\n\nIntroduction\n------------\n`facebook-page-info-scraper` is a Python package that provides a convenient way to crawl information from Facebook pages. With this package, you can scrape Facebook data with unlimited calls. Whether you're a researcher, a data enthusiast, or a developer working on Facebook-related projects, this library simplifies the data extraction process. It uses Selenium for web scraping and retrieves Facebook page details such as the page name, category, address, email, follower count, and more.\n\nSupport the Project\n-------------------\nIf you find this project helpful, consider supporting by buying me a sandwich! \ud83e\udd6a\n\n.. image:: https://github.com/wael-sudo2/bumecoffe/blob/main/buy-me-a-sandiwch-button.png\n :alt: Buy Me A Sandwich\n :target: https://www.buymeacoffee.com/sp0t__\n\nDictionary Contents\n-------------------\n\nThis section provides an overview of the dictionary contents.\n\nDictionary Fields\n~~~~~~~~~~~~~~~~~\n\n- `page_name`: The name of the page.\n- `location`: The location of the page.\n- `email`: The email associated with the page.\n- `phone_number`: The phone number associated with the page.\n- `social_media_links`: Links to the page's social media accounts.\n- `page_website`: The website link associated with the page.\n- `page_category`: The category of the page.\n- `page_followers`: The number of followers.\n- `page_following`: The number of following.\n- `page_likes`: The number of likes.\n- `page_rate`: The page rate.\n- `review_number`: The number of reviews.\n\nThis section provides an overview of the dictionary keys and types.\n\nDictionary Keys\n~~~~~~~~~~~~~~~\n\n- `page_name`: string\n- `location`: string or None\n- `email`: string or None\n- `phone_number`: string or list of strings or None\n- `social_media_links`: string or list of strings or None\n- `page_website`: string or list of strings or None\n- `page_category`: string\n- `page_followers`: string\n- `page_following`: string\n- `page_likes`: string\n- `page_rate`: string\n- `review_number`: string\n\nInstallation\n------------\n\nUse pip to install the package:\n\n.. code-block:: shell\n\n pip install facebook_page_info_scraper\n\nUsage\n-----\n\nTo use the package, import the `FacebookPageInfoScraper` class and create an instance:\n\n.. code-block:: python\n\n from facebook_page_info_scraper import FacebookPageInfoScraper\n \n # providing the page URL\n page_url = 'https://www.facebook.com/example-page'\n \n # Create an instance of the scraper\n scraper = FacebookPageInfoScraper(link=page_url)\n \n page_info = scraper.get_page_info()\n\n # Print page details\n print(page_info)\n\n page_info = {\n 'page_name': 'Example Page', \n 'location': 'Some Location', \n 'email': 'example@example.com', \n 'phone_number': '+33 536337',\n 'social_media_links': 'www.instagram.com/example',\n 'page_website': 'http://example.com',\n 'page_category': 'Some category',\n 'page_likes': '36,565',\n 'page_followers': '38,225'\n 'page_following': '120'\n 'page_rate': '33'\n 'review_number': '4.6'\n }\n\nTo use the `facebook_page_info_scraper` with a specific user profile:\n\n.. code-block:: python\n\n from facebook_page_info_scraper import FacebookPageInfoScraper\n \n # providing the page URL\n page_url = 'https://www.facebook.com/example-page'\n\n # provide location where Chrome stores profiles\n profiles_path = r'C:\\Users\\<username>\\AppData\\Local\\Google\\Chrome\\User Data' # make sure to prefix the path with r'' to create a raw string \n\n # provide the profile name with which we want to open browser\n profile = r'Profile 1' # make sure to prefix it with r'' to create a raw string \n\n # Create an instance of the scraper\n scraper = FacebookPageInfoScraper(link=page_url, browser_profiles_path=profiles_path, profile_name=profile)\n\n page_info = scraper.get_page_info()\n\n* To locate your Chrome profile path, you can usually find it at:\n\n - **Windows:**\n ``C:\\Users\\<username>\\AppData\\Local\\Google\\Chrome\\User Data``\n - **macOS:**\n ``/Users/<username>/Library/Application Support/Google/Chrome/``\n - **Linux:**\n ``~/.config/google-chrome/`` (replace `~` with your home directory)\n\nContributing\n------------\n\nContributions are welcome! If you find any issues or have suggestions for improvement, please feel free to open an issue or submit a pull request on the GitHub repository.\n\nLicense\n-------\n\nThis project is licensed under the MIT License. See the LICENSE file for more information.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python package capable of crawling Facebook page information.",
"version": "1.1.6",
"project_urls": {
"Download": "https://github.com//wael-sudo2/facebook-page-info-scraper/archive/refs/tags/v1.1.6.tar.gz",
"Homepage": "https://github.com/wael-sudo2/facebook-page-info-scraper"
},
"split_keywords": [
"facebook scraping",
" scraping",
" facebook crawler",
" facebook page",
" selenium",
" crawler",
" scraper",
" facebook"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8fa4b99b9be8baffd7002dac3d6a1c6117a394253a6d343a76c6a7a0631b0cba",
"md5": "c4de26ecf54cbc939c7b419e52313261",
"sha256": "f129d5f0dc585d35574014bb74ce6c80c6fe180ee10a3c33db60641878032ca8"
},
"downloads": -1,
"filename": "facebook_page_info_scraper-1.1.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c4de26ecf54cbc939c7b419e52313261",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 9361,
"upload_time": "2024-10-20T21:28:18",
"upload_time_iso_8601": "2024-10-20T21:28:18.384889Z",
"url": "https://files.pythonhosted.org/packages/8f/a4/b99b9be8baffd7002dac3d6a1c6117a394253a6d343a76c6a7a0631b0cba/facebook_page_info_scraper-1.1.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0953b8a0729d012539e30b3a5891ba378925b4f3e008808460445dca1d167111",
"md5": "b2dd8a9c59fa58576e5286cb2b9db766",
"sha256": "6f812cc00b11959d69b3a3af13a37b6ef5ba48218e90759cae9f99fa67208f8a"
},
"downloads": -1,
"filename": "facebook_page_info_scraper-1.1.6.tar.gz",
"has_sig": false,
"md5_digest": "b2dd8a9c59fa58576e5286cb2b9db766",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 10744,
"upload_time": "2024-10-20T21:28:20",
"upload_time_iso_8601": "2024-10-20T21:28:20.030406Z",
"url": "https://files.pythonhosted.org/packages/09/53/b8a0729d012539e30b3a5891ba378925b4f3e008808460445dca1d167111/facebook_page_info_scraper-1.1.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-20 21:28:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "wael-sudo2",
"github_project": "facebook-page-info-scraper",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "facebook-page-info-scraper"
}