Facebook Friends Ranker 📊

Facebook Friends Ranker analyzes your Facebook data export to reveal who you interact with the most — your real inner circle based on your own engagement behaviour. It ranks every person whose posts you've commented on or reacted to, weighted by effort.

⚠️ Why this approach? Facebook's data export only includes your own activity (comments and reactions you made). It does not include who reacted to or commented on your posts — Facebook keeps that data server-side. Facebook Friends Ranker therefore ranks people by how much you engage with them, which is an equally honest signal of who matters to you.

🚀 Key Features

• 🏆 Top Ranking: The people whose content you engage with most, shown instantly in the Output tab.
• 👻 Ghost Friend Graveyard: Friends on your list you have never once commented on or reacted to.
• 📱 Visual Dashboard: A clean HTML report with your full ranking breakdown.

⚖️ Scoring Algorithm

📂 How to Export Your Facebook Data

1. On desktop: click your profile photo (top right) → Settings & privacy → Settings → Meta Accounts Center (top left) → Your information and permissions → Export your information → Create export
2. Choose your Facebook profile → Export to device
3. Under Customize Information, deselect all, then check only:
   • Comments and Reactions
   • Friends
4. Format: Must be JSON
5. Media Quality: Select Low (photos not needed)
6. Download the ZIP once Facebook prepares it

✅ Your ZIP should contain:

connections/
  friends/
    your_friends.json
your_facebook_activity/
  comments_and_reactions/
    comments.json
    likes_and_reactions_1.json
    likes_and_reactions_2.json
    ...

🛠️ Project Structure

.actor/
  actor.json            ← actor config, points to output schema
  input_schema.json     ← defines the file upload input
  output_schema.json    ← links Output tab to dataset + dashboard
main.py                 ← core logic
requirements.txt        ← apify, requests
Dockerfile              ← Python 3.11 Apify base image

🖱️ How to Run

1. Upload your Facebook ZIP file into the input box on the Input tab
2. Click Start
3. Once the run shows Succeeded, open the Output tab — you will see two options in a dropdown:
   • 🏆 Visual Dashboard (shown by default) — your Top 10 ranking and Ghost Friends in a visual HTML report
   • 📊 Full Rankings — the complete ranked list of everyone you interact with

📊 Understanding Your Results

• High score = someone you genuinely care about — you actively comment and react to their content
• On the list but not a friend? — could be a public page, group, or someone you follow
• Ghost friends — people you accepted as friends but never actually engage with

🔒 Privacy & Security

• All processing happens within the secure Apify platform
• Your ZIP never leaves the run environment
• No photos or videos are needed — export on Low quality
• Data is only held for the duration of the run