{"id":13569277,"url":"https://github.com/KyleAMathews/facebook-export","last_synced_at":"2025-04-04T05:31:47.688Z","repository":{"id":12786605,"uuid":"15460257","full_name":"KyleAMathews/facebook-export","owner":"KyleAMathews","description":"Tools to help administer your Facebook groups","archived":false,"fork":false,"pushed_at":"2017-02-09T21:58:10.000Z","size":27,"stargazers_count":105,"open_issues_count":19,"forks_count":28,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-04-02T03:43:27.461Z","etag":null,"topics":["facebook","facebook-api","facebook-export"],"latest_commit_sha":null,"homepage":"","language":"CoffeeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KyleAMathews.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-12-26T21:01:30.000Z","updated_at":"2024-11-28T11:49:57.000Z","dependencies_parsed_at":"2022-09-17T00:01:21.903Z","dependency_job_id":null,"html_url":"https://github.com/KyleAMathews/facebook-export","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KyleAMathews%2Ffacebook-export","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KyleAMathews%2Ffacebook-export/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KyleAMathews%2Ffacebook-export/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KyleAMathews%2Ffacebook-export/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KyleAMathews","download_url":"https://codeload.github.com/KyleAMathews/facebook-export/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247128702,"owners_count":20888232,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["facebook","facebook-api","facebook-export"],"created_at":"2024-08-01T14:00:37.986Z","updated_at":"2025-04-04T05:31:47.319Z","avatar_url":"https://github.com/KyleAMathews.png","language":"CoffeeScript","readme":"facebook-export\n===============\n\nExport data from your Facebok groups.\n\n[![NPM](https://nodei.co/npm/facebook-export.png?downloads=true)](https://nodei.co/npm/facebook-export/)\n\n### Install\nThis program comes with two executables: `facebook-export` which handles downloading and saving your information from Facebook and `facebook-analyze` which provides several ways for you to inspect and analyze your data.\n\nTo install:\n\nFirst install [node.js](http://nodejs.org/).\n\nThen run in your terminal:\n\n`npm install -g facebook-export`\n\n### Export data from Facebook.\n\nTo access your data through the Facebook API, Facebook requires you to use an access token. This must be included when you run `facebook-export`. The easiest way I've found is to grab one from Facebook's API explorer https://developers.facebook.com/tools/explorer\n\nThere click on the \"Get Access Token\" button and make sure you check the \"user_groups\" data permission. Once you've approved this app, copy the long random alphanumeric Access Token. We'll use it next to export your Facebook data.\n\n![screen shot 2014-05-16 at 4 45 40 pm](https://cloud.githubusercontent.com/assets/71047/3003503/5c1ef460-dd54-11e3-8f79-7b53da728e87.png)\n\n![screen shot 2014-05-16 at 4 46 06 pm](https://cloud.githubusercontent.com/assets/71047/3003502/5c0a3b24-dd54-11e3-8c2a-edd79035dfd0.png)\n\nYou need to know the Group ID of the group you wish to export data from. To see a list of all your groups and their Group IDs run:\n\n`facebook-export -a \u003cYOUR-ACCESS-TOKEN\u003e -l`\n\nThis should return a list something like:\n\n````\nFACEBOOK GROUPS\n* The Vinyl Club [122351275176234206]\n* The Stanford 2nd Ward [1881523481214555]\n* Frisbee [1462342888234234]\n* etc.\n````\n\nTo export the information (posts and members) for one of these groups run:\n\n`facebook-export -a \u003cACCESS-TOKEN\u003e -g \u003cGROUP-ID\u003e -d`\n\nThe downloaded information will be saved in LevelDB DBs at ~/.facebook-export\n\n### Playing with your data\nOnce you've saved your information locally, you'll probably want to have a look at it. You'll use the `facebook-analyze` command for this.\n\nTo get a raw dump of the JSON encoded information from the API run:\n\n`facebook-analyze -g \u003cGROUP-ID\u003e -s`\n\nThis will write all the group's posts to STDOUT.\n\nYou can filter posts by the year and month they were created in. E.g. to grab all posts from 2013 and save them to a file run:\n\n`facebook-analyze -g \u003cGROUP-ID\u003e -y 2013 -s \u003e\u003e posts_2013.json`\n\nI've also added a script which calculates an activity score for each member of the group. Members get points when they post/comment/like. To emphasize more recent activity, points have a 1/2 life of six months. Generate the activity chart by running:\n\n`facebook-analyze -g \u003cGROUP-ID\u003e -a`\n","funding_links":[],"categories":["CoffeeScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FKyleAMathews%2Ffacebook-export","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FKyleAMathews%2Ffacebook-export","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FKyleAMathews%2Ffacebook-export/lists"}