{"id":13737682,"url":"https://github.com/shobeir/GraphiPy","last_synced_at":"2025-05-08T15:30:52.666Z","repository":{"id":41287897,"uuid":"148088074","full_name":"shobeir/GraphiPy","owner":"shobeir","description":"GraphiPy: Universal Social Data Extractor","archived":false,"fork":false,"pushed_at":"2023-01-03T10:04:29.000Z","size":3039,"stargazers_count":81,"open_issues_count":2,"forks_count":16,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-11-10T04:32:16.970Z","etag":null,"topics":["api-wrapper","facebook-api","graph","graph-algorithms","graph-database","graph-visualization","linkedin-api","pinterest-api","reddit-api","social-network","tumblr-api","twitter-api","youtube-api"],"latest_commit_sha":null,"homepage":"","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/shobeir.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":"2018-09-10T02:29:10.000Z","updated_at":"2024-10-19T12:48:37.000Z","dependencies_parsed_at":"2023-02-01T05:46:25.929Z","dependency_job_id":null,"html_url":"https://github.com/shobeir/GraphiPy","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/shobeir%2FGraphiPy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shobeir%2FGraphiPy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shobeir%2FGraphiPy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shobeir%2FGraphiPy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shobeir","download_url":"https://codeload.github.com/shobeir/GraphiPy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224742178,"owners_count":17362229,"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":["api-wrapper","facebook-api","graph","graph-algorithms","graph-database","graph-visualization","linkedin-api","pinterest-api","reddit-api","social-network","tumblr-api","twitter-api","youtube-api"],"created_at":"2024-08-03T03:01:57.131Z","updated_at":"2024-11-15T06:30:47.480Z","avatar_url":"https://github.com/shobeir.png","language":"Python","readme":"\u003cimg align=\"left\" src=\"https://yt3.ggpht.com/-E1RbjCNoU_4/AAAAAAAAAAI/AAAAAAAAAFA/aL_icowG2fg/s288-mo-c-c0xffffffff-rj-k-no/photo.jpg\" width=\"150\"\u003e\n\n# GraphiPy\n\nA Universal Social Data Extractor\n\n[![PyPI version](https://badge.fury.io/py/GraphiPy.svg)](https://badge.fury.io/py/GraphiPy) \n[![Downloads](https://pepy.tech/badge/graphipy)](https://pepy.tech/project/graphipy)\n[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/shobeir/GraphiPy/master?filepath=%2Fdemo%2F)\n\nGraphiPy simplifies the extraction of data from different social media websites. Instead of having to study the different APIs of each website, just provide the API keys and use GraphiPy!\n\nCurrently, GraphiPy provides support to 7 different websites:\n- [Reddit](https://www.reddit.com/dev/api/)\n- [Facebook](https://developers.facebook.com/docs/graph-api/)\n- [LinkedIn](https://developer.linkedin.com/docs/rest-api#) (Work in progress) \n- [Pinterest](https://developers.pinterest.com/docs/getting-started/introduction/)\n- [Tumblr](https://www.tumblr.com/docs/en/api/v2)\n- [Twitter](https://developer.twitter.com/en/docs)\n- [YouTube](https://developers.google.com/youtube/v3/)\n\n## Installation\nGraphiPy is uploaded on PyPI and can be found [here](https://pypi.org/project/GraphiPy/).\n\nTo install GraphiPy, run\n```pip install GraphiPy```\n\nPlease note that GraphiPy does not support Python 2 and only works on Python 3.\n\n## Video Demonstration\n[![GraphiPy Video](http://oi63.tinypic.com/2v336es.jpg)](http://www.youtube.com/watch?v=I_86Q3LQvNQ)\n\n## Data Strcuture\nGraphiPy acts like a Graph in which all the different information are stored as nodes and connections between different nodes will be stored as edges.\n\nCurrently, we have 3 graph types:\n- [Dictionary](https://docs.python.org/3/tutorial/datastructures.html#dictionaries)\n- [Pandas](https://pandas.pydata.org/)\n- [Neo4j](https://neo4j.com/)\n\nAll graph types are based on a class called [BaseGraph](https://github.com/shobeir/GraphiPy/blob/master/graphipy/graph/graph_base.py)\n\n- [Dictionary Graph](https://github.com/shobeir/GraphiPy/blob/master/graphipy/graph/graph_dict.py)\nTo provide easy access, the type of the nodes and edges are stored as keys while the rows of data are stored as values. The rows of data is also a dictionary, with the \\_id of the nodes and edges as keys (to avoid duplicate data) and the values would be the node and edge objects.\n\n- [Pandas Graph](https://github.com/shobeir/GraphiPy/blob/master/graphipy/graph/graph_pandas.py)\nSimilar to the Dictionary Graph, the type of nodes and edges are stored as keys and the dataframes are stored as values.\nSince inserting rows one by one into the dataframe takes polynomial time, the implementation uses the help of Python's dictionary. After a certain number of elements are inside the dictionaries, all of them are converted into dataframes and appended into the existing dataframes.\n\n- [Neo4j Graph](https://github.com/shobeir/GraphiPy/blob/master/graphipy/graph/graph_neo4j.py)\nGraphiPy directly connects and inserts to your Neo4j database. In order to avoid duplicate data, MERGE is used instead of CREATE. Thus, whenever an existing node \\_id is inserted, its attributes are updated instead of inserting a completely new node.\n\n## [API Demos](https://github.com/shobeir/GraphiPy/tree/master/demo)\n\nFor more information on how to use GraphiPy, please see one of the notebooks:\n- [Reddit](https://github.com/shobeir/GraphiPy/blob/master/demo/RedditDemo.ipynb)\n- [Facebook](https://github.com/shobeir/GraphiPy/blob/master/demo/FacebookDemo.ipynb)\n- [LinkedIn](https://github.com/shobeir/GraphiPy/blob/master/demo/LinkedinDemo.ipynb)\n- [Pinterest](https://github.com/shobeir/GraphiPy/blob/master/demo/PinterestDemo.ipynb)\n- [Tumblr](https://github.com/shobeir/GraphiPy/blob/master/demo/TumblrDemo.ipynb)\n- [Twitter](https://github.com/shobeir/GraphiPy/blob/master/demo/TwitterDemo.ipynb)\n- [YouTube](https://github.com/shobeir/GraphiPy/blob/master/demo/YoutubeDemo.ipynb)\n\n## [Data Exportation and Visualization with NetworkX](https://github.com/shobeir/GraphiPy/blob/master/graphipy/exportnx.py)\nGraphiPy can also export data as CSV files and visualize the graphs using NetworkX. It is also possible to convert from one graph type to another (e.g. from Pandas to Neo4j and vice versa). For more information, see [this notebook](https://github.com/shobeir/GraphiPy/blob/master/demo/DataExportDemo.ipynb)\n\n- Gephi Support: \n[Gephi](https://gephi.org/) is an open-source software for network visualization and analysis. It helps data analysts to intuitively reveal patterns and trends, highlight outliers and tells stories with their data.\nThe csv files exported from Graphify can be directly imported to Gephi.\nThe below figure shows data visualization (via Gephi) of 20 youtube videos with keyword \"dota2\" extracted via GraphiPy \n![Data of 20 youtube videos with keyword \"dota2\"](https://user-images.githubusercontent.com/25040463/48648253-85e33080-e9a3-11e8-9412-cf0f2bd286de.png)\n\n## Folder Structure\n```\n.\n├── demo\n|   ├── DataExportDemo.ipynb\n|   ├── FacebookDemo.ipynb\n|   ├── LinkedinDemo.ipynb\n|   ├── PinterestDemo.ipynb\n|   ├── RedditDemo.ipynb\n|   ├── TumblrDemo.ipynb\n|   ├── TwitterDemo.ipynb\n|   └── YoutubeDemo.ipynb\n├── graphipy\n|   ├── api\n|   |   ├── _init_.py\n|   |   ├── facebook_api.py\t\n|   |   ├── linkedin_api.py\t\n|   |   ├── pinterest_api.py\n|   |   ├── reddit_api.py\t\n|   |   ├── tumblr_api.py\t\n|   |   ├── twitter_api.py\t\n|   |   └── youtube_api.py\t\n|   ├── graph\n|   |   ├── _init_.py\n|   |   ├── graph_base.py\n|   |   ├── graph_dict.py\n|   |   ├── graph_neo4j.py\n|   |   └── graph_pandas.py\n|   ├── _init_.py\n|   ├── exportnx.py\n|   └── graphipy.py\n├── .gitignore \n├── README.md\n└── requirements.txt\n```\n| Folder/Filename | Description |\n|----|:---:|\n| demo | Jupyter notebooks explaining how to use the library in detail |\n| graphipy | The major directory of the library containing classes for all social media platforms, graph data structure and exporting functionalities |\n| graphipy/api | Class definitions for all social media platforms, including fetch functions and customized nodes and edges  |\n| graphipy/graph | Definitions of the graph data structure implemented with dictionary, Pandas and Neo4J  |\n| requirements.txt | All dependencies  |\n\n","funding_links":[],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshobeir%2FGraphiPy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshobeir%2FGraphiPy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshobeir%2FGraphiPy/lists"}