Socialmetrica/README.md

Socialmetrica

Social Networks data analysis utilities and tools, starting with Twitter/Nitter.

To install, first install ExoRepo and then from a playground in GToolkit execute:

  ExoRepo new
    repository: 'https://code.tupale.co/Offray/Socialmetrica';
    load.

Important: Following a local first approach, improved documentation is being written in Spanish at this moment. We write it according to the context where we are sharing and using our developments. Once we share back with non Spanish speaking audiences and developers, we will point to English documentation here.

Minimal usage example

Prerequisite: You will need to have already your Twitter API Keys.

Load your API keys into a TwitterAPI object:

  twitterAPI := TwitterAPI new
    apiKeysFile: FileLocator home / 'Route/To/myAPIKeysFile.json';
    loadKeys.

(If you don't define a particular route to your API keys file, it will be loaded from a default location in : ~/.config/Datanalitica/twitter-api-keys.json)

Once you have loaded your keys, you can run your first query using the DSL (Domain Specific Lanuage):

  twitterAPI usersGroupMentioning: 'feenkcom'

If you click in a particular user, you can get details on him/her and an overview of his/her tweets, and clicking on a particular tweet you can see details on it:

Next: improved data paging, chaching and storage and some support for topic modelling and clustering.

That is for now.