Facebook Scraper API

Python client for the GetSocialAPI Facebook Scraper API.

• Groups: resolve links, overview, paginated members
• Profiles: resolve links, About/contacts in raw GraphQL
• Connections: followers, followings, friends
• Raw responses — no transformations
• Automatic retries on 429/502/503, typed exceptions

Installation

pip install git+https://github.com/GetSocialAPI/Facebook-Scraper-API.git

Quickstart

from getsocialapi_facebook import Client

# Get your API key at https://getsocialapi.com/dashboard/
client = Client(api_key="gsa_live_...")  # or set GETSOCIALAPI_FB_API_KEY

# Resolve any group link (slug, m.facebook, share/g) to a group_id
group = client.fb.resolve("https://www.facebook.com/groups/freegarden/")
group_id = group["group_id"]

# Profile links resolve the same way
user = client.fb.resolve_profile("https://www.facebook.com/nasa")
user_id = user["user_id"]

# Group card
client.fb.overview(group_id)

# Members: raw GraphQL pages (1st -> data.group, 2nd+ -> data.fetch__Group)
page = client.fb.members(group_id)  # fixed page of 15 members
page["data"]["group"]["group_member_profiles"]["page_info"]["end_cursor"]

# Next page: pass page_info.end_cursor as `after`
client.fb.members(group_id, after="AQHTm5Xq…")  # end_cursor from page_info

Base URL: https://api.getsocialapi.com/fb — authenticate with the API key from your dashboard.

Client

Client(api_key=None, base_url="https://api.getsocialapi.com/fb", timeout=30, max_retries=3)

• api_key — your API key (env var GETSOCIALAPI_FB_API_KEY works too)

Methods

Full request/response reference with live examples: getsocialapi.com/docs — API Reference / Facebook.

Pagination

Every method returns one raw page. Pass the connection's page_info.end_cursor as after while has_next_page is true.

Cursors are reusable and not bound to a session; a broken or foreign cursor returns 400 Invalid Cursor — take end_cursor only from the connection's page_info, never from node fields.

posts, after = [], None
while True:
    page = client.fb.posts(user_id, after=after)
    tfu = page["data"]["profile"]["timeline_feed_units"]
    posts += [e["node"] for e in tfu["edges"]]
    pi = tfu.get("page_info") or {}
    if not pi.get("has_next_page") or not pi.get("end_cursor"):
        break
    after = pi["end_cursor"]

Response notes

• members page 1 lives in data.group, following pages in data.fetch__Group
• connection lists: can_see_follower_list: false means the list is hidden by privacy settings (only the count is available)

Errors

Only successful responses count against your quota. Plans and rate limits: getsocialapi.com/#pricing.

Support

• Telegram: @getsocialapi
• Email: hello@getsocialapi.com
• Website: getsocialapi.com
• Documentation: getsocialapi.com/docs
• Status: getsocialapi.com/status

License

MIT