> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corsair.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Keenable API reference

> API reference for the Keenable plugin in Corsair: every `keenable.api.*` operation with its input and output types, taken from the plugin's Zod schemas.

> [!NOTE]
>
> **New to Corsair?** See [API access](https://docs.corsair.dev/concepts/api.md), [authentication](https://docs.corsair.dev/concepts/auth.md), and [error handling](https://docs.corsair.dev/concepts/error-handling).

## Fetch

### get

`fetch.get`

Fetch a page as markdown by URL, optionally extracting with a prompt

**Risk:** `read`

```ts theme={null}
await corsair.keenable.api.fetch.get({ url: 'https://example.com', max_chars: 20000 });
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `url` | `string` | Yes | — |
| `max_chars` | `number` | No | — |
| `live` | `boolean` | No | — |
| `prompt` | `string` | No | — |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `url` | `string` | Yes | — |
| `title` | `string` | No | — |
| `description` | `string` | No | — |
| `author` | `string` | No | — |
| `published_at` | `string \| number` | No | — |
| `content` | `string` | Yes | — |

***

## Search

### post

`search.post`

Search the web and return ranked results (realtime or pro mode)

**Risk:** `read`

```ts theme={null}
await corsair.keenable.api.search.post({ query: 'typescript best practices', max_results: 5, published_after: '30d' });
```

**Input**

| Name | Type | Required | Description |
| - | - | - | - |
| `query` | `string` | Yes | — |
| `mode` | `realtime \| pro` | No | — |
| `site` | `string` | No | — |
| `acquired_after` | `string` | No | — |
| `acquired_before` | `string` | No | — |
| `published_after` | `string` | No | — |
| `published_before` | `string` | No | — |
| `query_time` | `string` | No | — |
| `snippet_max_length` | `number` | No | — |
| `max_results` | `number` | No | — |

**Output**

| Name | Type | Required | Description |
| - | - | - | - |
| `query` | `string` | Yes | — |
| `mode` | `string` | Yes | — |
| `results` | `object[]` | Yes | — |

> [accordion] results full type
>
> ```ts theme={null}
> {
>   title: string,
>   url: string,
>   description?: string,
>   snippet?: string,
>   published_at?: string,
>   acquired_at?: string
> }[]
> ```

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.