post_tags_api

Module Group: Posts
Parsing Order: 250
Database Size: 13.040 GB

The post_tags_api provides access to tag usage statistics for posts and comments on the Steem blockchain. It tracks both all-time and active (recent) tag usage, allowing filtering by author or community.

Configuration

{
   "id": "post_tags_api",
   "group_id": "posts",
   "parsing_order": 250,
   "required_modules": ["chain_api"],
   "referenced_modules": ["communities_api"],
   "parse_reversible": true,
   "event_handlers": [
      "chain_api.onCreatePost",
      "chain_api.onUpdatePost",
      "chain_api.onRemovePost"
   ]
}

Database Info

{
   "name": "post_tags_api",
   "size": "13.040 GB",
   "page_size": "4096 Bytes",
   "type": "SQLITE",
   "journal_mode": "WAL",
   "busy_timeout": 10000,
   "log_level": "INFO"
}

Endpoints Overview

Category	Endpoint	Description
Config	getConfig	Module configuration
All Post Tags	getTopPostTags	Top tags from all posts
All Post Tags	getTopPostTagsByAuthor	Top tags by author (all posts)
All Post Tags	getTopPostTagsByCommunity	Top tags by community (all posts)
Active Post Tags	getTopActivePostTags	Top tags from active posts
Active Post Tags	getTopActivePostTagsByAuthor	Top tags by author (active posts)
Active Post Tags	getTopActivePostTagsByCommunity	Top tags by community (active posts)
All Comment Tags	getTopCommentTags	Top tags from all comments
All Comment Tags	getTopCommentTagsByAuthor	Top tags by author (all comments)
All Comment Tags	getTopCommentTagsByCommunity	Top tags by community (all comments)
Active Comment Tags	getTopActiveCommentTags	Top tags from active comments
Active Comment Tags	getTopActiveCommentTagsByAuthor	Top tags by author (active comments)
Active Comment Tags	getTopActiveCommentTagsByCommunity	Top tags by community (active comments)

Endpoints

getConfig

Returns this module's active configuration.

Endpoint

/post_tags_api/getConfig

Example Request

https://sds.steemworld.org/post_tags_api/getConfig

Result: JSON Object containing the module configuration

All Post Tags

getTopPostTags

Returns a list of all tags used in posts across the entire blockchain, grouped by tag, ordered by usage count descending.

Endpoint

/post_tags_api/getTopPostTags/:limit?/:offset?

Parameters

Name	Type	Optional	Default	Description
`:limit`	int	Yes	100	Maximum number of results (max: 1000)
`:offset`	int	Yes	0	Result offset for pagination

Max. Limit: 1000

Example Request

https://sds.steemworld.org/post_tags_api/getTopPostTags/5

Example Response:

{
   "code": 0,
   "result": {
      "cols": {"tag": 0, "count": 1},
      "rows": [
         ["life", 4061848],
         ["photography", 3500306],
         ["steemit", 2581420],
         ["steemexclusive", 1707470],
         ["blog", 1657706]
      ]
   }
}

getTopPostTagsByAuthor

Returns a list of all tags used in a specific author's posts, grouped by tag, ordered by usage count descending.

Endpoint

/post_tags_api/getTopPostTagsByAuthor/:author/:limit?/:offset?

Parameters

Name	Type	Optional	Default	Description
`:author`	string	No	-	Account name of the author
`:limit`	int	Yes	100	Maximum number of results (max: 1000)
`:offset`	int	Yes	0	Result offset for pagination

Max. Limit: 1000

Example Request

https://sds.steemworld.org/post_tags_api/getTopPostTagsByAuthor/steemchiller/5

Example Response:

{
   "code": 0,
   "result": {
      "cols": {"tag": 0, "count": 1},
      "rows": [
         ["steem", 92],
         ["dev", 88],
         ["steemworld", 82],
         ["tools", 67],
         ["deutsch", 51]
      ]
   }
}

getTopPostTagsByCommunity

Returns a list of all tags used in a specific community's posts, grouped by tag, ordered by usage count descending.

Endpoint

/post_tags_api/getTopPostTagsByCommunity/:community/:limit?/:offset?

