/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:
keyless: True (true in TypeScript, Go and Rust), then one line per result:
Example output · results vary
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 theusage 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
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 athttps://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
- Search without a key and Fetch without a key.
- 400 Missing app identifier and 429 Rate limit exceeded.
- Authentication: add an API key when you outgrow the keyless tier.