Google Search Console
Google Search Console is the primary data source for SEO Dash. It provides search performance data including clicks, impressions, click-through rate, and average position for your queries and pages.
Setting Up OAuth
- Go to the Google Cloud Console
- Create a new project (or select an existing one)
- Enable these APIs:
- Google Analytics Data API (optional)
- Go to Credentials and create an OAuth 2.0 Client ID (Web application type)
- Add
https://your-domain.com/api/auth/google/callbackas an authorized redirect URI - Enter the Client ID and Secret in Settings > Search Engines
- Click "Connect Google" and authorize
Available Data
Once connected, SEO Dash pulls three types of data:
- Queries - Your top search queries with clicks, impressions, CTR, and average position. Available on the Top Queries page and used by the Gap Zone Analyzer, Low-Hanging Fruit, and Rising Queries features.
- Pages - Your top pages with the same metrics. Used by the Top Pages view and Content Gap analysis.
- Date Trends - Daily aggregated performance data used for the charts on the Overview page.
Data Delay
Google Search Console data is typically delayed by 2-3 days. The most recent complete data is usually from 2-3 days ago. The AI agent is aware of this and automatically adjusts date ranges when you ask for "recent" or "today's" data.
Caching
Search Console data is cached for 6 hours to avoid hitting API limits. The dashboard shows a "cached" indicator when serving cached data. To force fresh data, click the refresh button or ask the AI agent to clear the cache.
Site URL Formats
SEO Dash automatically tries multiple URL formats when querying Search Console:
sc-domain:example.com(domain property)https://example.com/https://www.example.com/http://example.com/
This means it works regardless of how your property is registered in Search Console.