Parameters

Name	Type	Optional	Default	Description
`:community`	string	No	-	Community identifier (e.g., hive-172186)
`:limit`	int	Yes	100	Maximum number of results (max: 1000)
`:offset`	int	Yes	0	Result offset for pagination

Max. Limit: 1000

Example Request

https://sds.steemworld.org/post_tags_api/getTopPostTagsByCommunity/hive-172186/5

Example Response:

{
   "code": 0,
   "result": {
      "cols": {"tag": 0, "count": 1},
      "rows": [
         ["steemexclusive", 35700],
         ["steemit", 25270],
         ["achievement1", 18870],
         ["introduceyourself", 14319],
         ["venezuela", 13960]
      ]
   }
}

Active Post Tags

Note: "Active" posts refer to posts that are within the payout window (typically 7 days).

getTopActivePostTags

Returns a list of all tags used in active posts, grouped by tag, ordered by usage count descending.

Endpoint

/post_tags_api/getTopActivePostTags/:limit?/:offset?

Parameters

Name	Type	Optional	Default	Description
`:limit`	int	Yes	100	Maximum number of results (max: 1000)
`:offset`	int	Yes	0	Result offset for pagination

Max. Limit: 1000

Example Request

https://sds.steemworld.org/post_tags_api/getTopActivePostTags/5

Example Response:

{
   "code": 0,
   "result": {
      "cols": {"tag": 0, "count": 1},
      "rows": [
         ["krsuccess", 4364],
         ["steemexclusive", 3070],
         ["life", 1756],
         ["wherein", 1446],
         ["kr", 1441]
      ]
   }
}

getTopActivePostTagsByAuthor

Returns a list of all tags used in a specific author's active posts, grouped by tag, ordered by usage count descending.

Endpoint

/post_tags_api/getTopActivePostTagsByAuthor/:author/:limit?/:offset?

Parameters

Name	Type	Optional	Default	Description
`:author`	string	No	-	Account name of the author
`:limit`	int	Yes	100	Maximum number of results (max: 1000)
`:offset`	int	Yes	0	Result offset for pagination

Max. Limit: 1000

Example Request

https://sds.steemworld.org/post_tags_api/getTopActivePostTagsByAuthor/steemchiller

getTopActivePostTagsByCommunity

Returns a list of all tags used in a specific community's active posts, grouped by tag, ordered by usage count descending.

Endpoint

/post_tags_api/getTopActivePostTagsByCommunity/:community/:limit?/:offset?

Parameters

Name	Type	Optional	Default	Description
`:community`	string	No	-	Community identifier (e.g., hive-172186)
`:limit`	int	Yes	100	Maximum number of results (max: 1000)
`:offset`	int	Yes	0	Result offset for pagination

Max. Limit: 1000

Example Request

https://sds.steemworld.org/post_tags_api/getTopActivePostTagsByCommunity/hive-172186/5

All Comment Tags

getTopCommentTags

Returns a list of all tags used in comments across the entire blockchain, grouped by tag, ordered by usage count descending.

Endpoint

/post_tags_api/getTopCommentTags/:limit?/:offset?

Parameters

Name	Type	Optional	Default	Description
`:limit`	int	Yes	100	Maximum number of results (max: 1000)
`:offset`	int	Yes	0	Result offset for pagination

Max. Limit: 1000

Example Request

https://sds.steemworld.org/post_tags_api/getTopCommentTags/5

Example Response:

{
   "code": 0,
   "result": {
      "cols": {"tag": 0, "count": 1},
      "rows": [
         ["kr", 3963396],
         ["photography", 3279233],
         ["life", 2465553],
         ["steemit", 2353107],
         ["hive-129948", 1914329]
      ]
   }
}

getTopCommentTagsByAuthor

Returns a list of all tags used in a specific author's comments, grouped by tag, ordered by usage count descending.

Endpoint

/post_tags_api/getTopCommentTagsByAuthor/:author/:limit?/:offset?

Parameters

Name	Type	Optional	Default	Description
`:author`	string	No	-	Account name of the author
`:limit`	int	Yes	100	Maximum number of results (max: 1000)
`:offset`	int	Yes	0	Result offset for pagination

