Facebook User Posts Scraper

📘 Facebook user posts for public profile and Page research

Researchers, social media teams, and developers can collect public Facebook posts from profiles and Pages in one run. The Actor returns structured rows with the submitted target, post text and URL, plus profile and author details, dates, engagement counts, reactions, media, attachments, and links when Facebook exposes them. This gives you data for content tracking, creator research, competitor research, reporting, public profile monitoring, and data enrichment without copying posts by hand.

• Run a Facebook Post Scraper to save one known public entry as a structured row.
• Use the Facebook Timeline Scraper to export posts from a profile or Page feed.
• Use a Facebook Page Posts Scraper to collect Page updates with text and engagement data.
• Use a Facebook Profile Posts Scraper to collect profile updates with dates and author details.
• Use the Facebook Posts Scraper to export post URLs, text, media, and engagement fields.
• Run the Facebook User Posts Scraper to combine profile or Page targets and known URLs in one run.

📦 Facebook post data

What you get

Each successful public post is one dataset row. Some values are null or empty when Facebook does not expose them. If the same post is found through another submitted target or URL, the Actor keeps the first eligible saved match and ignores later matches.

• Source trace — matchedInput, postId, and postUrl show which submitted value first found the post and identify the source post.
• Post details — postType, text, transcript, and createdAt describe the public post when Facebook exposes them.
• People and pages — profile and author hold public IDs, names, URLs, and picture URLs when available.
• Engagement — engagement holds public comment, reaction, share, and video view counts; reactions holds the visible reaction breakdown.
• Media and links — media, attachments, externalLinks, and textReferences hold source-visible media, attachment, link, and referenced profile or Page data.
• Extra labels — paidPartnership and adLibraryId are returned when Facebook exposes them.

🚀 Run Facebook timeline and post exports

How to run

1. Open the Actor input tab.
2. Add public profile or Page targets in Profile or Page targets.
3. Add known public post URLs in Known post URLs when you have them. Either list can be used alone, or you can use both.
4. Set Maximum posts per profile or Page for each timeline. If you leave it empty, the Actor returns all available posts until Facebook has no more public posts.
5. Add optional Start date and End date values in YYYY-MM-DD format.
6. Turn on Request video transcripts only when you need spoken captions or transcripts. This can make the run slower.
7. Start the Actor and open the dataset.

For a first run, keep the prefilled public target and default settings. Replace it after you confirm the output shape.

⚙️ Input

Input fields

Use either input list or both. Timeline limits and dates apply only to profile or Page targets. Direct post URLs are handled separately.

Field	Type	What it does
targets	array of strings	Accepts handles, @handles, full profile or Page URLs, or numeric IDs for timeline posts.
postUrls	array of strings	Accepts direct public Facebook post, reel, photo, video, or supported permalink URLs.
maxPostsPerTarget	integer	Sets an optional limit for each profile or Page timeline. If left empty, the Actor returns all available posts until Facebook has no more public posts.
startDate	string	Keeps timeline posts on or after this YYYY-MM-DD date when Facebook shows a publish date.
endDate	string	Keeps timeline posts on or before this YYYY-MM-DD date when Facebook shows a publish date.
includeTranscripts	boolean	Requests spoken captions or transcripts for video and reel posts when available. This can make the run slower.

Successful run input

This example is copied from a successful current-beta run:

{
  "targets": [
    "NASA"
  ],
  "maxPostsPerTarget": 1,
  "includeTranscripts": false
}

🧾 Output

Output shape

The default dataset has one successful-post shape. The table includes every public field in the dataset schema. Null values and empty arrays mean Facebook did not expose that value for that row.

The results output link opens the default dataset. Each item in it is one successful public post row.

