---
title: "Get the top topics filtered by period"
method: GET
path: "/top.json"
tags: ["Topics"]
---

# Get the top topics filtered by period

`GET /top.json`

## Query parameters

- `period` string
- `per_page` integer

## Headers

- `Api-Key` string, required
- `Api-Username` string, required

## Response `200`

response

- object
  - `users` object[]
    - `id` integer
    - `username` string
    - `name` string
    - `avatar_template` string
  - `primary_groups` unknown[]
    - unknown
  - `topic_list` object
    - `can_create_topic` boolean
    - `draft` string, nullable
    - `draft_key` string
    - `draft_sequence` integer
    - `for_period` string
    - `per_page` integer
    - `topics` object[]
      - `id` integer
      - `title` string
      - `fancy_title` string
      - `slug` string
      - `posts_count` integer
      - `reply_count` integer
      - `highest_post_number` integer
      - `image_url` string, nullable
      - `created_at` string
      - `last_posted_at` string
      - `bumped` boolean
      - `bumped_at` string
      - `archetype` string
      - `unseen` boolean
      - `last_read_post_number` integer
      - `unread_posts` integer
      - `pinned` boolean
      - `unpinned` boolean
      - `visible` boolean
      - `closed` boolean
      - `archived` boolean
      - `notification_level` integer
      - `bookmarked` boolean
      - `liked` boolean
      - `views` integer
      - `like_count` integer
      - `has_summary` boolean
      - `last_poster_username` string
      - `category_id` integer
      - `op_like_count` integer
      - `pinned_globally` boolean
      - `featured_link` string, nullable
      - `posters` object[]
        - `extras` string, nullable
        - `description` string
        - `user_id` integer
        - `primary_group_id` integer, nullable

---

[API](https://skmtc.dev/discourse/apis/discourse-api-documentation.md) · [All operations](https://skmtc.dev/discourse/apis/discourse-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/discourse/discourse-api-documentation/revisions/2fd8fd2d6fd0/schema)