Facebook Posts Scraper

What is Facebook Posts Scraper?

Facebook Posts Scraper automatically extracts posts from public Facebook Pages into structured data — post text, timestamps, engagement metrics, author details, media attachments, and more. No Facebook login or API token is required; just enter one or more public Page URLs and the scraper does the rest.

What can it do?

• Brand & competitor monitoring: Track posts from competitor or industry Pages in real time, so you never miss an important update, product launch, or campaign.
• Content research: Identify trending topics, high-performing post formats, and hashtag strategies from leading Pages in your niche.
• Social media analytics: Collect engagement data (reactions, comments, shares) at scale for sentiment analysis, trend research, or reporting.
• Lead generation: Extract publicly shared links and author information from industry Pages to discover new partnership or outreach opportunities.
• Automated monitoring: Replace manual Page checks with stable, exportable automated workflows that run on your schedule.

What data does Facebook Posts Scraper extract?

Data capabilities

• Public Page posts: Extracts post text, timestamps, engagement metrics, author details, media attachments, and external links from any publicly accessible Facebook Page — no login or API token required.
• GraphQL interception: The scraper intercepts Facebook's internal GraphQL API responses in real time, capturing structured data directly from the source. A DOM-based fallback ensures data is still extracted when GraphQL interception yields no results.
• Export-ready formats: Export results in 8 formats: CSV, JSON, JSONL, XLS, XLSX, HTML, XML, and RSS.
• Integrations: Connect with other tools via webhooks, the CoreClaw MCP server, or the REST API to automate your workflows.

Input

Facebook Page URLs (required) — startUrls

One or more public Facebook Page URLs to scrape. Each URL should point to a publicly accessible Facebook Page (brand, creator, public figure, etc.). The scraper opens each URL in a headless browser, dismisses any login modal that appears, intercepts GraphQL responses, and falls back to DOM parsing when needed.

Supported URL formats:

• Standard Page URLs: https://www.facebook.com/humansofnewyork/
• Page vanity URLs: https://www.facebook.com/nasa
• URLs with trailing paths: https://www.facebook.com/Meta/

Not supported: Private profiles, closed groups, event pages, or personal timelines — this scraper is designed exclusively for public Page timelines.

The startUrls field accepts a JSON array. Each element can be a plain URL string or an object with a url property.

Example — single URL:

{
  "startUrls": ["https://www.facebook.com/humansofnewyork/"]
}

Example — multiple URLs:

{
  "startUrls": [
    "https://www.facebook.com/humansofnewyork/",
    "https://www.facebook.com/nasa",
    "https://www.facebook.com/Meta/"
  ]
}

Results amount — resultsLimit

Maximum number of posts to extract per start URL. Set to 0 to scrape all available posts (the scraper will keep scrolling until no new posts are found). Default value is 20.

Include video subtitles — captionText

When enabled, the scraper attempts to extract subtitle/transcript text from video posts. This is a best-effort feature — subtitle availability depends on whether Facebook's GraphQL response includes caption data for a given video. Default is false.

Tip: Most public video posts do not include transcript data in the GraphQL response. Enable this option when you specifically need video text content, but expect that many videos may not have transcript data available.

Time range filtering

Use these two parameters to narrow down which posts to extract based on their publish time. You can use them individually or combine both to define a specific time window.

Posts newer than — onlyPostsNewerThan

Only keep posts published on or after this time. Posts published before this time are skipped. Supports the following formats:

Relative expressions are calculated from the current time. For example, 3 months means "from 3 months ago until now".

Posts older than — onlyPostsOlderThan

Only keep posts published on or before this time. Posts published after this time are skipped. Accepts the same formats as onlyPostsNewerThan.

Example — scraping posts from a specific date range:

{
  "startUrls": ["https://www.facebook.com/humansofnewyork/"],
  "onlyPostsNewerThan": "2025-01-01",
  "onlyPostsOlderThan": "2025-06-30",
  "resultsLimit": 0
}

Example — scraping recent posts only:

