---
title: "Internal live search"
method: GET
path: "/live/search/internal"
---

# Internal live search

`GET /live/search/internal`

Initiates the search; will return status and search Id on success.
Limit means max amount of records per bucket to return. Default 10.
- Selector: Must be an email address, domain, social security number (US based), or credit card number. 
- Limit: In some cases, the API might return more results than specified in limit. If an upper hard limit is required, it must be enforced on the client side. 
- Bucket: Optional filter for searching only in the target bucket. See Appendix 1 for list. 
- In case a user makes a new search and the previous one shall be discarded; its search ID shall be specified in the “terminate” parameter to save system resources. Searches may consume Gigabytes of data, therefore any searches that are no longer required shall be terminated. Searches can also be manually terminated via the /live/search/terminate function. 
- Dates: From/to dates may be used as filter. Note that item’s dates are set to when the original data was published if available, or otherwise when it was indexed. This means that newly indexed items are often backdated.

## Query parameters

- `selector` string, required
- `bucket` string
- `skipinvalid` boolean
- `limit` integer
- `analyze` boolean
- `datefrom` string
- `dateto` string
- `terminate` string[]

## Response `200`

Success search

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

## Other responses

- `400` — Invalid input
- `401` — Invalid api token

## Changes

> 12 revisions in range; 1 could not be searched.

- **2025-12-04** `c421471d8fe3` — 2 info
  - for the `query` request parameter `datefrom`, the type/format was generalized from `string`/`date-time` to `string`/``
  - for the `query` request parameter `dateto`, the type/format was generalized from `string`/`date-time` to `string`/``
- **2025-11-26** `9a6ae50eb1c7` — 2 info
  - the response property `id` became required for the status `200`
  - the response property `status` became required for the status `200`
- **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** `722b0ddb9ec4` — 1 breaking, 1 warning, 1 info
  - added the new required `query` request parameter `selector`
  - deleted the `query` request parameter `term`
  - the `query` request parameter `bucket` became optional
- **2025-11-14** `218f8a8b8952` — 6 breaking, 1 warning, 1 info
  - added the new required `query` request parameter `term`
  - the `query` request parameter `bucket` became required
  - for the `query` request parameter `datefrom`, the type/format was changed from `string`/`` to `string`/`date-time`
  - for the `query` request parameter `dateto`, the type/format was changed from `string`/`` to `string`/`date-time`
  - …4 more

[Change history](https://skmtc.dev/intelligencex/apis/intelx-io-search-api/changes/live/search/internal/get.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)