> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reposeek.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API overview

> Base URL, endpoints, and response format for the Reposeek REST API.

# API overview

Base URL:

```text theme={null}
https://api.reposeek.ai
```

All API responses are JSON.

## Endpoints

| Method | Path         | Auth | Description                                                            |
| ------ | ------------ | ---- | ---------------------------------------------------------------------- |
| `GET`  | `/health`    | No   | API health check.                                                      |
| `POST` | `/v1/search` | Yes  | Search for open-source repositories matching a natural-language query. |

## Health check

```bash theme={null}
curl -sS https://api.reposeek.ai/health
```

Response:

```json theme={null}
{ "status": "ok" }
```

## Error shape

Expected API errors use this shape:

```json theme={null}
{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid API key"
  }
}
```

Branch on `error.code`, not `error.message`.