{
  "startUrls": ["https://www.facebook.com/nasa"],
  "onlyPostsNewerThan": "3 months",
  "resultsLimit": 50
}

Output

After each successful run, result data is generated in the Output panel. It is shown as a table by default, with category tabs for grouped browsing. You can also switch to JSON view with one click.

For export, you can download CSV, JSON, JSONL, XLS, XLSX, HTML, XML, or RSS. Before exporting, you can select or deselect specific fields, or download the complete view with all related data.

Complete JSON record

When the scraper processes a post, a complete record is returned. Here is a representative example showing the full output structure:

{
  "facebookUrl": "https://www.facebook.com/humansofnewyork/",
  "postId": "pfbid02xK9ExamplePostId5Tmw",
  "pageName": "Humans of New York",
  "url": "https://www.facebook.com/humansofnewyork/posts/pfbid02xK9ExamplePostId5Tmw",
  "time": "2025-07-14T18:32:00+00:00",
  "timestamp": 1752517920,
  "text": "I was sitting on a bench in Central Park, and this older gentleman sat down next to me. We started talking about life, dreams, and the things we wish we'd done differently.",
  "textReferences": [],
  "likes": 182400,
  "comments": 4320,
  "shares": 2150,
  "media": [
    {
      "url": "https://scontent.fbkk1-1.fbcdn.net/v/example_image.jpg",
      "thumbnail": "https://scontent.fbkk1-1.fbcdn.net/v/example_thumb.jpg",
      "width": 1080,
      "height": 1350,
      "type": "photo"
    }
  ],
  "userId": "10201496316671403",
  "userName": "Humans of New York",
  "userProfileUrl": "https://www.facebook.com/humansofnewyork/",
  "userProfilePic": "https://scontent.fbkk1-1.fbcdn.net/v/example_avatar.jpg",
  "user": {
    "id": "10201496316671403",
    "name": "Humans of New York",
    "profileUrl": "https://www.facebook.com/humansofnewyork/",
    "profilePic": "https://scontent.fbkk1-1.fbcdn.net/v/example_avatar.jpg"
  },
  "link": null,
  "reactionLikeCount": 134200,
  "reactionLoveCount": 38900,
  "reactionCareCount": 6100,
  "reactionHahaCount": 120,
  "reactionWowCount": 3080,
  "viewsCount": null,
  "collaborators": [],
  "inputUrl": "https://www.facebook.com/humansofnewyork/"
}

Output field reference

Note: Not all fields are guaranteed for every post. Fields like viewsCount, collaborators, and link are best-effort and may be null when the data is not available in the GraphQL response. Reaction breakdowns (reactionLikeCount, etc.) are best-effort; likes (total reaction count) is more reliably populated.

FAQ

General

How does Facebook Posts Scraper work?

The scraper connects to a headless browser (Camoufox or Chrome WebSocket), opens each Facebook Page URL you provide, and automatically dismisses any login modal that appears — Facebook's login prompt is a closable modal, not an authentication wall, so public Page content loads normally after dismissal.

Once the Page loads, the scraper intercepts Facebook's internal GraphQL API responses in real time to extract structured post data. It then scrolls down the Page to trigger additional GraphQL requests and load more posts. If GraphQL interception yields no results (for example, due to Facebook's internal response format changes), the scraper falls back to parsing the page's DOM for embedded JSON data.

All data is extracted without requiring a Facebook account, login credentials, or API token.

Does it require a Facebook login?

No. The scraper works entirely without login. It handles Facebook's login modals by dismissing them automatically, which is sufficient for accessing public Page content.

What types of Facebook pages can I scrape?

You can scrape any publicly accessible Facebook Page. This includes brand Pages, creator Pages, public figure Pages, and organization Pages. The key requirement is that the Page must be publicly viewable without login.

Private profiles, closed groups, personal timelines, and event pages are not supported by this scraper.

What is the maximum number of posts I can scrape?

