# Steem Developer Portal

Used to lookup information about tags, posts, and discussions. These AppBase API methods are still under development and subject to change.

- Working on mainnet
- Working on testnet

#### tags_api.get_active_votes

Returns all votes for the given post.

##### Query Parameters JSON

    {"author": "", "permlink": ""}

##### Expected Response JSON

    {"votes": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_active_votes", "params":{"author":"steemit", "permlink":"firstpost"}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_active_votes", "params":{"author":"alice", "permlink":"a-post-by-alice"}, "id":1}' https://api.steemit.com

- Since: HF17
- Working on mainnet
- Working on testnet

#### tags_api.get_comment_discussions_by_payout

Returns a list of discussions based on payout.

##### Query Parameters JSON

    {
      "tag": "",
      "limit": 0,
      "filter_tags": [],
      "select_authors": [],
      "select_tags": [],
      "truncate_body": 0
    }

##### Expected Response JSON

    {"discussions": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_comment_discussions_by_payout", "params":{"tag":"steem","limit":1}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_comment_discussions_by_payout", "params":{"tag":"photography","limit":10,"truncate_body":0}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### tags_api.get_content_replies

Returns a list of replies.

##### Query Parameters JSON

    {"author": "", "permlink": ""}

##### Expected Response JSON

    {"discussions": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_content_replies", "params":{"author":"steemit", "permlink":"firstpost"}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_content_replies", "params":{"author":"alice", "permlink":"a-post-by-alice"}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### tags_api.get_discussion

Returns the discussion given an author and permlink.

##### Query Parameters JSON

    {"author": "", "permlink": ""}

##### Expected Response JSON

    {
      "id": 0,
      "author": "",
      "permlink": "",
      "category": "",
      "parent_author": "",
      "parent_permlink": "",
      "title": "",
      "body": "",
      "json_metadata": "",
      "last_update": "1970-01-01T00:00:00",
      "created": "1970-01-01T00:00:00",
      "active": "1970-01-01T00:00:00",
      "last_payout": "1970-01-01T00:00:00",
      "depth": 0,
      "children": 0,
      "net_rshares": 0,
      "abs_rshares": 0,
      "vote_rshares": 0,
      "children_abs_rshares": 0,
      "cashout_time": "1970-01-01T00:00:00",
      "max_cashout_time": "1970-01-01T00:00:00",
      "total_vote_weight": 0,
      "reward_weight": 0,
      "total_payout_value": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000021"
      },
      "curator_payout_value": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000021"
      },
      "author_rewards": 0,
      "net_votes": 0,
      "root_author": "",
      "root_permlink": "",
      "max_accepted_payout": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000021"
      },
      "percent_steem_dollars": 0,
      "allow_replies": false,
      "allow_votes": false,
      "allow_curation_rewards": false,
      "beneficiaries": [],
      "url": "",
      "root_title": "",
      "pending_payout_value": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000021"
      },
      "total_pending_payout_value": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000021"
      },
      "active_votes": [],
      "replies": [],
      "author_reputation": 0,
      "promoted": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000013"
      },
      "body_length": 0,
      "reblogged_by": []
    }

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussion", "params":{"author":"steemit", "permlink":"firstpost"}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussion", "params":{"author":"alice", "permlink":"a-post-by-alice"}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### tags_api.get_discussions_by_active

Returns a list of discussions based on active.

##### Query Parameters JSON

    {
      "tag": "",
      "limit": 0,
      "filter_tags": [],
      "select_authors": [],
      "select_tags": [],
      "truncate_body": 0
    }

