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

# Discovery

> Unauthenticated API discovery endpoints for health checks and agent clients.

Discovery endpoints do not require an API key. They are still rate limited by
client identity.

## Health

```http theme={null}
GET /api/v1/health
```

Response:

```json theme={null}
{
  "checked_at": "2026-06-28T10:00:00.000Z",
  "providers": {
    "analytics": ["gsc", "ga4", "plausible"],
    "serp": ["dataforseo", "serpapi"]
  },
  "rate_limits": {
    "dataforseo": { "per_minute": 1800, "window_seconds": 60 },
    "ga4": { "per_minute": 60, "window_seconds": 60 },
    "gsc": { "per_minute": 600, "window_seconds": 60 },
    "plausible": { "per_minute": 60, "window_seconds": 60 },
    "serpapi": { "per_minute": 60, "window_seconds": 60 }
  },
  "serp": {
    "default_depth": 100,
    "default_device": "desktop",
    "default_market": "United States",
    "depths": [10, 20, 50, 100],
    "devices": ["desktop", "mobile"],
    "engine": "google",
    "markets": [
      {
        "gl": "us",
        "language_code": "en",
        "language_label": "English",
        "name": "United States"
      }
    ]
  },
  "services": {
    "app": "ok",
    "database": "ok"
  },
  "status": "ok"
}
```

Status is `200` when the database check succeeds and `503` when it is degraded.

## OpenAPI

```http theme={null}
GET /api/v1/openapi.json
```

Returns an OpenAPI 3.1 document generated by `lib/api/openapi.ts`.

## Capabilities

```http theme={null}
GET /api/v1/capabilities
```

Response:

```json theme={null}
{
  "data": [
    {
      "name": "listKeywords",
      "operationId": "listKeywords",
      "description": "List project keywords",
      "input_schema": {
        "type": "object"
      }
    }
  ]
}
```

Capabilities are derived from the OpenAPI operation ids and the agent-facing
tool input schemas in `lib/api/capabilities.ts`.

## Provider rates

```http theme={null}
GET /api/v1/provider-rates
```

Returns provider pricing inputs used by the public rank-tracking cost estimator.

## Cost estimate

```http theme={null}
GET /api/v1/cost-estimate
```

Returns an anonymous cost estimate for a provider, keyword count, location count,
device count, schedule, and organic result depth. Pass `depth=10`, `20`, `50`, or
`100`; omitted depth defaults to `100`.

## llms.txt

```http theme={null}
GET /api/v1/llms.txt
```

Returns a plain-text summary with the API base URL, auth scheme, resources, and
tool names.