Overview

Connect Google Search Console to see how your schema quality correlates with actual search performance. Import rich results data, track impression/click trends, and identify which schema improvements drive the most search visibility.

How It Works

1. Authorize ValidGraph to access Google Search Console
2. Select which sites to connect
3. ValidGraph imports:
– Rich results status per URL
– Impressions and clicks for rich results
– Performance trends
4. Data is correlated with validation scores
5. Dashboard shows search impact of schema changes

Tier Availability

| Tier | Available |
|——|———–|
| Free | No |
| Pro | No |
| Agency | Yes |
| Enterprise | Yes |

Related Features

– Rich Snippet Eligibility: ValidGraph’s eligibility prediction vs GSC’s actual data
– Trends & Temporal Data: Combined validation + search performance trends
– Site-Wide Score: Enriched with real search performance data

Mini-Tutorial

Step 1: Connect Google Search Console

Navigate to Integrations > Google Search Console and click “Connect.” You’ll be taken through Google’s OAuth flow.

Step 2: Select Properties

After authorizing, choose which GSC properties to connect. You can add multiple properties to one ValidGraph project.

Step 3: Import Data

Click “Sync Now” to pull the latest rich results data and performance metrics (clicks, impressions, CTR, average position).

Step 4: View Correlation

Go to Analytics > GSC Performance to see how your schema quality (from ValidGraph validations) correlates with actual search performance.

Step 5: Analyze Opportunities

The dashboard highlights pages with high impressions but low clicks—often a sign that schema improvements could increase CTR.

Technical Details

Initial Connection

POST /api/v1/gsc/connect
{
  "gsc_oauth_tokens": {
    "access_token": "ya29.a0...",
    "refresh_token": "1//0gK...",
    "expiry": "2025-03-22T20:00:00Z"
  }
}

Get Performance Data

GET /api/v1/gsc/performance?period=28d&project_id=abc123

Response example:

{
  "period": "28d",
  "properties": [
    {
      "property": "https://example.com/",
      "queries": 1250,
      "clicks": 340,
      "impressions": 8420,
      "ctr": 0.0403,
      "avg_position": 3.8
    }
  ],
  "rich_results_data": [
    {
      "url": "https://example.com/products/widget",
      "rich_result_type": "Product",
      "impressions": 120,
      "clicks": 45,
      "ctr": 0.375,
      "avg_position": 2.1
    }
  ],
  "schema_quality_correlation": {
    "high_quality_avg_ctr": 0.048,
    "low_quality_avg_ctr": 0.018,
    "improvement_potential": "~167% higher CTR with improved schema"
  }
}

Get Rich Results Status

GET /api/v1/gsc/rich-results?project_id=abc123

Returns rich results eligibility status per URL type (Article, Product, FAQPage, etc.).

References

– Google Search Console API Documentation
– Google Rich Results Test Tool
– GSC Rich Results Report
– Search Performance Optimization Guide