Steem Developer logo

Steem Developer Portal

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Returns a list of discussions by trending.

{
  "tag": "",
  "limit": 0,
  "filter_tags": [],
  "select_authors": [],
  "select_tags": [],
  "truncate_body": 0
}
{"discussions": []}
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

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

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

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

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

Returns the list of trending tags.

{"start_tag": "", "limit": 100}
{"tags": []}
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