---
name: orthogonal-keenable
description: "Call Keenable through Orthogonal's pay-per-use Run API: Independent web search for AI agents on Keenable's own crawler and index: ranked web results with extracted text and site, date and domain filters, plus page fetch as clean markdown, from the index or live from the source."
---

# Keenable — Orthogonal API

> Pay-per-use API on Orthogonal. Each call is billed to your Orthogonal balance.
> Base API: `https://api.orthogonal.com/v1/run` · [llms.txt](https://www.orthogonal.com/llms.txt) · [browse all APIs](https://www.orthogonal.com/catalog)

Independent web search for AI agents on Keenable's own crawler and index: ranked web results with extracted text and site, date and domain filters, plus page fetch as clean markdown, from the index or live from the source.

**Verified:** no

## Access

**Run API:** `POST https://api.orthogonal.com/v1/run`
**Auth:** `Authorization: Bearer $ORTHOGONAL_API_KEY`
Get an API key at https://www.orthogonal.com/account/keys

No account or key yet? Set up Orthogonal first with https://www.orthogonal.com/skill.md: it covers the CLI, the MCP server, the TypeScript SDK and sign-up, including an agent sign-up without a password (https://www.orthogonal.com/agent-signup.md).

Every call goes through the unified Run API: send the API `slug`, the endpoint `path`, and the `query`/`body` parameters. The response is `{ "success": true, "priceCents": <US cents>, "requestId": "...", "data": { ... } }`.

Quote first, free: the same request with `"dryRun": true` returns the price without calling the API or charging anything. On a retry after a timeout, send the same `Idempotency-Key` header so the call runs and bills once.

## Endpoints

### Web search

Search (POST /v1/search): ranked web results from Keenable's own index with titles, URLs, extracted-text snippets and publish/index dates, with site, excluded-domain, date and point-in-time filters, pro or realtime mode and optional safe search.

`POST /v1/search`

**Estimated cost:** $0.00436

**Page:** https://www.orthogonal.com/api/keenable/53b298c0-233c-4bf1-9018-e379c08fbdff

**Docs:** https://docs.keenable.ai/api-reference/search

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | What to search for, in plain language; supports operators: "exact phrase", site:, OR, -term. |
| `mode` | string | No | How hard to search: pro (deeper retrieval, best ranking) or realtime (fastest). |
| `site` | string | No | Return results from one site only (subdomains included; a path narrows further). |
| `exclude_domains` | array | No | Never return results from these hosts (and their subdomains). Up to 1,000 distinct hosts. |
| `published_after` | string | No | Keep pages published at or after this point: date YYYY-MM-DD, ISO 8601 timestamp, or relative delta such as 7d. |
| `published_before` | string | No | Keep pages published at or before this point. Same formats as published_after. |
| `acquired_after` | string | No | Keep pages Keenable indexed at or after this point. Same formats as published_after. |
| `acquired_before` | string | No | Keep pages Keenable indexed at or before this point. Same formats as published_after. |
| `query_time` | string | No | Search the index as it stood at this moment (timestamp, date, Unix epoch string or relative delta). |
| `max_results` | integer | No | How many results to return, 1 to 50. |
| `snippet_max_length` | integer | No | Cap on characters of page text in each snippet, 180 to 10000. |
| `disable_cards` | boolean | No | Set true to leave Keenable-written cards out of the results. |
| `safety_mode` | string | No | Safe search: off, moderate or strict. |
| `session_id` | string | No | Your own ID for grouping related requests, up to 128 characters. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"keenable","path":"/v1/search","body":{"query":"<string>","mode":"<string>","site":"<string>","exclude_domains":"<array>","published_after":"<string>","published_before":"<string>","acquired_after":"<string>","acquired_before":"<string>","query_time":"<string>","max_results":"<integer>","snippet_max_length":"<integer>","disable_cards":"<boolean>","safety_mode":"<string>","session_id":"<string>"}}'
```

### Web search (query string)

Search (GET /v1/search): the same ranked web search with the parameters in the query string; exclude_domains can be repeated or comma-separated.

`GET /v1/search`

**Estimated cost:** $0.00436

**Page:** https://www.orthogonal.com/api/keenable/d03befa5-b51a-4eb4-a70b-17d5d8586b1e

**Docs:** https://docs.keenable.ai/api-reference/search

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | What to search for, in plain language; supports operators: "exact phrase", site:, OR, -term. |
| `mode` | string | No | How hard to search: pro (deeper retrieval, best ranking) or realtime (fastest). |
| `site` | string | No | Return results from one site only (subdomains included; a path narrows further). |
| `exclude_domains` | string | No | Never return results from these hosts (and their subdomains). Up to 1,000 distinct hosts. Repeat the parameter or separate entries with commas. |
| `published_after` | string | No | Keep pages published at or after this point: date YYYY-MM-DD, ISO 8601 timestamp, or relative delta such as 7d. |
| `published_before` | string | No | Keep pages published at or before this point. Same formats as published_after. |
| `acquired_after` | string | No | Keep pages Keenable indexed at or after this point. Same formats as published_after. |
| `acquired_before` | string | No | Keep pages Keenable indexed at or before this point. Same formats as published_after. |
| `query_time` | string | No | Search the index as it stood at this moment (timestamp, date, Unix epoch string or relative delta). |
| `max_results` | integer | No | How many results to return, 1 to 50. |
| `snippet_max_length` | integer | No | Cap on characters of page text in each snippet, 180 to 10000. |
| `disable_cards` | boolean | No | Set true to leave Keenable-written cards out of the results. |
| `safety_mode` | string | No | Safe search: off, moderate or strict. |
| `session_id` | string | No | Your own ID for grouping related requests, up to 128 characters. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"keenable","path":"/v1/search","method":"GET","query":{"query":"<string>","mode":"<string>","site":"<string>","exclude_domains":"<string>","published_after":"<string>","published_before":"<string>","acquired_after":"<string>","acquired_before":"<string>","query_time":"<string>","max_results":"<integer>","snippet_max_length":"<integer>","disable_cards":"<boolean>","safety_mode":"<string>","session_id":"<string>"}}'
```

### Page fetch

Fetch (GET /v1/fetch): a web page's main text as clean markdown with title, author and publish date, from Keenable's index or live from the source, or only the part a prompt asks for.

`GET /v1/fetch`

**Estimated cost:** $0.00436

**Page:** https://www.orthogonal.com/api/keenable/df8c3e89-c296-45cf-af9c-cec0ce4605fe

**Docs:** https://docs.keenable.ai/api-reference/fetch

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | The page to read, as an absolute http or https URL. |
| `max_chars` | integer | No | Hard cap on the characters of content. |
| `live` | boolean | No | Fetch the page from the source now instead of Keenable's indexed copy. |
| `prompt` | string | No | Instruction for extracting part of the page, at most 2000 characters; content then holds only the answer. |
| `session_id` | string | No | Your own ID for grouping related requests, up to 128 characters. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"keenable","path":"/v1/fetch","method":"GET","query":{"url":"<string>","max_chars":"<integer>","live":"<boolean>","prompt":"<string>","session_id":"<string>"}}'
```

---

Full details and an interactive quickstart: https://www.orthogonal.com/publisher/keenable
