Google Search Console
Source — Vendo imports search performance metrics and site metadata from Google Search Console for organic search analytics.
What Vendo Syncs
Performance Reports
Vendo queries the Search Console API to produce six performance report variants, each with different dimension breakdowns:
| Report | Dimensions | Use Case |
|---|---|---|
| By Date | Date | Daily trend analysis |
| By Page | Date + Page URL | Page-level performance |
| By Query | Date + Search Query | Keyword analysis |
| By Country | Date + Country | Geographic performance |
| By Device | Date + Device Type | Mobile vs desktop breakdown |
| Custom | Date + Page + Query + Country + Device | Full-detail analysis |
Metrics
Every performance report includes these metrics:
| Metric | Description |
|---|---|
| Clicks | Number of clicks from search results |
| Impressions | Number of times your pages appeared in search results |
| CTR | Click-through rate (0.0–1.0) |
| Position | Average ranking position in search results |
Metadata Streams
| Stream | Description |
|---|---|
| Sites | Verified Search Console properties and permission levels |
| Sitemaps | Submitted sitemaps with status, errors, and content details |
Authentication
Google Search Console uses OAuth 2.0.
- One-click OAuth connection flow
- Automatic token refresh on expiry
- Tokens are securely stored and managed by Vendo
Setup
- In the Vendo app, navigate to Apps and click Add App
- Select Google Search Console from the integration catalog
- Click Connect to start the OAuth flow
- Log in to Google and authorize access to your Search Console properties
- Vendo detects your verified site and begins syncing
Platform Details
| Setting | Value |
|---|---|
| Sync Method | Server-side via Google Search Console API |
| API | Google Webmasters API v3 |
| Max Rows per Query | 25,000 (automatic pagination) |
| Search Types | Web (default), configurable to include Image, Video, News, Discover |
| Data Freshness | Search Console data is typically delayed 24–48 hours |
| Rate Limit | Automatic backoff on 429/403 responses |
| Deduplication | Composite keys per report variant (e.g., site_url + date + query + search_type) |
Data Freshness
Google Search Console data has an inherent 24–48 hour delay. Vendo syncs the latest available “final” data by default, excluding incomplete/provisional results. This ensures metrics are stable and won’t change on subsequent syncs.
Verify Setup
- After connecting, check the app status shows Active
- Verify search performance data appears in your Vendo BigQuery dataset
- Compare click and impression totals against the Search Console dashboard
- Check that all report variants (by query, page, country, device) are populated
- Review Vendo job logs for sync activity and any errors
Last updated on