##### Expected Response JSON

    {"discussions": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_active", "params":{"tag":"steem","limit":1}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_active", "params":{"tag":"photography","limit":10,"truncate_body":0}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### tags_api.get_discussions_by_author_before_date

Returns a list of discussions based on author before date.

##### Query Parameters JSON

    {
      "author": "",
      "start_permlink": "",
      "before_date": "1970-01-01T00:00:00",
      "limit": 100
    }

##### Expected Response JSON

    {"discussions": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_author_before_date", "params":{"author":"steemit","start_permlink":"firstpost","before_date":"2016-04-19T22:49:43","limit":1}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### tags_api.get_discussions_by_blog

Returns a list of discussions by blog.

##### Query Parameters JSON

    {
      "tag": "",
      "limit": 0,
      "filter_tags": [],
      "select_authors": [],
      "select_tags": [],
      "truncate_body": 0
    }

##### Expected Response JSON

    {"discussions": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_blog", "params":{"tag":"steemit","limit":1}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_blog", "params":{"tag":"alice","limit":10}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### tags_api.get_discussions_by_cashout

Returns a list of discussions by cashout.

##### Query Parameters JSON

    {
      "tag": "",
      "limit": 0,
      "filter_tags": [],
      "select_authors": [],
      "select_tags": [],
      "truncate_body": 0
    }

##### Expected Response JSON

    {"discussions": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_cashout", "params":{"tag":"steem","limit":1}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_cashout", "params":{"tag":"photography","limit":10,"truncate_body":0}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### tags_api.get_discussions_by_children

Returns a list of discussions by children.

##### Query Parameters JSON

    {
      "tag": "",
      "limit": 0,
      "filter_tags": [],
      "select_authors": [],
      "select_tags": [],
      "truncate_body": 0
    }

##### Expected Response JSON

    {"discussions": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_children", "params":{"tag":"steem","limit":1}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_children", "params":{"tag":"photography","limit":10,"truncate_body":0}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### tags_api.get_discussions_by_comments

Returns a list of discussions by comments.

##### Query Parameters JSON

    {
      "tag": "",
      "limit": 0,
      "filter_tags": [],
      "select_authors": [],
      "select_tags": [],
      "truncate_body": 0
    }

##### Expected Response JSON

    {"discussions": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_comments", "params":{"start_author":"steemit","start_permlink":"firstpost","limit":1}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_comments", "params":{"start_author":"alice","start_permlink":"a-post-by-alice","limit":10,"truncate_body":0}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### tags_api.get_discussions_by_created

Returns a list of discussions by created.

##### Query Parameters JSON

    {
      "tag": "",
      "limit": 0,
      "filter_tags": [],
      "select_authors": [],
      "select_tags": [],
      "truncate_body": 0
    }

##### Expected Response JSON

    {"discussions": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_created", "params":{"tag":"steem","limit":1}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_created", "params":{"tag":"photography","limit":10,"truncate_body":0}, "id":1}' https://api.steemit.com

- Since: HF14
- Working on mainnet
- Working on testnet

#### tags_api.get_discussions_by_feed

Returns a list of discussions by feed.

##### Query Parameters JSON

    {
      "tag": "",
      "limit": 0,
      "filter_tags": [],
      "select_authors": [],
      "select_tags": [],
      "truncate_body": 0
    }

##### Expected Response JSON

    {"discussions": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_feed", "params":{"tag":"steem","limit":1}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_feed", "params":{"tag":"photography","limit":10,"truncate_body":0}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### tags_api.get_discussions_by_hot

Returns a list of discussions by hot.

##### Query Parameters JSON

    {
      "tag": "",
      "limit": 0,
      "filter_tags": [],
      "select_authors": [],
      "select_tags": [],
      "truncate_body": 0
    }

##### Expected Response JSON

    {"discussions": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_hot", "params":{"tag":"steem","limit":1}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_hot", "params":{"tag":"photography","limit":10,"truncate_body":0}, "id":1}' https://api.steemit.com

- Since: HF13
- Working on mainnet
- Working on testnet

#### tags_api.get_discussions_by_promoted

Returns a list of discussions by promoted.

##### Query Parameters JSON

    {
      "tag": "",
      "limit": 0,
      "filter_tags": [],
      "select_authors": [],
      "select_tags": [],
      "truncate_body": 0
    }

##### Expected Response JSON

    {"discussions": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_promoted", "params":{"tag":"steem","limit":1}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_promoted", "params":{"tag":"photography","limit":10,"truncate_body":0}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### tags_api.get_discussions_by_trending

Returns a list of discussions by trending.

##### Query Parameters JSON

    {
      "tag": "",
      "limit": 0,
      "filter_tags": [],
      "select_authors": [],
      "select_tags": [],
      "truncate_body": 0
    }

##### Expected Response JSON

    {"discussions": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_trending", "params":{"tag":"steem","limit":1}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_trending", "params":{"tag":"photography","limit":10,"truncate_body":0}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### tags_api.get_discussions_by_votes

Returns a list of discussions by votes.

##### Query Parameters JSON

    {
      "tag": "",
      "limit": 0,
      "filter_tags": [],
      "select_authors": [],
      "select_tags": [],
      "truncate_body": 0
    }

##### Expected Response JSON

    {"discussions": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_votes", "params":{"tag":"steem","limit":1}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussions_by_votes", "params":{"tag":"photography","limit":10,"truncate_body":0}, "id":1}' https://api.steemit.com

- Since: HF17
- Working on mainnet
- Working on testnet

#### tags_api.get_post_discussions_by_payout

Returns a list of post discussions by payout.

##### Query Parameters JSON

    {
      "tag": "",
      "limit": 0,
      "filter_tags": [],
      "select_authors": [],
      "select_tags": [],
      "truncate_body": 0
    }

##### Expected Response JSON

    {"discussions": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_post_discussions_by_payout", "params":{"tag":"steem","limit":1}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_post_discussions_by_payout", "params":{"tag":"photography","limit":10,"truncate_body":0}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### tags_api.get_replies_by_last_update

Returns a list of replies by last update.

##### Query Parameters JSON

    {
      "start_parent_author": "",
      "start_permlink": "",
      "limit": 100
    }

##### Expected Response JSON

    {"discussions": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_replies_by_last_update", "params":{"start_parent_author":"steemit","start_permlink":"firstpost","limit":1}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### tags_api.get_tags_used_by_author

Returns a list of tags used by an author.

##### Query Parameters JSON

    {"author": ""}

##### Expected Response JSON

    {"tags": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_tags_used_by_author", "params":{"author":"steemit"}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### tags_api.get_trending_tags

Returns the list of trending tags.

##### Query Parameters JSON

    {"start_tag": "", "limit": 100}

##### Expected Response JSON

    {"tags": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_trending_tags", "params":{"start_tag":null,"limit":100}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_trending_tags", "params":{"start_tag":"steem","limit":10}, "id":1}' https://api.steemit.com