---
title: "Initialize an intelligent search and return the ID of the task/search for further processing."
method: POST
path: "/intelligent/search"
---

# Initialize an intelligent search and return the ID of the task/search for further processing.

`POST /intelligent/search`

Initialize an intelligent search and return the ID of the task/search for further processing.

## Query parameters

- `term` string, required
- `maxresults` integer, required
- `buckets` string
- `timeout` integer, required
- `datefrom` string, required
- `dateto` string, required
- `sort` integer, required
- `media` integer, required
- `lookuplevel` integer
- `terminate` string[]

## Response `200`

Success search

- object
  - `status` integer — Result status
  - `id` string

## Other responses

- `400` — Invalid data
- `401` — Invalid api token; not authorized for buckets
- `402` — if no credits available

## Changes

- **2025-11-20** `a27ca98b01bd` — 1 breaking
  - for the `query` request parameter `terminate`, the type/format of property `items/` was specialized from `string`/`` to `string`/`uuid`
- **2025-11-19** `9e744792fc00` — 1 breaking, 1 warning, 1 info
  - added the new required `query` request parameter `term`
  - deleted the `query` request parameter `selector`
  - added the non-success response with the status `402`
- **2025-11-19** `722b0ddb9ec4` — 1 breaking, 1 warning, 2 info
  - added the new required `query` request parameter `selector`
  - deleted the `query` request parameter `term`
  - the `query` request parameter `buckets` became optional
  - for the `query` request parameter `terminate`, the type/format was generalized from `string`/`` to `array`/``
- **2025-11-14** `218f8a8b8952` — 1 breaking, 2 info
  - the `query` request parameter `buckets` became required
  - for the `query` request parameter `terminate`, the type/format was generalized from `array`/`` to `string`/``
  - removed the non-success response with the status `402`

[Change history](https://skmtc.dev/intelligencex/apis/intelx-io-search-api/changes/intelligent/search/post.md)

---

[API](https://skmtc.dev/intelligencex/apis/intelx-io-search-api.md) · [All operations](https://skmtc.dev/intelligencex/apis/intelx-io-search-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/intelligencex/intelx-io-search-api/revisions/09fb9b26ddff/schema)