---
title: "Search Post"
method: POST
path: "/search/posts"
tags: ["Searching"]
---

# Search Post

`POST /search/posts`

Search for posts.

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 post data to be returned.
  - `before` integer — The time in milliseconds (e.g. 1767214800) before last content date.

## Response `200`

Successful Response.

- object
  - `data` union[], required
    - union
      - RespSearchResultThread
        - `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
              - …
            - `thread_tags` object, required
            - `links` object, required
              - …
            - `permissions` object, required
              - …
            - `node_title` string, required
            - `last_post` RespPostModel — recursive
            - `contest` object
              - …
        - `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
              - …
            - `thread_tags` object, required
            - `links` object, required
              - …
            - `permissions` object, required
              - …
            - `node_title` string, required
            - `last_post` RespPostModel — recursive
            - `contest` object
              - …
        - `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
      - RespSearchResultPost
        - `content_type` 'post', required
        - `content_id` integer, required
        - `node_title` string, required
        - `thread_prefixes` object[], required
          - `prefix_id` integer, required
          - `css_class` string, required
          - `prefix_title` string, 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
            - `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_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
              - …
            - `permissions` object, required
              - …
            - `thread_is_deleted` boolean, required
            - `thread_is_closed` boolean, required
            - `thread` RespThreadModel, 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
              - …
          - `node_title` string, 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_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
              - …
            - `permissions` object, required
              - …
            - `thread_is_deleted` boolean, required
            - `thread_is_closed` boolean, required
            - `thread` RespThreadModel, required — 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
              - …
            - `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
              - …
            - `already_participate` boolean, required
            - `permissions` object, 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
  - `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)