---
title: "Create a new search"
method: POST
path: "/search/"
tags: ["Search"]
---

# Create a new search

`POST /search/`

Create a new search.

## Response `200`

OK

- object
  - `success` boolean
  - `search` Search
    - `search_id` integer
    - `result_count` integer
    - `search_type` string
    - `search_query` string
    - `search_constraints` unknown[]
      - unknown
    - `search_order` string
    - `search_grouping` boolean
    - `warnings` unknown[]
      - unknown
    - `user_id` integer
    - `search_date` integer
    - `query_hash` string

## Other responses

- `default` — Error

## Changes

- **2026-03-18** `e271d0e41f6d` — 2 breaking, 5 info
  - removed the media type `application/json` from the request body
  - the `success` response's property type/format changed from `string`/`` to `boolean`/`` for status `200`
  - api operation id `post_search_` removed and replaced with `postSearch`
  - the endpoint scheme security `XF-Api-Key` was added to the API
  - …3 more
- **2026-02-03** `fc0a40f3b859` — 1 breaking, 4 warning, 4 info
  - the `success` response's property type/format changed from `boolean`/`` to `string`/`` for status `200`
  - the optional response header `XF-Latest-Api-Version` removed for the status `200`
  - the optional response header `XF-Request-User` removed for the status `200`
  - the optional response header `XF-Request-User-Extras` removed for the status `200`
  - …5 more

[Change history](https://skmtc.dev/xenforo-ltd/apis/xenforo-api/changes/search/post.md)

---

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