invantive documentation
Invantive Support ForumsLog In / Sign Up

Top_Topic_listTopics: Discourse Top Topics

read only REST

  • Catalog: Discourse
  • Schema: Topics
  • Label: Top Topics

Get the top topics

Can only retrieve data.

Summary

Get the top topics

API Source

  • Endpoint: /top.json
  • Operation: get /top.json

Performance Characteristics

Characteristic Value
Average access latency (ms) 243
Write rows per minute 219

The result can be cached on the client.

Table Columns

The columns of the table Top_Topic_listTopics are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert and update.

Name Data Type Label Required Marks Documentation
archetype varchar2 Archetype writable, archetype
archived char Archived writable, archived
bookmarked char Bookmarked writable, bookmarked
bumped char Bumped writable, bumped
bumped_at varchar2 Bumped at writable, bumped_at
can_create_topic char Can Create Topic writable, ::ancestor.can_create_topic
can_have_answer char Can Have Answer filters on the platform, writable, can_have_answer
can_vote char Can Vote filters on the platform, writable, can_vote
category_id decimal Category ID writable, category_id
closed char Closed writable, closed
created_at varchar2 Created at writable, created_at
draft varchar2 Draft writable The JSON text of the nested object.
draft_key varchar2 Draft Key writable, ::ancestor.draft_key
draft_sequence decimal Draft Sequence writable, ::ancestor.draft_sequence
fancy_title varchar2 Fancy Title writable, fancy_title
for_period varchar2 For Period writable, ::ancestor.for_period
has_accepted_answer char Has Accepted Answer filters on the platform, writable, has_accepted_answer
has_summary char Has Summary writable, has_summary
highest_post_number decimal Highest Post Number writable, highest_post_number
id decimal ID writable, id
image_url varchar2 Image URL writable The JSON text of the nested object.
last_posted_at varchar2 Last Posted at writable, last_posted_at
last_poster_username varchar2 Last Poster Username writable, last_poster_username
last_read_post_number decimal Last Read Post Number writable, last_read_post_number
like_count decimal #Likes writable, like_count
liked char Liked writable, liked
new_posts decimal New Posts writable, new_posts
notification_level decimal Notification Level writable, notification_level
per_page decimal Per Page writable, ::ancestor.per_page
pinned char Pinned writable, pinned
pinned_globally char Pinned Globally writable, pinned_globally
posts_count decimal #Posts writable, posts_count
reply_count decimal #Replies writable, reply_count
slug varchar2 Slug writable, slug
title varchar2 Title writable, title
unpinned varchar2 Unpinned writable The JSON text of the nested object.
unread decimal Unread writable, unread
unseen char Unseen writable, unseen
user_voted char User Voted filters on the platform, writable, user_voted
views decimal Views writable, views
visible char Visible writable, visible
vote_count int32 Vote Count filters on the platform, writable, vote_count

Keys

Key Column Refers to Kind Description
Top_Topic_listTopics_category_id_cnd category_id Categories.id Candidate Not stated by Discourse; found on the data of the smoke forum on 2026-10-31, where every filled value is in the referenced table.
Top_Topic_listTopics_last_poster_username_cnd last_poster_username Top_Users.username Candidate Not stated by Discourse; found on the data of the smoke forum on 2026-10-31, where every filled value is in the referenced table.

Referenced By

Release Notes

What changed per release in the tables, columns, attributes and capabilities of the driver:

Changes of This Table, 26.0 to 27.0

  • ~ category_id (database_data_type: decimal → int64)
  • ~ category_id (dotnet_data_type: decimal → int64)
  • ~ draft_sequence (database_data_type: decimal → int64)
  • ~ draft_sequence (dotnet_data_type: decimal → int64)
  • ~ highest_post_number (database_data_type: decimal → int64)
  • ~ highest_post_number (dotnet_data_type: decimal → int64)
  • ~ id (database_data_type: decimal → int64)
  • ~ id (dotnet_data_type: decimal → int64)
  • ~ last_read_post_number (database_data_type: decimal → int64)
  • ~ last_read_post_number (dotnet_data_type: decimal → int64)
  • ~ like_count (database_data_type: decimal → int64)
  • ~ like_count (dotnet_data_type: decimal → int64)
  • - new_posts
  • ~ notification_level (database_data_type: decimal → int64)
  • ~ notification_level (dotnet_data_type: decimal → int64)

17 more changes

Discourse.Topics.Top_Topic_listTopics: type changes

Type of Discourse.Topics.Top_Topic_listTopics changes from table to tablefunction.

What to Do

Check statements, views and scripts that use it before the upgrade.

  • can break a statement
  • table → tablefunction
  • importance 3
Parameter per_page is added to Discourse.Topics.Top_Topic_listTopics

Optional.

  • importance 2
Parameter period is added to Discourse.Topics.Top_Topic_listTopics

Optional.

  • importance 2

  • ~ per_page (database_data_type: decimal → int64)
  • ~ per_page (dotnet_data_type: decimal → int64)
  • ~ posts_count (database_data_type: decimal → int64)
  • ~ posts_count (dotnet_data_type: decimal → int64)
  • ~ reply_count (database_data_type: decimal → int64)
  • ~ reply_count (dotnet_data_type: decimal → int64)
  • ~ unpinned (database_data_type: varchar2 → char)
  • ~ unpinned (dotnet_data_type: string → boolean)
  • - unread
  • ~ views (database_data_type: decimal → int64)
  • ~ views (dotnet_data_type: decimal → int64)
  • + featured_link (varchar2)
  • + op_like_count (int64)
  • + unread_posts (int64)

All changes of the driver, 26.0 to 27.0