---
title: "Search Thread"
method: POST
path: "/search/threads"
tags: ["Searching"]
---

# Search Thread

`POST /search/threads`

Search for threads.

Required scopes:
+ **post**

## Request body

- object
  - `q` string — Search query. Can be skipped if **user_id** is set.
  - `tag` string — Tag to search for tagged contents.
  - `forum_id` integer — Id of the container forum to search for contents. Child forums of the specified forum will be included in the search.
  - `user_id` union
    - string
    - integer
  - `page` integer — Page number of results.
  - `limit` integer — Number of results in a page.
  - `data_limit` integer — Number of thread data to be returned.
  - `before` integer — The time in milliseconds (e.g. 1767214800) before last content date.

## Response `200`

Successful Response.

- object
  - `data` RespSearchResultThread[], required
    - `content_type` 'thread', required
    - `content_id` integer, required
    - `node_title` string, required
    - `thread_id` integer, required
    - `forum_id` integer, required
    - `thread_title` string, required
    - `thread_view_count` integer, required
    - `creator_user_id` integer, required
    - `creator_username` string, required
    - `creator_username_html` string, required
    - `thread_create_date` integer, required
    - `thread_update_date` integer, required
    - `thread_reply_group_id` integer, required
    - `thread_comment_ignore_group` integer, required
    - `thread_last_bump_date` integer, required
    - `user_is_ignored` boolean, required
    - `thread_post_count` integer, required
    - `thread_is_liked` boolean, required
    - `thread_is_bumped` boolean, required
    - `thread_is_published` boolean, required
    - `thread_is_deleted` boolean, required
    - `thread_is_sticky` boolean, required
    - `thread_is_closed` boolean, required
    - `thread_is_followed` boolean, required
    - `thread_is_starred` boolean, required
    - `thread_hide_contacts` boolean
    - `thread_allow_ask_hidden_content` boolean
    - `first_post` RespPostModel, required
      - `post_id` integer, required
      - `thread_id` integer, required
      - `poster_user_id` integer, required
      - `poster_username` string, required
      - `poster_username_html` string, required
      - `poster_is_banned` integer, required
      - `poster_is_staff` integer, required
      - `post_create_date` integer, required
      - `post_body` string, required
      - `post_body_html` string, required
      - `post_body_plain_text` string, required
      - `signature` string, required
      - `signature_html` string, required
      - `signature_plain_text` string, required
      - `post_like_count` integer, required
      - `delete_info` object
        - `user_id` integer, required
        - `username` string, required
        - `username_html` string, required
        - `date` integer, required
        - `reason` string, required
      - `user_is_ignored` boolean, required
      - `post_is_sticked` boolean, required
      - `post_is_published` boolean, required
      - `post_is_deleted` boolean, required
      - `post_update_date` integer, required
      - `post_is_first_post` boolean, required
      - `post_is_liked` boolean, required
      - `links` object, required
        - `permalink` string, required
        - `detail` string, required
        - `thread` string, required
        - `poster` string, required
        - `likes` string, required
        - `report` string, required
        - `poster_avatar` string, required
      - `permissions` object, required
        - `view` boolean, required
        - `edit` boolean, required
        - `delete` boolean, required
        - `undelete` boolean, required
        - `reply` boolean, required
        - `like` boolean, required
        - `report` boolean, required
        - `stick` boolean, required
        - `unstick` boolean, required
      - `thread_is_deleted` boolean, required
      - `thread_is_closed` boolean, required
      - `thread` RespThreadModel, required
        - `thread_id` integer, required
        - `forum_id` integer, required
        - `thread_title` string, required
        - `thread_view_count` integer, required
        - `creator_user_id` integer, required
        - `creator_username` string, required
        - `creator_username_html` string, required
        - `thread_create_date` integer, required
        - `thread_update_date` integer, required
        - `thread_reply_group_id` integer, required
        - `thread_comment_ignore_group` integer, required
        - `thread_last_bump_date` integer, required
        - `user_is_ignored` boolean, required
        - `thread_post_count` integer, required
        - `thread_is_liked` boolean, required
        - `thread_is_bumped` boolean, required
        - `thread_is_published` boolean, required
        - `thread_is_deleted` boolean, required
        - `thread_is_sticky` boolean, required
        - `thread_is_closed` boolean, required
        - `thread_is_followed` boolean, required
        - `thread_is_starred` boolean, required
        - `thread_hide_contacts` boolean
        - `thread_allow_ask_hidden_content` boolean
        - `first_post` RespPostModel, required — recursive
        - `thread_prefixes` object[], required
          - `prefix_id` integer
          - `prefix_title` string
        - `thread_tags` object, required
        - `links` object, required
          - `permalink` string, required
          - `detail` string, required
          - `followers` string, required
          - `forum` string, required
          - `posts` string, required
          - `first_poster` string, required
          - `first_poster_avatar` string, required
          - `first_post` string, required
          - `last_poster` string
          - `last_post` string
        - `permissions` object, required
          - `view` boolean, required
          - `delete` boolean, required
          - `follow` boolean, required
          - `post` boolean, required
          - `edit` boolean, required
          - `bump` object, required
            - `can` boolean, required
            - `available_count` integer, required
            - `error` string, required
            - `next_available_time` integer, required
        - `node_title` string, required
        - `last_post` RespPostModel — recursive
        - `contest` object
          - `type` string, required
          - `finish_date` integer, required
          - `now_count_members` integer, required
          - `needed_members` integer, required
          - `is_finished` integer, required
          - `count_winners` integer, required
          - `require_like_count` integer, required
          - `require_total_like_count` integer, required
          - `prize_type` string, required
          - `prize_type_phrase` string, required
          - `prize_data` union, required
            - object
            - integer
          - `prize_cost` integer, required
          - `is_money_places` integer, required
          - `chance_to_win` number, required
          - `prize_per_winner` integer, nullable, required
          - `prize_places` object, nullable, required
            - `place` integer, required
            - `amount` integer, required
          - `already_participate` boolean, required
          - `permissions` object, required
            - `can_finish` boolean, required
            - `can_participate` boolean, required
            - `can_view_user_list` boolean, required
    - `thread_prefixes` object[], required
      - `prefix_id` integer
      - `prefix_title` string
    - `thread_tags` object, required
    - `links` object, required
      - `permalink` string, required
      - `detail` string, required
      - `followers` string, required
      - `forum` string, required
      - `posts` string, required
      - `first_poster` string, required
      - `first_poster_avatar` string, required
      - `first_post` string, required
      - `last_poster` string
      - `last_post` string
    - `permissions` object, required
      - `view` boolean, required
      - `delete` boolean, required
      - `follow` boolean, required
      - `post` boolean, required
      - `edit` boolean, required
      - `bump` object, required
        - `can` boolean, required
        - `available_count` integer, required
        - `error` string, required
        - `next_available_time` integer, required
    - `last_post` RespPostModel
      - `post_id` integer, required
      - `thread_id` integer, required
      - `poster_user_id` integer, required
      - `poster_username` string, required
      - `poster_username_html` string, required
      - `poster_is_banned` integer, required
      - `poster_is_staff` integer, required
      - `post_create_date` integer, required
      - `post_body` string, required
      - `post_body_html` string, required
      - `post_body_plain_text` string, required
      - `signature` string, required
      - `signature_html` string, required
      - `signature_plain_text` string, required
      - `post_like_count` integer, required
      - `delete_info` object
        - `user_id` integer, required
        - `username` string, required
        - `username_html` string, required
        - `date` integer, required
        - `reason` string, required
      - `user_is_ignored` boolean, required
      - `post_is_sticked` boolean, required
      - `post_is_published` boolean, required
      - `post_is_deleted` boolean, required
      - `post_update_date` integer, required
      - `post_is_first_post` boolean, required
      - `post_is_liked` boolean, required
      - `links` object, required
        - `permalink` string, required
        - `detail` string, required
        - `thread` string, required
        - `poster` string, required
        - `likes` string, required
        - `report` string, required
        - `poster_avatar` string, required
      - `permissions` object, required
        - `view` boolean, required
        - `edit` boolean, required
        - `delete` boolean, required
        - `undelete` boolean, required
        - `reply` boolean, required
        - `like` boolean, required
        - `report` boolean, required
        - `stick` boolean, required
        - `unstick` boolean, required
      - `thread_is_deleted` boolean, required
      - `thread_is_closed` boolean, required
      - `thread` RespThreadModel, required
        - `thread_id` integer, required
        - `forum_id` integer, required
        - `thread_title` string, required
        - `thread_view_count` integer, required
        - `creator_user_id` integer, required
        - `creator_username` string, required
        - `creator_username_html` string, required
        - `thread_create_date` integer, required
        - `thread_update_date` integer, required
        - `thread_reply_group_id` integer, required
        - `thread_comment_ignore_group` integer, required
        - `thread_last_bump_date` integer, required
        - `user_is_ignored` boolean, required
        - `thread_post_count` integer, required
        - `thread_is_liked` boolean, required
        - `thread_is_bumped` boolean, required
        - `thread_is_published` boolean, required
        - `thread_is_deleted` boolean, required
        - `thread_is_sticky` boolean, required
        - `thread_is_closed` boolean, required
        - `thread_is_followed` boolean, required
        - `thread_is_starred` boolean, required
        - `thread_hide_contacts` boolean
        - `thread_allow_ask_hidden_content` boolean
        - `first_post` RespPostModel, required — recursive
        - `thread_prefixes` object[], required
          - `prefix_id` integer
          - `prefix_title` string
        - `thread_tags` object, required
        - `links` object, required
          - `permalink` string, required
          - `detail` string, required
          - `followers` string, required
          - `forum` string, required
          - `posts` string, required
          - `first_poster` string, required
          - `first_poster_avatar` string, required
          - `first_post` string, required
          - `last_poster` string
          - `last_post` string
        - `permissions` object, required
          - `view` boolean, required
          - `delete` boolean, required
          - `follow` boolean, required
          - `post` boolean, required
          - `edit` boolean, required
          - `bump` object, required
            - `can` boolean, required
            - `available_count` integer, required
            - `error` string, required
            - `next_available_time` integer, required
        - `node_title` string, required
        - `last_post` RespPostModel — recursive
        - `contest` object
          - `type` string, required
          - `finish_date` integer, required
          - `now_count_members` integer, required
          - `needed_members` integer, required
          - `is_finished` integer, required
          - `count_winners` integer, required
          - `require_like_count` integer, required
          - `require_total_like_count` integer, required
          - `prize_type` string, required
          - `prize_type_phrase` string, required
          - `prize_data` union, required
            - object
            - integer
          - `prize_cost` integer, required
          - `is_money_places` integer, required
          - `chance_to_win` number, required
          - `prize_per_winner` integer, nullable, required
          - `prize_places` object, nullable, required
            - `place` integer, required
            - `amount` integer, required
          - `already_participate` boolean, required
          - `permissions` object, required
            - `can_finish` boolean, required
            - `can_participate` boolean, required
            - `can_view_user_list` boolean, required
    - `contest` object
      - `type` string, required
      - `finish_date` integer, required
      - `now_count_members` integer, required
      - `needed_members` integer, required
      - `is_finished` integer, required
      - `count_winners` integer, required
      - `require_like_count` integer, required
      - `require_total_like_count` integer, required
      - `prize_type` string, required
      - `prize_type_phrase` string, required
      - `prize_data` union, required
        - object
        - integer
      - `prize_cost` integer, required
      - `is_money_places` integer, required
      - `chance_to_win` number, required
      - `prize_per_winner` integer, nullable, required
      - `prize_places` object, nullable, required
        - `place` integer, required
        - `amount` integer, required
      - `already_participate` boolean, required
      - `permissions` object, required
        - `can_finish` boolean, required
        - `can_participate` boolean, required
        - `can_view_user_list` boolean, required
  - `data_total` integer, required
  - `links` object, required
    - `pages` integer, required
    - `page` integer, required
    - `next` string, required
  - `system_info` RespSystemInfo, required
    - `visitor_id` integer, required
    - `time` integer, required
    - `log_id` integer, required

## Other responses

- `401` — Unauthorized
- `403` — Error Response.

---

[API](https://skmtc.net/lolz/apis/lolzteam-public-api-forum.md) · [All operations](https://skmtc.net/lolz/apis/lolzteam-public-api-forum/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lolz/lolzteam-public-api-forum/revisions/3efcdbc40994/schema)