# API quickstart

> Documentation index: [llms.txt](https://westkite.com/docs/llms.txt). Every page is also at its URL plus `.md`.

Make your first West Kite API call in about a minute, then hand the API to your coding agent.


## 1. Get an API key

Rather let your agent do it? Copy this prompt into Claude Code, Codex or Cursor, or skip to [step 4](#4-connect-your-agent).

```text
Sign up for West Kite and get an API key with westkite.com/auth.md, then follow westkite.com/docs/api/agent-quickstart.md to integrate it into the codebase.
```

Sign in at [app.westkite.com/developers](https://app.westkite.com/developers). Your first key, named Default, is waiting, with $10 of free credit. Connect your agent and you get $5 more.

Keep the key out of your code. Put it in an environment variable:

```sh
export WESTKITE_API_KEY="wk_live_…"
```

## 2. Find the property

Search turns an address into a property ID. It's free.

```curl
curl --get "https://api.westkite.com/v1/search" \
  -H "Authorization: Bearer $WESTKITE_API_KEY" \
  --data-urlencode "q=550 Madison Ave, New York"
```

```typescript
const res = await fetch(
  "https://api.westkite.com/v1/search?" + new URLSearchParams({ q: "550 Madison Ave, New York" }),
  { headers: { Authorization: `Bearer ${process.env.WESTKITE_API_KEY}` } },
);
const { data } = await res.json();
```

```python
import os, requests

res = requests.get(
    "https://api.westkite.com/v1/search",
    params={"q": "550 Madison Ave, New York"},
    headers={"Authorization": f"Bearer {os.environ['WESTKITE_API_KEY']}"},
)
data = res.json()["data"]
```

```json 200
{
  "data": {
    "results": [
      { "id": "property:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0", "title": "550 Madison Avenue · Manhattan · APN 6201001012910010" }
    ]
  },
  "missing": [],
  "billing": { "operation_id": "op_1a4c…", "operation": "search", "charged_usd": 0, "balance_usd": 10 },
  "request_id": "req_6e0b…"
}
```

## 3. Read its record

Pass the ID to [properties](https://westkite.com/docs/api/properties.md) with the parts you want. A record costs $0.01, whatever parts you ask for.

```curl
curl "https://api.westkite.com/v1/properties/property:08cdd01c-64d6-8ed2-b7b8-8158ccadf8a0?parts=owner,sales" \
  -H "Authorization: Bearer $WESTKITE_API_KEY"
```

The owner of record, its sales and their sources come back in `data`. Anything the county doesn't publish is listed in `missing` with a reason.

## 4. Connect your agent

Paste this into Claude Code, Codex or Cursor:

```text
Sign up for West Kite and get an API key with westkite.com/auth.md, then follow westkite.com/docs/api/agent-quickstart.md to integrate it into the codebase.
```

The agent follows the [agent quickstart](https://westkite.com/docs/api/agent-quickstart.md): it signs you up with your email, or uses the key already in `WESTKITE_API_KEY`, then sets West Kite up in your project. To install the skill yourself in Claude Code:

```sh
mkdir -p ~/.claude/skills/west-kite-api && curl -fsSL https://westkite.com/skills/west-kite-api/SKILL.md -o ~/.claude/skills/west-kite-api/SKILL.md
```

See [Agents](https://westkite.com/docs/api/agents.md#install-the-skill) for Codex, Cursor and other agents.

## Next steps

- Screen a market with [find](https://westkite.com/docs/api/find.md).
- Trace an LLC with [owner research](https://westkite.com/docs/api/research.md).
- Set a monthly spend cap on the key in [API keys](https://westkite.com/docs/api/authentication.md#spend-caps).
