Check bisibility API health and configured SERP providers.

List the public bisibility API capabilities exposed for agent workflows.

Check whether a cloud export package can be imported: returns the running app version, the latest applied migration, and the cloud-import schema versions the API accepts. Anonymous preflight endpoint; no project scope or credential needed. Use before preparing a migration to confirm the export schema is still supported.

List public provider rate cards used for rank-check cost estimates. Each rate card is either flat-priced (per-check options such as standard, priority, live) or plan-priced (monthly plans with included checks). Anonymous endpoint; no project scope needed.

Estimate the monthly rank-check cost for a keyword portfolio using the public provider rate cards. Provide the keyword count plus optional devices per keyword (1-2), locations per keyword, and check frequency (daily, weekly, or monthly). Pick a rate card with provider (defaults to dataforseo) and optionally a flat-rate option key or a plan key; see get_provider_rates for available keys. Anonymous endpoint.

Get the authenticated user and all project memberships. Requires a personal access token.

Update the authenticated user's display name. Requires a write PAT.

List projects visible to the configured credential. Project keys return one project; personal access tokens return all project memberships.

Create a project. Requires a personal access token with write scope.

Get one bisibility project by project id.

Search canonical keyword locations. Use the returned location_key verbatim when creating or updating keywords for city-level tracking.

Update a project's name or domain. At least one of name or domain is required.

Permanently delete a project and all of its keywords, rank history, and settings. This cannot be undone. Use only after the user confirms deletion.

Get the effective rank-check schedule and SERP market defaults for a project. The response includes serp_depth, serp_stop_on_match, and source: explicit means the market was configured, derived means it was inferred from existing keywords, and fallback means the instance default was used.

Update the project default rank-check schedule and SERP market. The schedule is replaced as a whole: omitted schedule fields reset to their defaults (jitter 60, timezone UTC, no cron). Provide country and device together, or a location_key, to move the default SERP market. Use search_locations and pass its location_key verbatim for city-level tracking.

List keywords for a project with pagination, search, filters, and sorting.

Paid provider lookup on the project's own DataForSEO account, about $0.02 per 100-keyword page on a cache miss. Results are cached for 12 hours and shared with the UI and API. already_tracked marks keywords the project tracks.

Requires API write scope. Paid keyword research uses the project's own DataForSEO account. When cost matters, call with estimate_only first for a free dry run, then use max_cost_cents as a best-effort request guard. Approximate per-source pricing comes from the current rate card exposed by get_provider_rates. Send one seed per call. Results are cached for 12 hours and shared with the API and future UI. Clickstream-refined volumes double provider cost. already_tracked marks keywords the project tracks.

Requires API write scope because cache misses spend the project's own DataForSEO budget. Returns summary metrics, 12-month history, and per-link rows with new or lost status. Snapshots are cached for 24 hours. Call with estimate_only first for a free dry run, then use max_cost_cents as a best-effort request guard. Compute aggregate views from rows and treat them as "within fetched rows" only.

Requires API write scope. Extends the current unexpired backlinks snapshot at the per-100-row provider rate. Returns 409 snapshot_expired when no current snapshot exists; run analyze_backlinks first.

Requires API write scope. Paid metrics lookup uses the project's own DataForSEO account. When cost matters, call with estimate_only first for a free dry run, then use max_cost_cents as a best-effort request guard. Approximate pricing per 100 fetched keywords comes from the current rate card exposed by get_provider_rates. Batches contain up to 700 keywords and cache each keyword for 12 hours, shared with the API and future UI. Clickstream-refined volumes double provider cost.

Add one or more keywords to a project, optionally with tags, target URL, and schedule. Use search_locations and pass its location_key verbatim for city-level tracking.

Get a keyword and its latest rank position by keyword id.

Update keyword metadata such as text, country, device, target URL, tags, or schedule. Use search_locations and pass its location_key verbatim for city-level tracking.

Set or clear the target URL used when evaluating a keyword ranking.

Delete one keyword by keyword id. Use only after the user confirms deletion.

Bulk mutate keywords by adding tags, removing tags, setting frequency, setting target URL, or deleting.

Run a provider-backed rank check for one keyword. Requires write access and may incur provider cost. Ask for explicit user approval immediately before calling; this server cannot enforce the client's confirmation UI. By default the check runs synchronously and returns the completed result. Set async to true to enqueue the check and return a running rank check immediately; poll it with get_rank_check_result.

List historical rank checks for a keyword with date, status, and pagination filters.

Export project rank history as cursor-paginated JSON for reports and analysis. For full streamed CSV dumps, use the REST endpoint directly.

