# The Known Good API

Home > API

One endpoint, no key required to start.

## Search

```
GET https://knowngood.sh/api/find?q=buy%20perfume&country=SA&limit=3
```

## Parameters

- `q` (string, required) — The query. Natural language works; so do keywords. Truncated at 300 characters.
- `country` (ISO 3166-1 alpha-2) — Upper-cased for you. GB, SA, DE.
- `entity_type` (string) — The kind of site, as graded. See /type/ for the values in use.
- `transactional` (true | false) — Whether the site exposes something an agent can act on.
- `has_mcp` (true) — Only sites whose own MCP server answered tools/list.
- `has_md` (true) — Only sites that negotiate markdown or ship a markdown twin.
- `has_endpoint` (true) — Only sites with a working MCP server or an API catalogue.
- `limit` (1–25, default 10) — How many results to return.

## Rate limits

- keyless: 500 requests per UTC day
- with a key: 10000 requests per UTC day
- registration: 3 keys per caller per day

## Getting a key

POST https://knowngood.sh/agent/auth then send `Authorization: Bearer <credential>`.
Protocol: https://knowngood.sh/auth.md

## MCP

https://knowngood.sh/mcp