Skip to main content
bisibility is a self-hostable rank tracker with bring-your-own SERP providers and a REST API under /api/v1. Start with the app workflow, then use the API when you want automation or generated client code.

Quickstart

Start the stack, create a project, connect a provider, and run the first check.

Self-hosting

Docker, required services, environment variables, workers, and migrations.

Integrations

Connect DataForSEO or SerpAPI and configure fallback, estimates, and caps.

Authentication

API-key format, scopes, rate limits, and idempotency.

Audit log

Entry shape, retention, and action strings emitted by the app.

API reference

Request and response shapes for the real /api/v1 endpoints.

AI agents

REST API, OpenAPI, capabilities, and machine-readable API docs.

Product guides

Alerts, competitors, teams, saved views, analytics, migration, and operations.

Base URLs

Use the hosted API root:
For a self-hosted instance, use your own app origin with the same path:
Browser code running inside the app can use a relative base URL:

What is documented

The API reference documents routes handled by app/api/v1/[[...path]], app/api/cloud/import, app/api/v1/cloud/import, and lib/api/*. OpenAPI is generated from lib/api/openapi.ts, so the cloud-import endpoint is documented manually until it is included in that document.