# bisibility

> Self-hostable, open-source keyword rank tracker. Bring your own SERP and analytics providers, track positions over time, and get alerts.

## Docs

- [AI agents](https://bisibility.com/docs/agents.md): Connect AI agents to bisibility through MCP or the REST API.
- [Alert rules](https://bisibility.com/docs/api/alert-rules.md): List, create, update, and delete alert rules, and read triggered alerts.
- [Analytics](https://bisibility.com/docs/api/analytics.md): Read stored traffic snapshots, query live search performance, and synchronize analytics.
- [API keys](https://bisibility.com/docs/api/api-keys.md): List, create, and revoke API keys through the REST API.
- [Checks](https://bisibility.com/docs/api/checks.md): Run an immediate rank check for one keyword.
- [Cloud import](https://bisibility.com/docs/api/cloud-import.md): Import keywords and rank history with a migration token.
- [Competitors](https://bisibility.com/docs/api/competitors.md): Manage the competitor domains tracked for a project.
- [Deploy webhooks](https://bisibility.com/docs/api/deploy-webhooks.md): Send deploy-completed events into bisibility timeline signals.
- [Discovery](https://bisibility.com/docs/api/discovery.md): Unauthenticated API discovery endpoints for health checks and agent clients.
- [API errors](https://bisibility.com/docs/api/errors.md): Problem details returned by the bisibility REST API.
- [Keyword metrics](https://bisibility.com/docs/api/keyword-metrics.md): Hydrate nullable DataForSEO Labs metrics for up to 700 keywords with per-keyword caching.
- [Keyword research](https://bisibility.com/docs/api/keyword-research.md): Research related keywords, suggestions, and ideas from one seed through DataForSEO Labs.
- [Keywords](https://bisibility.com/docs/api/keywords.md): Create, list, update, delete, and bulk mutate tracked keywords.
- [Locations](https://bisibility.com/docs/api/locations.md): Search canonical country, region, and city keys for keyword operations.
- [Notification preferences](https://bisibility.com/docs/api/notification-preferences.md): Read and update notification preferences.
- [API overview](https://bisibility.com/docs/api/overview.md): Common request and response behavior for the bisibility REST API.
- [Personal access tokens](https://bisibility.com/docs/api/personal-access-tokens.md): Authenticate as a user across projects and automate account-level operations.
- [Projects](https://bisibility.com/docs/api/projects.md): List, update, delete, and configure project defaults.
- [Provider connections](https://bisibility.com/docs/api/providers.md): Connect, test, configure, and disconnect SERP providers over the REST API.
- [Rank history](https://bisibility.com/docs/api/rank-history.md): Read historical rank-check results for charts, exports, and reports.
- [Ranked keyword suggestions](https://bisibility.com/docs/api/ranked-keyword-suggestions.md): Discover queries a project domain already ranks for through its DataForSEO account.
- [Saved views](https://bisibility.com/docs/api/saved-views.md): Manage saved keyword and competitor comparison views.
- [Signals](https://bisibility.com/docs/api/signals.md): List and ingest timeline signals.
- [Sitemap monitors](https://bisibility.com/docs/api/sitemap-monitors.md): Read sitemap snapshot status and enable or disable project monitoring.
- [Team](https://bisibility.com/docs/api/team.md): List project members and manage invitations.
- [Webhook endpoints](https://bisibility.com/docs/api/webhooks.md): Create, test, verify, update, and delete signed project webhook endpoints.
- [Architecture](https://bisibility.com/docs/architecture.md): How bisibility stores keywords, schedules rank checks, calls SERP providers, and delivers alerts.
- [Audit log](https://bisibility.com/docs/audit-log.md): Audit-log entry shape, retention, and action strings emitted by bisibility.
- [Authentication](https://bisibility.com/docs/authentication.md): Use bisibility API keys with bearer authentication.
- [Configure alerts](https://bisibility.com/docs/guides/alerts.md): Create rank-change rules with in-app, email, Slack, and signed webhook delivery.
- [Sync analytics traffic](https://bisibility.com/docs/guides/analytics.md): Connect GSC, GA4, or Plausible and add owned traffic context to rank data.
- [Choose your first keywords](https://bisibility.com/docs/guides/choose-first-keywords.md): Choose 10-20 phrases to track, link each one to the page that should rank, and decide why it matters.
- [Track competitors](https://bisibility.com/docs/guides/competitors.md): Add managed competitor domains and compare share of voice and keyword ranks.
- [Email delivery](https://bisibility.com/docs/guides/email.md): Choose and configure the transactional email provider: Resend or Amazon SES.
- [Migrate an instance](https://bisibility.com/docs/guides/migration.md): Transfer keywords and optional history between self-hosted and cloud workspaces.
- [Back up and upgrade](https://bisibility.com/docs/guides/operations.md): Protect self-hosted data, upgrade safely, verify health, and plan rollbacks.
- [Save keyword ideas](https://bisibility.com/docs/guides/saved-keywords.md): Build a free research shortlist before promoting keywords to tracking.
- [Use saved views](https://bisibility.com/docs/guides/saved-views.md): Save and restore keyword-table or competitor comparison scopes.
- [Monitor sitemap changes](https://bisibility.com/docs/guides/sitemap-monitoring.md): Track added, removed, and updated URLs from a project's XML sitemap.
- [Manage teams and roles](https://bisibility.com/docs/guides/teams.md): Invite teammates, assign roles, transfer ownership, and recover from invitation problems.
- [Documentation](https://bisibility.com/docs/index.md): Self-host bisibility, connect providers, and build against the REST API.
- [Integrations](https://bisibility.com/docs/integrations.md): Connect SERP providers and analytics sources in bisibility.
- [Quickstart](https://bisibility.com/docs/quickstart.md): Start a self-hosted bisibility workspace, connect a provider, and run your first rank check.
- [Go SDK](https://bisibility.com/docs/sdks/go.md): Install and authenticate the Go SDK, then list projects.
- [MCP server](https://bisibility.com/docs/sdks/mcp.md): Connect an MCP-compatible AI client to the Bisibility API.
- [SDKs](https://bisibility.com/docs/sdks/overview.md): Choose an official client library for the Bisibility API.
- [Python SDK](https://bisibility.com/docs/sdks/python.md): Install and authenticate the Python SDK, then list projects.
- [TypeScript SDK](https://bisibility.com/docs/sdks/typescript.md): Install and authenticate the TypeScript SDK, then list projects.
- [Self-hosting](https://bisibility.com/docs/self-hosting.md): Run bisibility with Docker, Railway, Fly.io, Vercel, or your own Node.js host.

## OpenAPI Specs

- [openapi.snapshot](https://bisibility.com/docs/openapi.snapshot.json)