DocsGetting startedQuickstart

Quickstart

Get up and running with Console Viewer in under five minutes. Connect your GSC property, ingest 16 months of historical data, and start receiving insights immediately.

Heads up: You'll need to be a verified owner of the GSC property you want to connect.

1. Install the CLI

Install the Console Viewer CLI to manage workspaces from your terminal.

$ npm install -g @console-viewer/cli
$ cv login

2. Connect Google Search Console

Authorize Console Viewer to read from your GSC property. We use the official Google OAuth flow with read-only scopes.

$ cv connect gsc --property https://example.com
✓ Authorized
✓ Backfilling 16 months of data...
✓ Done in 2m 14s

3. Query your first insight

Insights are computed within 60 seconds of ingestion. Pull them via the API or check the dashboard.

$ curl https://api.console-viewer.com/v1/insights \
    -H "Authorization: Bearer $CV_TOKEN" \
    -G --data-urlencode "site=example.com"