Skip to main content

​
Google Search Console

Google Search Console provides search analytics data: top queries with clicks, impressions, CTR, and average position, plus date-based trend data.

​
What it powers

  • SEO Performance widget — Top queries table with all metrics
  • SEO expanded view — Click/impression trend charts and summary KPIs

​
Getting your credentials

Google Search Console uses OAuth2 with a refresh token. This requires a one-time setup with a Google Cloud project.
1

Create a Google Cloud project

Go to console.cloud.google.com. Create a new project (or use an existing one).
2

Enable the Search Console API

In the API Library, search for Google Search Console API and enable it.
3

Create OAuth2 credentials

Go to APIs & Services > Credentials > Create Credentials > OAuth 2.0 Client ID.Select Web application as the application type. Add the exact callback URL Radarboard shows in the integration UI.For the default local portless setup, that callback is:
https://localhost:1355/api/auth/google/callback
Note the Client ID and Client Secret.
4

Get a refresh token

Use the OAuth2 Playground or a script to authorize with the scope https://www.googleapis.com/auth/webmasters.readonly and obtain a refresh token.
You can use Google’s OAuth2 Playground — set your own OAuth credentials in the settings gear, authorize the Search Console scope, and exchange for a refresh token.

​
Environment variables

.env.local
GOOGLE_CLIENT_ID=xxxxxxxxxxxx.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=GOCSPX-xxxxxxxxxxxx
GOOGLE_REFRESH_TOKEN=1//xxxxxxxxxxxx

​
API details

PropertyValue
API base URLhttps://searchconsole.googleapis.com/webmasters/v3
Rate limitStandard Google API quotas
Cache TTL5 minutes
AuthenticationOAuth2 with refresh token

​
Widgets that use this service

SEO Performance

Primary data source for all search analytics.