Field	Type	What it does
matchedInput	string	Shows the submitted target or known post URL that first found this row.
profile	object	Holds the public profile or Page linked to the post.
profile.id	string or null	Gives the Facebook profile or Page ID when shown.
profile.name	string or null	Gives the public profile or Page name when shown.
profile.url	string or null	Gives the public profile or Page URL when shown.
profile.pictureUrl	string or null	Gives the profile picture URL when shown.
postId	string	Gives the stable Facebook ID for the post, reel, video, photo, or story.
postUrl	string	Gives the Facebook URL for opening the post.
postType	string or null	Gives the post kind, such as a photo, video, or reel, when shown.
text	string or null	Gives the post text or caption when available.
transcript	string or null	Gives spoken captions or a transcript when requested and available for a video or reel.
createdAt	string or null	Gives the post time as an ISO timestamp when Facebook shows it.
author	object	Holds public author details for the post.
author.id	string or null	Gives the Facebook author ID when shown.
author.name	string or null	Gives the public author name when shown.
author.url	string or null	Gives the public author URL when shown.
author.pictureUrl	string or null	Gives the author's profile picture URL when shown.
engagement	object	Holds public comment, reaction, share, and video view counts when shown.
engagement.commentCount	integer or null	Gives the public comment count when shown.
engagement.reactionCount	integer or null	Gives the total public reaction count when shown.
engagement.shareCount	integer or null	Gives the public share count when shown.
engagement.viewCount	integer or null	Gives the public video or reel view count when shown.
reactions	object of integer counts	Gives the count for each reaction type when Facebook shows the breakdown.
media	array of objects	Lists images, thumbnails, and direct video URLs found in the post.
media[].type	string or null	Gives the media kind, such as image or video, when known.
media[].url	string	Gives the direct URL for the media item.
media[].thumbnailUrl	string or null	Gives the media thumbnail URL when available.
media[].width	integer or null	Gives the media width in pixels when known.
media[].height	integer or null	Gives the media height in pixels when known.
attachments	array of objects	Lists links and other attachments found with the post.
attachments[].type	string or null	Gives the attachment kind when known.
attachments[].url	string or null	Gives the attachment URL when available.
attachments[].title	string or null	Gives the attachment title when shown.
externalLinks	array of strings	Lists non-Facebook links found in the post.
textReferences	array of objects	Lists public profiles, Pages, or links named in the post text.
textReferences[].id	string or null	Gives the reference ID when shown.
textReferences[].name	string or null	Gives the referenced profile, Page, or link name when shown.
textReferences[].url	string or null	Gives the URL for the referenced profile, Page, or link when shown.
textReferences[].verified	boolean or null	Says whether Facebook marks the referenced profile or Page as verified.
paidPartnership	boolean or null	Says whether Facebook marks the post as a paid partnership.
adLibraryId	string or null	Gives the Facebook Ad Library Page ID when shown for the post or Page.

Example Facebook post

The shortened row below is a genuine row from a successful current-beta run. It keeps public values that show the post, author, engagement, links, and media; long URLs and extra nested entries use the valid JSON string "..." as an omission marker.

{
  "matchedInput": "NASA",
  "profile": {
    "id": "100044561550831",
    "name": "NASA - National Aeronautics and Space Administration",
    "url": "https://www.facebook.com/NASA",
    "pictureUrl": "..."
  },
  "postId": "1593834455445258",
  "postUrl": "https://www.facebook.com/reel/1071298452521377/",
  "postType": "story",
  "text": "Is your name part of our legacy of exploration and discovery?\n\nAhead of its launch later this month, we installed a plaque on the Nancy Grace Roman Space Telescope holding an SD card with over one million submitted names, continuing our tradition of leaving humanity’s mark on the cosmos.",
  "transcript": null,
  "createdAt": "2026-08-03T19:22:45.000Z",
  "author": {
    "id": "100044561550831",
    "name": "NASA - National Aeronautics and Space Administration",
    "url": "https://www.facebook.com/NASA",
    "pictureUrl": "..."
  },
  "engagement": {
    "commentCount": 1,
    "reactionCount": 75,
    "shareCount": 10,
    "viewCount": 71
  },
  "reactions": {
    "like": 60,
    "love": 14,
    "haha": 1
  },
  "media": [
    {
      "type": "image",
      "url": "...",
      "thumbnailUrl": null,
      "width": null,
      "height": null
    },
    "..."
  ],
  "attachments": [
    {
      "type": "StoryAttachment",
      "url": "https://www.facebook.com/reel/1071298452521377/",
      "title": null
    }
  ],
  "externalLinks": [],
  "textReferences": [
    {
      "id": "100064368862583",
      "name": "Nancy Grace Roman Space Telescope",
      "url": "https://www.facebook.com/NASARoman",
      "verified": true
    },
    "..."
  ],
  "paidPartnership": null,
  "adLibraryId": null
}

