Hive Developer Portal
Methods:
Used to lookup information about tags, posts, and discussions. These AppBase API methods are still under development and subject to change.
Replacement / Successor
- Replacement:
condenser_api.get_active_votes
Use the condenser endpoint for active votes on a known post.
Replacement / Successor
- Spiritual successor:
bridge.get_ranked_posts
Use
sort: payout_commentsfor payout-ranked comment discovery.
Replacement / Successor
- Spiritual successor:
bridge.get_discussion
Use when the caller needs reply or thread context for a post.
tags_api.get_discussion
Obsolete. Current Hive source no longer defines the tags_api plugin. Historical documentation is retained for compatibility context.
Returns the discussion given an author and permlink.
Also see: bridge.get_discussion
Replacement / Successor
- Spiritual successor:
bridge.get_discussion
Use for the current Hivemind-backed flattened discussion tree.
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_hbd": 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":"hiveio", "permlink":"firstpost"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"tags_api.get_discussion", "params":{"author":"alice", "permlink":"a-post-by-alice"}, "id":1}' https://api.hive.blog
Replacement / Successor
- None:
No direct documented replacement
Use
bridge.get_ranked_postswithsort: hot,sort: trending, orsort: createddepending on the product intent; none is an exact active-date query.
tags_api.get_discussions_by_author_before_date
Removed since HF24. See successor guidance below.
Also see: Paginated API Methods
Replacement / Successor
- Spiritual successor:
bridge.get_account_posts
Use
sort: postsorsort: replieswith pagination; it is not a 1-to-1 date-before query.
Replacement / Successor
- Spiritual successor:
bridge.get_account_posts
Use
sort: blogfor account blog and reblog listings.
Replacement / Successor
- Spiritual successor:
bridge.get_ranked_posts
Use
sort: payoutfor payout-oriented post discovery; exact cashout-time ordering is not preserved.
Replacement / Successor
- None:
No direct documented replacement
Use indexed Hivemind, HAFSQL, or HiveSQL data when child-count ordering is required.
Replacement / Successor
- None:
No direct documented replacement
Use indexed Hivemind, HAFSQL, or HiveSQL data when comment-count ordering is required.
Replacement / Successor
- Spiritual successor:
bridge.get_ranked_posts
Use
sort: createdfor current newest-post discovery.
Replacement / Successor
- Spiritual successor:
bridge.get_account_posts
Use
sort: feedfor account feed listings.
Replacement / Successor
- Spiritual successor:
bridge.get_ranked_posts
Use
sort: hotfor current hot-ranked post discovery.
Replacement / Successor
- Spiritual successor:
bridge.get_ranked_posts
Use
sort: promotedfor promoted post discovery.
Replacement / Successor
- Spiritual successor:
bridge.get_ranked_posts
Use
sort: trendingfor current trending post discovery.
Replacement / Successor
- None:
No direct documented replacement
Use
bridge.get_ranked_postsfor hot/trending discovery, or an indexed data source when strict vote ordering is required.
Replacement / Successor
- Spiritual successor:
bridge.get_ranked_posts
Use
sort: payoutfor payout-ranked post discovery.
Replacement / Successor
- Spiritual successor:
bridge.get_discussion
Use for reply context on a known post; exact last-update ordering requires indexed data.