List the project sitemap monitor, including its status and latest snapshot summary.

Enable the project sitemap monitor. The next scheduled worker sync fetches the sitemap; enabling does not fetch immediately.

Disable the project sitemap monitor while retaining its existing snapshots.

Get one rank check result by check id.

Ingest a signal for the key-scoped project: an external event such as a deploy, CMS content change, or custom API event that may explain ranking movements. source must be deploy, cms, or api; type is a dot-separated identifier such as "deploy.completed" or "cms.page_updated". Optionally attach an ISO-8601 happened_at (defaults to now), a related keyword_id, an http(s) url, a severity (info, warning, or critical), and a JSON payload of up to 8KB.

List signals for a project, newest first. Filter by source (including system sources such as rank_tracker or search_analytics), exact type, and a happened-at date range via from/to ISO-8601 date-times, with cursor pagination.

List stored page traffic snapshots collected from the project's own connected analytics accounts, filtered by date range and optional page paths.

Fetch live query statistics from one of the project's own connected search-performance accounts. Provider rate limits and reauthorization rules apply.

Synchronize traffic snapshots from the project's own connected analytics accounts now. Provider rate limits and connection authorization rules apply.

List API keys for the authenticated project, including revoked keys.

Create a new API key for the authenticated project. The raw token is returned once in the response and cannot be retrieved again; store it securely.

Revoke an API key by key id. Revocation is immediate and cannot be undone; revoking the key this server is configured with locks the server out. Use only after the user confirms revocation.

List API keys scoped to a specific project, including revoked keys.

Create a project-scoped API key for CI or automation. The raw key is returned once.

List the user's personal access tokens. Requires an admin PAT.

Create a personal access token. The raw account-wide token is returned once. Requires an admin PAT.

Revoke a personal token by id, or pass "current" to revoke the configured token.

Webhook endpoints: list the per-project HTTP URLs that notifications and events are delivered to.

Create a webhook endpoint. The HMAC secret is write-only.

Update a webhook endpoint or rotate its write-only HMAC secret.

Delete a webhook endpoint. Requires admin access.

Alert rules: list the per-project conditions that decide when a notification fires.

Create an alert rule for project rank changes, thresholds, SERP features, or competitors.

Update an alert rule by rule id. The API replaces the whole rule configuration, so name and condition_type are required even when updating a single field.

Delete an alert rule by rule id. Use only after the user confirms deletion.

List triggered alerts for a project.

Mute one firing alert for 24 hours. This changes shared alert state for the whole project team.

Mark every firing alert in the project as read for the whole project team.

List team members for a project.

List pending team invites for a project.

Invite a user to a project team with an admin, member, or viewer role.

Revoke a pending project team invite.

Resend a pending team invitation and replace its expiration and token.

Change a non-owner project member role to admin, member, or viewer. Ownership transfer remains UI-only.

Permanently remove a non-owner project member. Confirm the user's intent before calling this tool.

List provider connection options and status for a project.

Connect or update credentials for a project provider. SERP providers are dataforseo and serpapi; analytics providers are ga4, gsc, and plausible. Self-hosted providers such as Plausible accept an optional credentials.endpoint base URL.

Test provider credentials or the saved provider connection. Self-hosted providers such as Plausible accept an optional credentials.endpoint base URL.

Update provider settings such as enabled state, priority, or primary status.

Enable or disable a provider for a project.

Set provider priority for a project. Lower numbers are preferred first.

Set or clear a provider as the primary project provider.

Disconnect a provider from a project. Use only after the user confirms deletion.

List keyword ideas saved without rank tracking for a project.

Save keyword ideas without starting paid rank tracking. Keywords already tracked or saved are skipped.

Delete one saved keyword. Use only after the user confirms deletion.

List saved keyword views for a project.

Create a saved keyword view for a project. Known country filter values: 'all' or a supported market country code such as us, gb, ca, au, de, fr, es, it, nl, se, pl. Known serp filter values: ai, featured, image, paa, sitelinks, video. The API validates both against its data-driven market list.

Delete a project saved view. Use only after the user confirms deletion.

List tracked competitors, market data, and suggestions for a project.

Add a tracked competitor domain to a project.

Remove a tracked competitor from a project.

Notification channel switches: get which channels (email, Slack, webhook) are turned on for the project. Returns no addresses or URLs; use list_webhooks for where notifications are sent.

Notification channel switches: turn the project's notification channels (email, Slack, webhook) on or off. Does not create or change webhook endpoints; use create_webhook or update_webhook for those.

List active migration tokens for a project.

Mint a migration token for a project.

Revoke a project migration token.