Facebook Profile & Posts Scraper

📘 Facebook Profile Scraper

Scrape Facebook Profiles — recent profile posts, profile details (by ID or URL), and profile ID lookup — powered by our Facebook Scraper.

✨ Features

• Profile posts: Fetch public profile posts by ID or by URL.
• Profile details: Retrieve rich profile metadata by ID or by URL.
• Profile ID lookup: Resolve a profile ID from a URL

🧭 Endpoints

Choose one endpoint per run:

1. profile_posts_by_url GET /profile/posts?profile_url=...&start_date=YYYY-MM-DD&end_date=YYYY-MM-DD

2. profile_posts_by_id GET /profile/posts?profile_id=...&start_date=YYYY-MM-DD&end_date=YYYY-MM-DD

3. details_by_id GET /profile/details_id?profile_id=...

4. details_by_url GET /profile/details_url?url=...

5. profile_id_by_url GET /profile/profile_id?url=...

🚀 How It Works

1. Pick the endpoint in the Actor input (dropdown).

2. Fill only the parameter(s) required for that endpoint.

3. Run the Actor.

   • For Profile posts, the Actor:

     • Calls GET /profile/posts?profile_url/id=... (+ optional start_date, end_date),
     • Pushes posts to the dataset,
     • Continues with GET /profile/posts?profile_url/id=... until finished.

All results are stored in the default Apify Dataset, ready to export as CSV, XLSX, or JSON.

🧾 Input

Fields

• endpoint (required) — one of:

  • profile_posts_by_id
  • profile_posts_by_url
  • details_by_id
  • details_by_url
  • profile_id_by_url

• profile_id (string) — required for profile_posts, details_by_id

• profile_url (string) — required for profile_posts, details_by_url

• url (string) — required for details_by_url, profile_id_by_url

• start_date (YYYY-MM-DD, optional) — filter for profile_posts

• end_date (YYYY-MM-DD, optional) — filter for profile_posts

📦 Output

All results are saved as items in the default Apify Dataset.

Profile posts

Each dataset item is a post object from the API, plus helper fields:

• profile_url or profile_id (search term) — the URL or ID you queried

Common fields (may vary): post_id, type, url, message, timestamp, comments_count, reactions_count, reshare_count, reactions (object), author (object), media (image, video, video_files, video_thumbnail, album_preview, external_url).

Profile details (by ID / by URL)

Single record with profile metadata (structure depends on API). We push results if present, otherwise the raw payload, plus:

• profile_id (search term) or url (search term)

Profile ID by URL

Single record containing the resolved profile ID, plus:

• url (search term)

Export via Dataset → Export in the Apify UI (CSV, XLSX, JSON).

🧠 Reliability & Pagination

• Pagination: Automatically keeps requesting until the API stops returning profile posts.

• Retries: 3 attempts with a 5s backoff for transient failures (e.g., 429/5xx).

• Polite delay: A short delay between requests helps reduce rate-limit hits.

• Minimal logs: Progress lines look like:

  total posts collected 3
  total posts collected 6
  

🛡️ Best Practices

• Use realistic workloads; although the Actor retries on 429/503, excessive calling can still be throttled.
• For very large profiles, consider narrowing date filters or splitting runs.
• Profiles must be public for data to be returned by the API.

🔧 Troubleshooting

• 422 Field required: profile_id The API requires profile_id even when using a cursor. This Actor always includes it; ensure your input has profile_id filled.

• 429 Rate limited The Actor retries up to 3 times with a 5s delay. If it persists, slow down or split the job.

• No posts returned The profile may be private, there may be no posts, or your date range excludes available posts.

• Empty details/ID Double-check the URL/ID. Some profiles or URLs may not resolve or be supported.

📈 SEO Keywords

facebook profile scraper, scrape facebook posts, facebook profile details api