{"id":15658355,"url":"https://github.com/danburzo/fb-export","last_synced_at":"2025-10-20T01:32:11.097Z","repository":{"id":73008064,"uuid":"114868147","full_name":"danburzo/fb-export","owner":"danburzo","description":"Export (most) of your Facebook data using Node.js and the Graph API.","archived":true,"fork":false,"pushed_at":"2018-04-20T12:58:14.000Z","size":25,"stargazers_count":21,"open_issues_count":0,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-30T02:42:52.090Z","etag":null,"topics":["backup","export","facebook","graph-api"],"latest_commit_sha":null,"homepage":null,"language":"HTML","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/danburzo.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-12-20T09:25:23.000Z","updated_at":"2025-02-28T03:02:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"56e61c7e-31c0-4a53-828f-8ff45e1401ec","html_url":"https://github.com/danburzo/fb-export","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/danburzo/fb-export","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danburzo%2Ffb-export","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danburzo%2Ffb-export/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danburzo%2Ffb-export/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danburzo%2Ffb-export/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danburzo","download_url":"https://codeload.github.com/danburzo/fb-export/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danburzo%2Ffb-export/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279970566,"owners_count":26252763,"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","status":"online","status_checked_at":"2025-10-19T02:00:07.647Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["backup","export","facebook","graph-api"],"created_at":"2024-10-03T13:12:04.222Z","updated_at":"2025-10-20T01:32:10.849Z","avatar_url":"https://github.com/danburzo.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# fb-export\n\nExport (most) of your Facebook data using Node.js and the Graph API.\n\n## Introduction\n\nCrowbarring your data out of Facebook is no easy feat — to get everything out you'll need a combination of [Graph API](https://developers.facebook.com/docs/graph-api/) wrangling and old-fashioned manual labor — but it's not impossible. \n\nThe purpose of this repository is to give you some tools to make the whole process a bit smoother.\n\n### Why not use Facebook's own \"Download your data\"\n\nFacebook offers a way to [download your data](https://www.facebook.com/help/212802592074644) that sounds [comprehensive enough](https://www.facebook.com/help/405183566203254), and I encourage you to first download that data and see if the amount of information and its quality are sufficient for your purposes — if so, you're in luck.\n\nIf, however, you'd like a more structured dataset and images in a better resolution, the tools below can help you. Here's what's included so far:\n\nData | Notes\n---- | -----\nPosts | Things you posted on your timeline.\nTimeline photos | Photos attached to timeline posts \u003csup\u003e1\u003c/sup\u003e\nAlbums | Your photo albums. \u003csup\u003e1\u003c/sup\u003e\nPhotos you're tagged in | A subset of \"Pictures of you\", i.e. photos in which other people / Pages have tagged you \u003csup\u003e2\u003c/sup\u003e\n\n#### Notes\n\n* \u003csup\u003e1\u003c/sup\u003e __Videos are not fetched at the moment!__\n* \u003csup\u003e2\u003c/sup\u003e __Not all \"Pictures of you\" are accessible through the Graph API__, you'll need to manually download the other photos.\n\n#### A word of caution\n\nAlthough I've checked against my own account for a modicum of accuracy in the exported data, these scripts are __no guarantee__ that your content is comprehensively and accurately exported, so exercise caution if you plan to delete the content afterwards.\n\n## Installation\n\n### Prerequisites\n\nYou'll need [Node.js](https://nodejs.org/en/), NPM (it comes with Node) and, optionally, [Yarn](https://yarnpkg.com/en/) (which these instructions use throughout). \n\nSince I wrote the scripts with ES6 syntax for its brevity, this only probably works with more recent versions of Node. (I'm currently using `v8.9.0`).\n\n### Setting things up\n\n1. Clone this repository to your computer\n2. Run `yarn` (or `npm install`) in your project's folder to install all the necessary dependencies\n3. Rename the `sample.config.json` file to `config.json` (you can do that in the terminal with `mv sample.config.json config.json`) and put in the *access token* you get from the [Facebook Graph API Explorer](https://developers.facebook.com/tools/explorer/). \n\n(Since the token allows anyone to access your data through the API, we're not putting the actual `config.json` on GitHub.)\n\n#### Getting an access token\n\n1. Go to the [Facebook Graph API Explorer](https://developers.facebook.com/tools/explorer/) page.\n2. Click on _Get access token_ and choose _Get User Access token_.\n3. Check all the permissions in the first set (\"User Access Permissions\"), and follow the approval screens to generate the token.\n3. Put the access token in your `config.json`.\n\n## Tools\n\nTool | Command | Notes\n---- | ------- | -----\nExport your Facebook posts | `node tools/posts.js` | This exports your Facebook posts to JSON in `export/json/posts.json`. You can look in the source code to see which fields are currently fetched, and add your own to suit your needs. [See this page](https://developers.facebook.com/docs/graph-api/reference/v2.11/post) for available fields.\nExport timeline photos | `node tools/photos.js` | The photos are downloaded in the `export/photos` folder. __Note__ that you'll need to have run the post exporter beforehand, because the script uses the `posts.json` as a basis.\nGenerate a HTML timeline | `node tools/timeline.js` | This generates a HTML timeline based on `posts.json` and the downloaded photos, so you'll need to have run the two tools above for it to work.\nExport your albums | `node tools/albums.js` | Fetches the images from your Facebook albums into the `export/albums` folder, and stores the album info in the `export/json/albums.json` file.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanburzo%2Ffb-export","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanburzo%2Ffb-export","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanburzo%2Ffb-export/lists"}