✨ Facebook Page Scraper — 🕵️‍♂️

Extract trimmed Facebook page/profile metadata using the page-detail endpoint. This Apify Actor posts each page URL to the API and returns only the requested fields so your dataset stays clean and easy to use.

---

Behavior & key implementation notes 🛠️

• The actor POSTS JSON {"page_id":"", "link":"<page_url>"} to with realistic headers (kept to mimic a browser).

• Input URLs and usernames are normalized and deduplicated before requests (so duplicate inputs won't cause duplicate results).

• Retry logic: If a request fails, is rate-limited , returns 5xx, or produces an effectively empty response (none of the requested fields present), the actor will automatically retry up to 3 attempts with exponential backoff (1s → 2s → 4s).

• Concurrency is configurable via concurrency in actor input (default 5).

• Results are:

• Apify Dataset (one item per input),

• and all results are saved to output.json inside the actor container (array of items).

• The actor performs best-effort extraction across likely field names and nested paths. If the API returns unusual schemas, some fields may be null.

• The actor preserves raw response and profile URL in the internal debug fields in code — but the dataset/output JSON contains the requested public-facing fields above.

---

Output — fields returned 🔎

Each dataset item contains only these keys (best-effort extraction from the API response):

• message — textual message / status returned by the API (if any).
• page_id — numeric/string page id (if present).
• title — page title or headline (if available).
• ad_page_id — ad-related page id (if present).
• bio — short bio/description.
• followers_count — follower/subscriber count (best-effort).
• likes_count — likes count (best-effort).
• avatar_url — primary avatar/profile image URL (best-effort).
• avatar_url_alt — alternate / HD avatar URL (best-effort).
• website — external website link if present.
• description — longer description / about text (if present).

The actor also pushes each record to the Apify Dataset and writes output.json (an array of all results) inside the actor container for download.

---

Input (actor input JSON) ⚙️

Provide input JSON when running the actor. Important fields:

Field	Type	Required	Default	Description
startUrls	array<{url: string}> or string[]	✅	—	One or more Facebook profile/page URLs. Each item can be a dict { "url": "..." } or a plain string.
usernames	string[]	❌	—	One or more Facebook usernames (bare username strings will be converted to a canonical https://www.facebook.com/<username> URL).
concurrency	integer	❌	5	Number of concurrent HTTP requests (default 5).

Example input

{
  "startUrls": [
    { "url": "https://www.facebook.com/Cristiano" },
    { "url": "https://www.facebook.com/neymarjr" }
  ],
  "usernames": [
    "leomessi"
  ],
  
}

---

Example output 📦

[
  {
    "message": "Success",
    "page_id": "100044296486382",
    "title": "Cristiano Ronaldo",
    "ad_page_id": "81221197163",
    "bio": "Welcome to the official Facebook page of Cristiano Ronaldo.",
    "followers_count": 171212121,
    "likes_count": 142535676,
    "avatar_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t39.30808-1/448474001_1102716254548247_2613997786866384047_n.jpg?stp=dst-jpg_tt6&cstp=mx1304x1304&ctp=s720x720&_nc_cat=1&ccb=1-7&_nc_sid=3ab345&_nc_ohc=KbNllDlePq0Q7kNvwHEa_sZ&_nc_oc=Adk3hL6SjAz-3hRKFpPt1OYFQjsZR5F8ChIHS9lc22Q5D1k88w9HglPTlH7Adco-Ky8&_nc_zt=24&_nc_ht=scontent-iad3-2.xx&_nc_gid=bJCGKhpMMFUEf0tI9LpuPA&oh=00_Afep_oe4kDM7QutZ-EjfzZxk5vn7XBJNFomv73RPsOr_IQ&oe=68EDAC21",
    "avatar_url_alt": "Cristiano Ronaldo",
    "website": "cristianoronaldo.com",
    "description": "Welcome to the official Facebook page of Cristiano Ronaldo.",
    "_profile_url": "https://www.facebook.com/Cristiano",
    "_raw_response": {
      "code": 100000,
      "message": "Success",
      "data": {
        "page_id": "100044296486382",
        "title": "Cristiano Ronaldo",
        "ad_page_id": "81221197163",
        "address": null,
        "bio": "Welcome to the official Facebook page of Cristiano Ronaldo.",
        "email": null,
        "followers_count": 171212121,
        "likes_count": 142535676,
        "avatar_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t39.30808-1/448474001_1102716254548247_2613997786866384047_n.jpg?stp=dst-jpg_tt6&cstp=mx1304x1304&ctp=s720x720&_nc_cat=1&ccb=1-7&_nc_sid=3ab345&_nc_ohc=KbNllDlePq0Q7kNvwHEa_sZ&_nc_oc=Adk3hL6SjAz-3hRKFpPt1OYFQjsZR5F8ChIHS9lc22Q5D1k88w9HglPTlH7Adco-Ky8&_nc_zt=24&_nc_ht=scontent-iad3-2.xx&_nc_gid=bJCGKhpMMFUEf0tI9LpuPA&oh=00_Afep_oe4kDM7QutZ-EjfzZxk5vn7XBJNFomv73RPsOr_IQ&oe=68EDAC21",
        "avatar_url_alt": "Cristiano Ronaldo",
        "instagram": null,
        "linkedin": null,
        "youtube": null,
        "website": "cristianoronaldo.com",
        "twitter": null,
        "telegram": null,
        "phone": null,
        "pinterest": null,
        "rating": null,
        "rating_overall": null,
        "description": "Cristiano Ronaldo. 142,535,676 likes · 808,375 talking about this. Welcome to the official Facebook page of Cristiano Ronaldo."
      }
    }
  },
  {
    "message": "Success",
    "page_id": "100050295107499",
    "title": "Neymar Jr.",
    "ad_page_id": "148456285190063",
    "bio": "I love Football ❤️⚽️\nwww.neymarjr.com\nhttps://blaze.com",
    "followers_count": 91260691,
    "likes_count": 79840665,
    "avatar_url": "https://scontent.fosu2-1.fna.fbcdn.net/v/t39.30808-1/489268264_1286265373059954_5414076581055006265_n.jpg?stp=dst-jpg_tt6&cstp=mx320x320&ctp=s320x320&_nc_cat=106&ccb=1-7&_nc_sid=3ab345&_nc_ohc=leos4Z_F0yMQ7kNvwETztYZ&_nc_oc=AdmN0m9uO160p0luLWHN1NCZ-Hh65jsL_fUC5Zc3efCwMnmyx1Yo_tBN490IXw5gehlkzLmWnmmcGHiuhoz13ZRh&_nc_zt=24&_nc_ht=scontent.fosu2-1.fna&_nc_gid=Vq_JcTCYsrzUa6m3UnGh8Q&oh=00_AfcUB4ZnpB5Sq70DjapoRSYoWJl2SugF49jQnWjmzxP5Ig&oe=68EDA3A6",
    "avatar_url_alt": "Neymar Jr.",
    "website": "bit.ly/44nW7uH",
    "description": "I love Football ❤️⚽️\nwww.neymarjr.com\nhttps://blaze.com",
    "_profile_url": "https://www.facebook.com/neymarjr",
    "_raw_response": {
      "code": 100000,
      "message": "Success",
      "data": {
        "page_id": "100050295107499",
        "title": "Neymar Jr.",
        "ad_page_id": "148456285190063",
        "address": null,
        "bio": "I love Football ❤️⚽️\nwww.neymarjr.com\nhttps://blaze.com",
        "email": "contato@neymaroficial.com",
        "followers_count": 91260691,
        "likes_count": 79840665,
        "avatar_url": "https://scontent.fosu2-1.fna.fbcdn.net/v/t39.30808-1/489268264_1286265373059954_5414076581055006265_n.jpg?stp=dst-jpg_tt6&cstp=mx320x320&ctp=s320x320&_nc_cat=106&ccb=1-7&_nc_sid=3ab345&_nc_ohc=leos4Z_F0yMQ7kNvwETztYZ&_nc_oc=AdmN0m9uO160p0luLWHN1NCZ-Hh65jsL_fUC5Zc3efCwMnmyx1Yo_tBN490IXw5gehlkzLmWnmmcGHiuhoz13ZRh&_nc_zt=24&_nc_ht=scontent.fosu2-1.fna&_nc_gid=Vq_JcTCYsrzUa6m3UnGh8Q&oh=00_AfcUB4ZnpB5Sq70DjapoRSYoWJl2SugF49jQnWjmzxP5Ig&oe=68EDA3A6",
        "avatar_url_alt": "Neymar Jr.",
        "instagram": null,
        "linkedin": null,
        "youtube": null,
        "website": "bit.ly/44nW7uH",
        "twitter": null,
        "telegram": null,
        "phone": null,
        "pinterest": null,
        "rating": null,
        "rating_overall": null,
        "description": "Neymar Jr. 79,840,665 likes · 257,467 talking about this. I love Football ❤️⚽️\nwww.neymarjr.com\nhttps://blaze.com"
      }
    }
  },
  {
    "message": "Success",
    "page_id": "100044447978953",
    "title": "Leo Messi",
    "ad_page_id": "176063032413299",
    "bio": "Bienvenidos a la página de Facebook Oficial de Leo Messi. Welcome to the official Leo Messi Facebook",
    "followers_count": 116943011,
    "likes_count": 106207005,
    "avatar_url": "https://scontent.fcae1-1.fna.fbcdn.net/v/t1.6435-1/199385759_345470910277839_3988273979229903886_n.jpg?stp=dst-jpg_tt6&cstp=mx1500x1500&ctp=s720x720&_nc_cat=1&ccb=1-7&_nc_sid=3ab345&_nc_ohc=MYv2GrXYR9cQ7kNvwGvEjJk&_nc_oc=Admm8uxHL1fsPafaRV5UnWvmFntnBtTP6NT5PIj-mV0qNKEqVfgFw_iAbBosNO7xuAk&_nc_zt=24&_nc_ht=scontent.fcae1-1.fna&_nc_gid=ABpqB3m7f7lodcq5UdQvMQ&oh=00_AffH0C-EquKekwbZ3cGDtTdGa-0EoTqhOuIc-WaZbv3_NQ&oe=690F3BC5",
    "avatar_url_alt": "Leo Messi",
    "website": "bit.ly/mas_by_messi",
    "description": "Bienvenidos a la página de Facebook Oficial de Leo Messi. Welcome to the official Leo Messi Facebook",
    "_profile_url": "https://www.facebook.com/leomessi",
    "_raw_response": {
      "code": 100000,
      "message": "Success",
      "data": {
        "page_id": "100044447978953",
        "title": "Leo Messi",
        "ad_page_id": "176063032413299",
        "address": null,
        "bio": "Bienvenidos a la página de Facebook Oficial de Leo Messi. Welcome to the official Leo Messi Facebook",
        "email": null,
        "followers_count": 116943011,
        "likes_count": 106207005,
        "avatar_url": "https://scontent.fcae1-1.fna.fbcdn.net/v/t1.6435-1/199385759_345470910277839_3988273979229903886_n.jpg?stp=dst-jpg_tt6&cstp=mx1500x1500&ctp=s720x720&_nc_cat=1&ccb=1-7&_nc_sid=3ab345&_nc_ohc=MYv2GrXYR9cQ7kNvwGvEjJk&_nc_oc=Admm8uxHL1fsPafaRV5UnWvmFntnBtTP6NT5PIj-mV0qNKEqVfgFw_iAbBosNO7xuAk&_nc_zt=24&_nc_ht=scontent.fcae1-1.fna&_nc_gid=ABpqB3m7f7lodcq5UdQvMQ&oh=00_AffH0C-EquKekwbZ3cGDtTdGa-0EoTqhOuIc-WaZbv3_NQ&oe=690F3BC5",
        "avatar_url_alt": "Leo Messi",
        "instagram": null,
        "linkedin": null,
        "youtube": null,
        "website": "bit.ly/mas_by_messi",
        "twitter": null,
        "telegram": null,
        "phone": null,
        "pinterest": null,
        "rating": null,
        "rating_overall": null,
        "description": "Leo Messi. 106,207,005 likes · 518,127 talking about this. Bienvenidos a la página de Facebook Oficial de Leo Messi. Welcome to the official Leo Messi Facebook"
      }
    }
  }
]

---

Troubleshooting tips 🔍

• If a page returns empty results repeatedly, it may be protected or blocked by Facebook — the actor will retry up to 3 times, but access may still fail if the API or Facebook refuses public access.
• If many pages fail due to rate limits, lower concurrency in the input (e.g., 1–3).
• This version ignores any proxy setting. If you need to use residential or datacenter proxies (for pages behind geofences or more robust extraction), I can re-enable proxy configuration in the script.

---