As the core structures of Relate are stabilizing, I have released the MVP with two very basic endpoints. You can access the node at:
http://relate.imwatsi.com
The most stable datasets right now are those involving tags, so I have availed only two very basic endpoints, that fall under the Conversations API. This project is still in alpha stage so expect more endpoints and further development going forward.
conversations.get_tag_stats
This returns lite stats on how much the tag has been used:
- Total number of posts that used the tag
- Total number of accounts that posted using the tag
Useful when front-ends want to show how many people are using a tag. Similar to how Twitter shows "120 people talking about this."
From this info you can have something like "(120) people talking about this, across (69) posts," for example.
query params
{"tag": ""}
expected JSON response
{"hive":
{"posts": 1986, "accounts": 1021}
}
example curl
curl -s --data '{"jsonrpc":"2.0", "method":"conversations.get_tag_stats", "params":{"tag": "hive"}, "id":1}' http://relate.imwatsi.com
This endpoint is obviously still rudimental and a lot can be done to extend the accuracy and depth of its data.
conversations.get_tags_trending
This returns a list of tags used in posts, sorted by the number of times they have been used. The most used tags will be at the top.
query params
{"limit": int}
expected JSON response
[
["palnet", 2773],
["neoxian", 1981],
["hive", 1679],
["photography", 1584],
["crystal", 1305],
["dtube", 1233],
["life", 1228],
["creativecoin", 1003],
["sportstalk", 831],
["blog", 771],
["actifit", 742],
["art", 734]
]
example curl
curl -s --data '{"jsonrpc":"2.0", "method":"conversations.get_tags_trending", "params":{"limit": 12}, "id":1}' http://relate.imwatsi.com
This coming week's scope
- Get a repository up (probably on GitLab)
- Write API documentation
- Implement community-specific contexts for the two endpoints above
- Continue working on expanding datasets and endpoints available
Relate is a content discovery and recommendation engine for social networks on the Hive blockchain.