zizibong/facepager

Facepager was made for fetching public available data from Facebook, Twitter and other JSON-based APIs.

Facepager was made for fetching public available data from Facebook, Twitter and other JSON-based API. All data is stored in a SQLite database and may be exported to csv.

Current status

• Please be aware of API upgrades by Facebook. API version 2.3 is no longer supported and automatically redirected to some higher version. Change the version in the base path to v2.11 or newer.
• Facebook now only provides limited fields by default. Furthermore, some data like names of users commenting on a Facebook page are not available anymore (if you are not owner of the page). Use the fields-parameter (left side) to specify the data you want (right side, comma delimited). The available fields are listed in the Facebook Graph API reference, e.g. https://developers.facebook.com/docs/graph-api/reference/page/

Installer

Installation packages for each versions are available on the releases page. Database files may be incompatible between versions.

• Windows: Download and execute the latest installer from the releases page.
• Mac OS X: Unzipp the file from the releases page, drag & drop the App to your "Applications" folder. When a warning about the the source pop's up you should allow the installation of non-app-store applications (go to "System Preferrences>Security & Privacy" and check "Anywhere"). If you do not want to change your security settings permanently, you may open the Facepager by CTRL+Click on the icon (each time on startup).
• Linux: There is no binary release, see src/readme.txt for steps to run under linux.

Getting started

1. Click "New Database" in the toolbar to create a blank database
2. Add Facebook IDs by clicking "Add Nodes" in the toolbar. Enter the last part of a Facebook page, e.g. enter "Tatort" for the page "http://www.facebook.com/Tatort". Alternatively you can enter "me" as reference to yourself.
3. Select the Facebook tab and type https://graph.facebook.com/v2.10/ into the Base path field.
4. Type <Object ID> into the Resource field.
5. Delete any parameters. Then add just one parameter: the term fields goes into the left side, the term name,category,fan_count,birthday goes into the right side. See https://developers.facebook.com/docs/graph-api/reference/page/ for other fields if you like.
6. In the Facebook tab click on "Login to Facebook" and login to get a valid access token. Notice: the access token is like a password to Facebook. Since it may be printed in the status log and saved in the application settings don't give anyone untrusted access to your computer or to the status log.
7. Select one or more nodes in the view and click "Fetch data". Look at the status log (make sure "Log all requests" was enabled) to see how the URL is assembled from your settings.
8. Click "Expand nodes" in the toolbar and select one of the new child nodes. The raw data is shown to the right.
9. Change the column setup according to your needs by adding keys found in the raw data into the "Custom Table Columns" area. Don't forget to click "Apply Column Setup".
10. For further information, click the "help" button and try the default presets.

Getting help

Try the help button built into Facepager.

You can get help regarding specific problems in the Facepager Usergroup on Facebook. If you want to be informed about updates please follow the Facebook Page.

Citation

Jünger, Jakob / Keyling, Till (2017). Facepager. An application for generic data retrieval through APIs. Source code and releases available at https://github.com/strohne/Facepager/.

Licence

MIT License

Copyright (c) 2017 Jakob Jünger and Till Keyling

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.