Search Kagi
kagi_searchRead-only
Retrieve ranked organic web search results from a signed-in Kagi account using optional lenses, pagination, region, and time filters. Returns snippets for each result.
Instructions
Search the signed-in user's Kagi account and return ranked organic results with Kagi-provided search snippets. The default returns one full 20-result lightweight page. Destination pages are not opened or fetched; paginate explicitly when more results are needed.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lens | No | Optional Kagi Lens. Use a known name such as forums, programming, academic, news_360, recipes, small_web, or a numeric ID returned by kagi_list_lenses. The Lens must be active in Kagi settings. | |
| page | No | Kagi result page. Start at 1 and paginate only when needed. | |
| sort | No | Result ordering. Use recency for time-sensitive research. | relevance |
| limit | No | Maximum number of ranked organic results to return. The default returns Kagi's full lightweight HTML result page; lower it when context should be smaller. | |
| query | Yes | The web search query. Kagi operators such as site:example.com may be included. | |
| region | No | Kagi region code. Defaults to no_region (International); use a lowercase ISO country code such as us, gb, cn, or jp, or a locale variant such as ca_fr. | no_region |
| verbatim | No | Match the query text more literally when true. | |
| time_range | No | Optional relative publication-time filter. | any |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | Current Kagi result page, starting at 1. | |
| query | Yes | The submitted search query. | |
| cached | Yes | Whether this response was served from the local memory cache. | |
| filters | Yes | ||
| hasMore | Yes | Whether Kagi exposed a link to another upstream result page. | |
| results | Yes | Ranked organic search results. | |
| returned | Yes | Number of result objects returned to the caller. | |
| elapsedMs | No | Search time reported by Kagi, in milliseconds. | |
| truncated | Yes | True only when limit omitted some recognized results from this page. | |
| contentScope | Yes | Signals that snippets came from Kagi's result page; destination pages were not fetched. | |
| totalEstimate | No | Approximate relevant-result count reported by Kagi. | |
| relatedQueries | Yes | Related searches displayed by Kagi. | |
| pageResultCount | Yes | Number of recognized organic result cards on this Kagi lightweight page before applying limit. |