Google Search Console Integration

Automatic sitemap submission and status tracking via OAuth

SitemapHost integrates directly with Google Search Console (GSC) to automatically submit your sitemaps and track their indexing status. No manual submission required.

GSC integration requires connecting your Google account. Your credentials are stored securely with automatic token refresh.

How It Works

When you connect your Google Search Console account, SitemapHost can:

  • Auto-submit sitemaps - Sitemaps are automatically submitted to GSC when generated
  • Track submission status - View whether sitemaps are pending, submitted, or have errors
  • Monitor indexed URLs - See how many URLs from each sitemap Google has indexed
  • List GSC properties - View all your verified properties in the dashboard

Setting Up GSC Integration

Step 1: Connect your Google account

In your SitemapHost dashboard, navigate to Settings > Integrations and click "Connect Google Search Console".

You'll be redirected to Google's OAuth consent screen to authorize access.

Step 2: Select properties to manage

After connecting, you'll see a list of your verified GSC properties. Select which properties you want SitemapHost to manage sitemaps for.

Step 3: Enable auto-submission

For each domain, toggle "Auto-submit to GSC" to automatically submit sitemaps whenever they're updated.

{
  "domain": "sitemap.yoursite.com",
  "gscAutoSubmit": true,
  "gscPropertyUrl": "https://yoursite.com/"
}

GSC Status Tracking

Each sitemap shows its GSC submission status in the dashboard:

StatusMeaning
Not SubmittedSitemap hasn't been submitted to GSC yet
PendingSubmission request sent, awaiting confirmation
SubmittedSuccessfully submitted and being processed
ErrorSubmission failed -- check error details

Token Management

SitemapHost securely stores your GSC OAuth tokens with automatic refresh:

  • Access tokens are automatically refreshed before expiration
  • Refresh tokens are encrypted at rest
  • You can disconnect your Google account at any time from Settings

Tip: If auto-submission stops working, try disconnecting and reconnecting your Google account to refresh the OAuth tokens.

API Endpoints

GSC integration is managed via these API endpoints:

GET /api/gsc/properties

List all GSC properties for the connected account:

curl https://dash.sitemaphost.app/api/gsc/properties \
  -H "X-API-Key: YOUR_API_KEY"

POST /api/gsc/submit

Manually submit a sitemap to GSC:

curl -X POST https://dash.sitemaphost.app/api/gsc/submit \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "sitemapUrl": "https://sitemap.yoursite.com/sitemap.xml",
    "propertyUrl": "https://yoursite.com/"
  }'

GET /api/gsc/status/:domainId

Get GSC submission status for a domain:

curl https://dash.sitemaphost.app/api/gsc/status/domain_abc123 \
  -H "X-API-Key: YOUR_API_KEY"
{
  "success": true,
  "data": {
    "sitemapUrl": "https://sitemap.yoursite.com/sitemap.xml",
    "lastSubmitted": "2024-01-18T10:30:00Z",
    "status": "submitted",
    "indexedUrls": 1250,
    "totalUrls": 1500,
    "errors": []
  }
}

Next Steps