Ok, so I am going to cover some of the calls using steem-js. Where possible I will give better examples than in the github examples and I will also show samples of what you will get back.

I want to start with getDiscussions type calls because for anyone first trying to read the docs the query parameter is a bit vague.

```
Steem.api.getDiscussionsByActive(query, function(err, result) {
  console.log(err, result);
});
```

Query takes the following form

```
var query = {
  limit:10, // limits the number of posts returned
  tag: 'funny', // limits posts returned to those with the tag funny
  truncate_body: 0 // limits the number of bytes or body text returned for
                  // each post. 0 returns the whole thing and is the default if you don't include this parameter
};
```

There are still some mysteries to me with this call. You can leave off the tag and the truncate_body and it works as expected but if you leave off the limit you get an empty array as a result and null for the err object.

I will dig around some more and see if I can figure out what happens in the code that causes this and if I find anything I will either include it in the next post or update this one. Also, 100 is the highest limit you can set for this call before it throws an error.

I made another discover which is tag does not always actually mean tag. The following

```
Steem.api.getDiscussionsByFeed({
  //author: 'voorash',
  limit:10,
  tag: 'voorash',}
```
  
  will return the latest 10 items in my feed.  So it would seem tag has been repurposed for some calls.

 This next one took me a bit to figure out because it doesn't return the same value. I honestly can't even imagine what this is used for unless I am missing something. Calling it will return the posts being cashed out right now.  Not in 10 seconds and not 10 seconds ago. 
  
```
  Steem.api.getDiscussionsByCashout({limit:10}
```
     
    I thought it was broken until it finally returned something. I'll tinker around with this one to see if I can figure out if it could ever be useful.

    One last one for tonight and that is because it shows some odd behavior. If I run this without a tag then it lists posts that currently have the most votes.  If I add the tag photography then the first result is from 03/15/2017 at 08:32 but then all the other posts in the returned values are current. I will have to look into that one some more too.
   
```
    Steem.api.getDiscussionsByVotes({limit:10}
```

That is it for tonight but I am going to try to post more on this tomorrow. Once I have a good grasp of each api I plan to submit a pull request to add examples to github.

I'll leave you with my reinterpretation of the new star wars short animation style. With Bizarro Leia.![bizzarroholdewok.jpg](https://steemitimages.com/DQmZweT7DoAAQGZ2Ya4dexNkHzXy6oQNb1C7wMppJCeMdnB/bizzarroholdewok.jpg)