Max. Limit: 1000

Example Request

https://sds.steemworld.org/post_tags_api/getTopCommentTagsByAuthor/steemchiller/5

getTopCommentTagsByCommunity

Returns a list of all tags used in a specific community's comments, grouped by tag, ordered by usage count descending.

Endpoint

/post_tags_api/getTopCommentTagsByCommunity/:community/:limit?/:offset?

Parameters

Name	Type	Optional	Default	Description
`:community`	string	No	-	Community identifier (e.g., hive-172186)
`:limit`	int	Yes	100	Maximum number of results (max: 1000)
`:offset`	int	Yes	0	Result offset for pagination

Max. Limit: 1000

Example Request

https://sds.steemworld.org/post_tags_api/getTopCommentTagsByCommunity/hive-172186/5

Active Comment Tags

Note: "Active" comments refer to comments that are within the payout window (typically 7 days).

getTopActiveCommentTags

Returns a list of all tags used in active comments, grouped by tag, ordered by usage count descending.

Endpoint

/post_tags_api/getTopActiveCommentTags/:limit?/:offset?

Parameters

Name	Type	Optional	Default	Description
`:limit`	int	Yes	100	Maximum number of results (max: 1000)
`:offset`	int	Yes	0	Result offset for pagination

Max. Limit: 1000

Example Request

https://sds.steemworld.org/post_tags_api/getTopActiveCommentTags/5

Example Response:

{
   "code": 0,
   "result": {
      "cols": {"tag": 0, "count": 1},
      "rows": [
         ["hive-188619", 1833],
         ["kr", 846],
         ["hive-196917", 833],
         ["hot", 626],
         ["steem", 569]
      ]
   }
}

getTopActiveCommentTagsByAuthor

Returns a list of all tags used in a specific author's active comments, grouped by tag, ordered by usage count descending.

Endpoint

/post_tags_api/getTopActiveCommentTagsByAuthor/:author/:limit?/:offset?

Parameters

Name	Type	Optional	Default	Description
`:author`	string	No	-	Account name of the author
`:limit`	int	Yes	100	Maximum number of results (max: 1000)
`:offset`	int	Yes	0	Result offset for pagination

Max. Limit: 1000

Example Request

https://sds.steemworld.org/post_tags_api/getTopActiveCommentTagsByAuthor/steemchiller

getTopActiveCommentTagsByCommunity

Returns a list of all tags used in a specific community's active comments, grouped by tag, ordered by usage count descending.

Endpoint

/post_tags_api/getTopActiveCommentTagsByCommunity/:community/:limit?/:offset?

Parameters

Name	Type	Optional	Default	Description
`:community`	string	No	-	Community identifier (e.g., hive-172186)
`:limit`	int	Yes	100	Maximum number of results (max: 1000)
`:offset`	int	Yes	0	Result offset for pagination

Max. Limit: 1000

Example Request

https://sds.steemworld.org/post_tags_api/getTopActiveCommentTagsByCommunity/hive-172186

Column Definitions

Column	Description
`tag`	The tag name/string
`count`	Number of times the tag has been used

Response Format

All endpoints return data in the standard SDS format:

{
   "code": 0,
   "result": {
      "cols": {"tag": 0, "count": 1},
      "rows": [
         ["tag_name", usage_count],
         ...
      ]
   }
}

code: 0 indicates success
cols: Column name to index mapping
rows: Array of result rows with values in column order

Use Cases

Trending tag analysis - Identify popular topics on the platform
Author content analysis - Understand an author's preferred topics
Community insights - See what topics are popular in specific communities
Content categorization - Find appropriate tags for new content
Tag popularity comparison - Compare all-time vs active tag usage
Content discovery - Find trending topics to engage with
Marketing research - Identify niche topics and communities

Notes

All vs Active: "All" endpoints include historical data from all posts/comments. "Active" endpoints only include content within the payout window (~7 days).
Results are ordered by usage count descending (most used first)
All endpoints support pagination via limit and offset
Community identifiers typically follow the hive-XXXXXX format
The API references the communities_api module for community filtering

Back to Main Index