Rite: CLI for Ritetag API

Uses RiteTag API to get lists of similar hashtags & their viral potential.

Ritetag can show you which hashtags are most likely to get picked up & amplify your content.

This work was inspired by Neal Shyam on Ritehash

API Documentation: http://docs.ritetag.apiary.io/

Requirements

Obtain free API keys from https://ritetag.com/developer/dashboard

Using this as a template save keys in rite-config.json and place it in your home folder.

{
  "consumer_key":    "??????",
  "consumer_secret": "??????",
  "token":           "??????",
  "token_secret":    "??????"
}

API Limits

Plan	per day	per hour
Free	1,000	100
Tier 1	10,000	1,000
Tier 2	100,000	10,000
Tier 3	500,000	50,000
Tier 4	2,000,000	200,000

Installation

npm install rite

Usage

  rite command

Options:
  --help  Show help

Commands:
  directory [query]      Returns an array of up to 10 hashtags most frequently used in tweets containing your query
  trending               Returns trending hashtags
  influencers [hashtag]  Returns influencers on twitter for a given hashtag
  history [hashtag]      Returns historical data for a given hashtag

Glossary

tag: name of the associated hashtag
density: number of unique tweets with this hashtag per hour
retweets: number of retweets per hour
links: % of unique tweets with link
photos: % of unique tweets with photos
mentions: % of unique tweets with mentions
potential views: how many times per hour the hashtag is appearing in home feed across Twitter

Doest not yet support (todo)

Testing
Generate sample rite-config.json file in your home folder
Hashtags for a given url
Grade a tweet
Alternative output formats (json, csv)

License

MIT Licensed - 2014 - Louis Galipeau | @muloka

nahoskins/rite