💳 Pricing

How charges work

This Actor uses pay-per-event pricing. You are charged for each public post saved to the dataset. A run with no saved public post does not create a public-post event. Skipped, private, unavailable, and duplicate posts are not saved as public post rows.

🔌 Integrations

Connect your results

Use the Apify API to start runs and read dataset items. Schedule recurring runs, send finished runs to webhooks, or connect the dataset to supported Apify integrations. Export the dataset as JSON, CSV, Excel, XML, RSS, or HTML.

Limits and caveats

This Actor only collects public Facebook data that is visible without a user-provided Facebook account. It does not bypass privacy controls, collect private profile content, scrape groups, scrape Marketplace, or import your Facebook session. Private, unavailable, or unsupported targets are skipped without creating placeholder rows.

Facebook may expose fewer timeline posts than your requested limit for some public profiles or Pages. Date filters apply to the rows that Facebook exposes to the Actor. If a profile has no public posts available, the Actor skips that target and continues with the rest of your input list.

Use the exported data responsibly and follow Facebook's terms, Apify's terms, and applicable privacy, data protection, and platform rules.

❓ FAQ

Do I need Facebook cookies, a login, or a Meta API key?

No. The Actor reads public Facebook post data and does not ask for user-provided cookies, login details, or a Meta API key.

Can I collect posts from profiles and Pages in one run?

Yes. Add profile or Page handles, full URLs, numeric IDs, or direct post URLs. You can use both input lists together.

Can I use a direct Facebook post URL without a timeline target?

Yes. Add known public post, reel, photo, video, or supported permalink URLs in Known post URLs. Timeline limits and dates do not change those direct URLs.

What happens when the same post is found through two inputs?

The Actor saves the first eligible occurrence and ignores later matches for that source post. The row shows the first submitted value that found it; it does not combine later matches into that row.

Why did I get fewer posts than my limit?

The limit is a maximum, not a promise. Facebook may expose fewer public posts for a profile or Page, or a date filter may remove posts after they are found.

Are comments returned as separate dataset rows?

No. The Actor returns post rows. It can include public comment counts in engagement when Facebook exposes them, but comments or replies are not separate records.

Can I request transcripts for video and reel posts?

Yes. Turn on Request video transcripts. A transcript is returned only when it is requested and Facebook exposes spoken captions or transcript text, and this option can make the run slower.

Does the Actor download Facebook media files?

No. It returns media and thumbnail URLs when Facebook exposes them. It does not mirror or download the source files.

Can it collect private profiles, groups, or Marketplace content?

No. It collects public posts from profiles, Pages, and supported direct post URLs. Private, friends-only, login-only, deleted, unavailable, group, and Marketplace content is outside its scope.

📝 Changelog

1.1: Add optional video transcript enrichment

• Request spoken captions or transcripts for video and reel posts when Facebook exposes them.
• Include transcript results and a readable table view for researching saved posts.

v1.0

• Added the stable public post row format with profile, author, engagement, reactions, media, attachment, link, and reference data.

v0.1

• Initial release.

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Related Actors

• Facebook Media Downloader — Get direct source-hosted links from known public Facebook videos, reels, and photos.
• Facebook Page Video Downloader — Export public Page video metadata and playable URLs from Page video libraries.
• Facebook Reviews Scraper — Collect public Page recommendations with reviewer details and visible engagement.
• Facebook Page Transparency Scraper — Review public Page or Profile transparency details and Meta Ad Library creatives.
• LinkedIn Posts Scraper — Collect public LinkedIn profile, company, and direct post data for cross-platform post research.

Made with ❤️ by Maxime Dupré