{"id":18872414,"url":"https://github.com/defcon-007/events","last_synced_at":"2026-02-15T21:30:16.923Z","repository":{"id":50214437,"uuid":"86138880","full_name":"DefCon-007/events","owner":"DefCon-007","description":null,"archived":false,"fork":false,"pushed_at":"2022-12-26T20:21:01.000Z","size":16,"stargazers_count":0,"open_issues_count":7,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-12-31T00:24:33.422Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/DefCon-007.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-03-25T06:59:44.000Z","updated_at":"2017-03-26T02:48:13.000Z","dependencies_parsed_at":"2023-01-31T01:15:22.836Z","dependency_job_id":null,"html_url":"https://github.com/DefCon-007/events","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DefCon-007%2Fevents","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DefCon-007%2Fevents/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DefCon-007%2Fevents/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DefCon-007%2Fevents/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DefCon-007","download_url":"https://codeload.github.com/DefCon-007/events/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239824987,"owners_count":19703199,"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":[],"created_at":"2024-11-08T05:29:49.888Z","updated_at":"2026-02-15T21:30:16.865Z","avatar_url":"https://github.com/DefCon-007.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Events\n======\n\nIt is an API for KGP Dashboard which gives all the relevant events from facebook happening in KGP.\n\n## How does it work?\n\nIt gets the content from the specified pages using Facebook's graph API. We\nuse [facepy](https://github.com/hargup/facepy) as the python frontefnd for the\napi.\n\n\n## How to use Events\n\n* Get a Facebook API token and save it in file name `ACCESS_TOKEN`. See this [StackOverflow Answer](http://stackoverflow.com/a/16054555/1780891).\n* The scraping script runs exclusively on Python 3, you can [conda](http://conda.pydata.org/miniconda.html) to easily switch between Python 2 and Python 3 environments.\n* Install all the dependancies using `pip install -r requirements.txt`\n* Run `fbscraper.py` by `python3 fbscraper.py`. You can setup up a cron job for running the file with referesh rate of your choice. \n* Now run the server by `python app.py`.\n\n## API Endpoints \n\n### /all-events \n    This endpoint returns all the events \n    Parameters required :\n        None \n    Parameters Returned :\n        success : Boolean (Whether the request was a success or not)\n        data    : JSON i.e. a list of Dictionaries of all the events, \n                  Parameter of dictionary : \n                        description : String, Description of the event\n                        placeLocation: Dictionary containing details of geolocation of the venue or Null if location is not tagged\n                            Paramenters :\n                                  city: String,\n                                  country: String,\n                                  longitude: Float,\n                                  latitude: Float,\n                                  street: String,\n                                  zip: String,\n                        created_time: String, date and time when the event was created (ex :2017-03-22T20:59:49+0000)\n                        source: String, Name of the page hosting the event\n                        id: String, ID of the event \n                        link: String, Link to the event\n                        startTime: String, Starting time of the event (ex : 03:00AM)\n                        startDate: String, Starting date of the event (ex :23-03-2017)\n                        pic: String, Link to cover picture of the event or Null if no picture is provided\n                        placeName: String, Name of the venue \n                        attenders: Integer, Number of attendess of the event\n                        name : String, Name of the event or Null if no name is present\n                        \n### /events-on-date  , method : POST\n    This endpoint returns all the events happening on the suppiled date \n    Parameters required :\n        date : Proper date in the format (DD-MM-YYYY)\n    Parameters Returned :\n        success : Boolean (Whether the request was a success or not)\n        data    : JSON i.e. a list of Dictionaries of the events happening on supplied date , (if success == True)\n                  Parameter of dictionary : \n                        description : String, Description of the event\n                        placeLocation: Dictionary containing details of geolocation of the venue or Null if location is not tagged\n                            Paramenters :\n                                  city: String,\n                                  country: String,\n                                  longitude: Float,\n                                  latitude: Float,\n                                  street: String,\n                                  zip: String,\n                        created_time: String, date and time when the event was created (ex :2017-03-22T20:59:49+0000)\n                        source: String, Name of the page hosting the event\n                        id: String, ID of the event \n                        link: String, Link to the event \n                        startTime: String, Starting time of the event (ex : 03:00AM)\n                        startDate: String, Starting date of the event (ex :23-03-2017)\n                        pic: String, Link to cover picture of the event or Null if no picture is provided\n                        placeName: String, Name of the venur \n                        attenders: Integer, Number of attendess of the event\n                        name : String, Name of the event or Null if no name is present\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdefcon-007%2Fevents","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdefcon-007%2Fevents","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdefcon-007%2Fevents/lists"}