Skip to main content
Let your agent search and fetch the web before anyone creates an account. Call the /public paths and name your app in the X-Keenable-Title header. Keyless calls are free, and Keenable limits them per IP address: 1,000 requests per hour and 10 per second, for each endpoint.

Parameters

The public paths take the same body and query parameters as the keyed ones, plus your app’s name: GET /v1/fetch/public takes the same headers and the keenable_title query parameter.

Keyless paths

Search without a key

This sample creates a client with no API key and your app’s name, confirms it runs keyless, and prints the top 3 results. With no key, each SDK calls the /public paths and sends its client source as X-Keenable-Title:
You see keyless: True (true in TypeScript, Go and Rust), then one line per result:
Example output · results vary
If KEENABLE_API_KEY is set in the environment, the SDKs use it and call the keyed paths instead. If you leave the client source out, the SDKs send Keenable SDK.

Read the response and the limit headers

A keyless response has the same shape as a keyed one, without the usage object. Each response also carries the hourly limit for your IP address. This is the curl request with max_results set to 1 and snippet_max_length to 180:
Response · results vary
If you leave out X-Keenable-Title, the API returns 400:
Response

Keyless limits

You share the per-IP pool with all other traffic from your IP address, such as other people behind the same office network. Over a limit, the API returns 429 with Retry-After, and the body’s code is public_rate_limit_per_second or public_rate_limit_hourly. An hourly 429 keeps coming back until the time in limit.resets_at. See Rate limits. An API key replaces the per-IP limit with your organization’s own limit, 10 requests per second with no hourly cap, and adds the usage object to each response. Monitors needs a key.

Keyless MCP

Point an MCP client at https://api.keenable.ai/mcp with no key and it runs on the keyless tier. If you ship Keenable in a preset, a catalog entry or a docs example, use https://api.keenable.ai/mcp-public instead. It is the same server with the same tools, but it publishes no OAuth discovery metadata, so clients connect without offering a sign-in. On /mcp-public, search_web_pages doesn’t offer mode. See Keyless endpoint for listings and presets.

Common mistakes

API reference