OptiviseSEO Logo OptiviseSEO Free SEO Audit Tool

Google Search Console Integration for OptiviseSEO

Enhance Your SEO Analysis with Real Performance Data

Connect your Google Search Console account to access valuable performance metrics including organic impressions, click-through rates, indexed pages count, and which keywords are generating clicks for your site.

Benefits of Google Search Console Integration

Real Performance Data

See exactly how your site performs in Google search with actual impression and click data.

Keyword Intelligence

Discover which keywords are actually driving traffic to your site.

Google Search Console Integration

OptiviseSEO uses a Google Cloud Service Account to securely access Google Search Console data.

Step 1: Initial Setup (One-Time Configuration)

Good news! Our service account [email protected] is already set up and ready to use. You can skip to Step 2.

These instructions are only for those who need to set up a new instance of OptiviseSEO

  1. Create a Google Cloud Project
  2. Enable the Search Console API
    • In your project, go to "APIs & Services" → "Library"
    • Search for "Search Console API" and enable it
  3. Create a Service Account
    • Go to "IAM & Admin" → "Service Accounts"
    • Click "CREATE SERVICE ACCOUNT"
    • Enter a name and description
    • Grant the service account Project → Viewer role (minimum)
    • Complete the setup
  4. Create and Download Service Account Key
    • On the Service Accounts page, click on your newly created account
    • Go to the "KEYS" tab and create a new JSON key
    • Save as gsc-service-account.json in your OptiviseSEO root directory
  5. Set Environment Variables
    • GSC_CREDENTIALS_PATH=/path/to/gsc-service-account.json
    • GSC_ENABLED=true
  6. Check Project Permissions
    • In Google Cloud Console, go to "IAM & Admin" → "IAM"
    • Verify the service account has "Viewer" role on the project
    • This role is sufficient for accessing Search Console data via the API
    • Note that this project permission is different from the Search Console permission
    • In Search Console you need "Full" permissions, but in Google Cloud Project "Viewer" is enough

Step 2: Connect Your Domain

  1. Ensure your domain is verified in Google Search Console

    If not already verified, go to Search Console → Add Property → follow verification instructions

  2. Add OptiviseSEO service account to your domain:
    • In Search Console, select your domain property
    • Click "Settings" (gear icon) → "Users and permissions"
    • Click "ADD USER"
    • Enter the service account email: [email protected]
    • Set permission level to "Owner" or "Full"
    • Click "ADD"
    Important: It may take a few minutes for permissions to take effect
  3. Enter your domain when running reports:
    • Simply enter your domain name in any format: example.co.uk, www.example.co.uk, or https://www.example.co.uk/
    • Our system automatically formats it correctly for Google Search Console
Ready! Once you've completed these steps, you can use the form below to retrieve your site's performance data.

Check Your Site's Performance

Enter your full domain URL. The system will convert it to the required format.