tweets-stats

get statistics from array of tweets

Install

npm install --save tweets-stats

Usage

import Twitter from 'twitter';
import tokens from 'twitter-tokens';
import stats from 'tweets-stats';

const client = new Twitter(tokens);
client.get('/statuses/user_timeline.json', { screen_name: 'POTUS' }, (err, tweets, raw) => {
  if (err) throw err;
  stats(tweets); /* {
    "tweets": 20,
    "own": {
      "total": 19, "percent": 95.00 },
    "replies": {
      "total": 0,  "percent": 0.00 },
    "retweets": {
      "total": 1,  "percent": 5.00 },
    "retweeted" {
      "total": 158764, "average": 8356 },
    "favorited": {
      "total": 85888,  "average": 4520.42 }}
  */
});

API

stats(input)

Return Object with fields:

• tweets number of all tweets in input
• own object representing author’s own tweets, with fields:
  • total number of own tweets
  • percent the percentage of own tweets from the total number of all tweets
• replies object representing author’s replies to others, with fields:
  • total number of replies
  • percent the percentage of replies from the total number of all tweets
• retweets object representing author’s retweets of other’s tweets, with fields:
  • total number of retweets
  • percent the percentage of retweets from the total number of all tweets
• retweeted object representing author’s tweets retweeted by others, with fields:
  • total how much own tweets have been retweeted in total
  • average how much own tweets have been retweeted in average per one tweet
• favorited object representing author’s tweets favorited by others, with fields:
  • total how much own tweets have been favorited in total
  • average how much own tweets have been favorited in average per one tweet

input

Required
Type: Array

Array of tweets from Twitter rest API, basically from user_timeline endpoint. To make you life easier take a look at node-twitter, twit or get-tweets modules.

Related

• get-tweets — get latest tweets
• get-twitter-info — get info about target username
• get-twitter-followers — get followers for target username
• tweet-links — extract links from tweet
• twitter-mentions — get latest mentions for target username
• twitter-profile-media — get twitter profile image and banner
• twitter-tokens — get twitter tokens

License

MIT © Vladimir Starkov