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 [green, optional]  Returns trending hashtags. Include the word green if you only want green 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