Skip to main content

Facebook GraphQL Scraper - No login required, simple API to scrape public Facebook posts

Project description

whatisfacebook

Scrape public Facebook posts without login using a simple, requests-based scraper.

This project is a streamlined fork developed from the foundational work at FaustRen/facebook-graphql-scraper.

Improvements

  • Lightweight: Uses only requests to fetch user posts—no browser, Selenium, or Playwright required.
  • Focused: Removed login-dependent features to focus exclusively on public page scraping.
  • Efficient: Optimized for speed and minimal dependency overhead.

Install

pip install whatisfacebook

Quick Example

from whatisfacebook import FacebookGraphqlScraper

# Initialize the scraper
fb = FacebookGraphqlScraper()

# Get posts from a specific username with a day limit
result = fb.get_user_posts("honghotduongpho.official00", days_limit=3)

for post in result["data"]:
    print(f"Content: {post['context']}")
    print(f"Likes: {post['reaction_count.count']}")
    print("-" * 20)

Results

The result object returns a structured dictionary containing profile info and a list of post data:

{
"fb_username_or_userid": "100063640556423",
    "profile": [
        "Life at VNG | Ho Chi Minh City"
    ],
    "data": [
        {
            "post_id": "1601334011997935",
            "post_url": "https://www.facebook.com/1601334011997935",
            "username_or_userid": "100063640556423",
            "owing_profile": {
                "__typename": "User",
                "name": "Life at VNG",
                "short_name": "Life at VNG",
                "id": "100063640556423"
            },
            "published_date": "2026-03-28T11:58:04",
            "published_date2": "2026-03-28",
            "time": 1774673884,
            "reaction_count.count": 16,
            "comment_rendering_instance.comments.total_count": null,
            "share_count.count": null,
            "sub_reactions": {
                "Thích": 10,
                "Yêu thích": 5,
                "Wow": 1
            },
            "context": "[HÀ NỘI] BUSINESS DEVELOPMENT FRESHER 2026 “BẬT ĐỊNH VỊ” HẸN GẶP SINH VIÊN THỦ ĐÔ 📍\n✨ Ứng tuyển Business Development Fresher 2026 tại: https://bit.ly/4rRnqaG \n\nBusiness Development Fresher 2026 (BDF 2026) - chương trình tuyển chọn và phát triển thế hệ Business Development tiềm năng của VNG ZingPlay Game Studios đã sẵn sàng gặp gỡ và giao lưu cùng các bạn sinh viên Hà Nội.\n\n👉 Nếu bạn đam mê khám phá thị trường Game,...",
            "video_view_count": null
        },
        ...
    ],
    "raw_data": [
        <raw_facebook_meta_response>
    ]
}

Extracting Additional Data

Note: If you need more data fields than what's provided in data, you can manually extract additional information from raw_data. This contains the complete raw Facebook GraphQL API responses.

result = fb.get_user_posts("page_username", days_limit=3)

# Access raw API responses for custom data extraction
for raw_response in result["raw_data"]:
    # Extract any custom fields you need
    custom_field = raw_response.get("your_custom_field")

Credits

Thank you to the original project owner FaustRen and the facebook-graphql-scraper repository for the foundational work that made this simplified version possible.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

whatisfacebook-0.1.1.tar.gz (18.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

whatisfacebook-0.1.1-py3-none-any.whl (18.9 kB view details)

Uploaded Python 3

File details

Details for the file whatisfacebook-0.1.1.tar.gz.

File metadata

  • Download URL: whatisfacebook-0.1.1.tar.gz
  • Upload date:
  • Size: 18.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.8

File hashes

Hashes for whatisfacebook-0.1.1.tar.gz
Algorithm Hash digest
SHA256 ea813aa657d8052359a1a7e8f587a78413fd2799106d949a6a16b7bae3a88456
MD5 6d68887dd33cd65bc43b252ea0749a02
BLAKE2b-256 cb6adfcdfdb5e20e7808ab8e07d71724030a17abc49b9aef88c5722a442d9e45

See more details on using hashes here.

File details

Details for the file whatisfacebook-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for whatisfacebook-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 aeb54fa12ee39cbff022f82888b0aff986dc5a2b31bc24529fce26edd2a6e49b
MD5 0abe2a877270f78d51e0b787cb07f0b1
BLAKE2b-256 57065b4d59fe6fc2341b3669a1325edff335c1a7ea3c28ab7c58280494a0607a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page