There is no hard limit. The resultsLimit parameter controls how many posts are collected per run. Set it to 0 for unlimited — the scraper will keep scrolling until it runs out of new posts or hits the internal scroll limit. For most public Pages, you can expect to collect several hundred to a few thousand posts in a single run.

How fast is the scraper?

Speed depends on the number of posts you want, the Page's loading speed, and network conditions. A typical run collecting 50–100 posts from a single Page completes in a few minutes. Scraping multiple Pages runs them sequentially, so total time scales with the number of URLs.

Technical

How does GraphQL interception work?

When you open a Facebook Page, the browser makes API calls to Facebook's internal GraphQL endpoints to load post data. The scraper listens for these API responses in real time and extracts the structured JSON data directly from them. This is more reliable than parsing the rendered HTML, since the data comes straight from Facebook's data layer.

What happens when GraphQL interception doesn't work?

If no GraphQL responses are intercepted (which can happen if Facebook changes its internal API structure), the scraper automatically falls back to DOM parsing. It reads the page's HTML, extracts embedded JSON blobs from script tags, and parses them for post data. This fallback is best-effort but ensures the scraper remains functional even when Facebook's frontend changes.

How does the login modal dismissal work?

Facebook shows a login modal when unauthenticated users visit a Page. This modal is not an authentication wall — it's a dismissible dialog. The scraper clicks the close button (or presses Escape), removes any remaining dialog overlays via JavaScript, and unlocks page scrolling. This allows the Page content to load normally without requiring any credentials.

What are the scroll limits?

The scraper scrolls up to 30 times per Page URL. If 3 consecutive scrolls yield no new posts, the scraper stops scrolling for that URL. This prevents infinite scrolling on Pages with limited post history while still maximizing data collection for active Pages.

Can I scrape posts from a specific date range?

Yes. Use the onlyPostsNewerThan and onlyPostsOlderThan parameters to define a time window. The scraper filters posts by their publish timestamp and stops scrolling early once it encounters posts outside the window, which also improves efficiency.

Platform & integration

What export formats are supported?

You can download results in 8 formats: CSV, JSON, JSONL, XLS, XLSX, HTML, XML, and RSS. Choose the format that best fits your workflow — CSV or XLSX for spreadsheets, JSON/JSONL for programmatic processing, XML/RSS for feeds, and HTML for quick viewing.

Can I use this scraper via API?

Yes. You can use the CoreClaw REST API to run this scraper programmatically. The base URL is https://openapi.coreclaw.com, and every endpoint path starts with /api/v2. Authenticate with Authorization: Bearer YOUR_API_KEY.

A typical API workflow is:

1. Get the Worker's input schema from GET /api/v2/workers/{workerId}/input-schema.
2. Start a run with POST /api/v2/workers/{workerId}/runs, passing inputs under input.parameters.custom.
3. Save the returned data.run_slug.
4. Use GET /api/v2/worker-runs/{runId} to check run status.
5. Use GET /api/v2/worker-runs/{runId}/result to fetch results, or GET /api/v2/worker-runs/{runId}/result/export to export a file.

For full details, see the CoreClaw API documentation.

Can I connect this scraper with other tools?

Yes. You can use the CoreClaw REST API or MCP server to integrate with automation tools like Make, Zapier, n8n, or your own workflows. Use webhooks to trigger downstream actions when a scrape run completes.

Does this scraper cost extra?

No. This scraper is included in your CoreClaw plan. For details on plan limits and pricing, see the CoreClaw pricing page.

Is scraping Facebook data legal?

Scraping publicly available data is generally permissible in many jurisdictions, but legality depends on the specific data, your jurisdiction, your purpose, and how you handle personal information. This scraper only accesses publicly visible Page content without authentication. Always respect personal data and intellectual property rules, scrape only when you have a legitimate reason, and review Facebook's Terms of Service for your use case.

Feedback

We are continuously improving this scraper's performance and coverage. If you find a bug or notice missing fields, please provide the input settings you used, the approximate runtime, and a small output sample. You can reach us through the website live chat or by email at support@coreclaw.com so we can reproduce and fix the issue.