---
title: "Sync"
description: "Sync and backfill Google Search Console data with gscdump."
canonical_url: "https://gscdump.com/gscdump-cli/api/sync"
last_updated: "2026-10-03T07:15:31.797Z"
---

# Sync

::pre{tabindex="0"}
```bash
# Default: catch every table and search type up to the latest final date.
# A table with no history starts 28 days back. Newest dates come first.
# Also saves sitemaps and inspects up to 50 due URLs. Skips completed dates.
gscdump sync --site example.com

# Backfill the 16 months Google keeps, plus 14 days Google often still serves
gscdump sync --site example.com --full

# Cap one run at 2,000 Search Analytics calls; the next run continues
gscdump sync --site example.com --full --max-calls 2000

# Every verified Site, one after another
gscdump sync --all-sites

# Custom range
gscdump sync --site example.com --start 2026-08-01 --end 2026-08-31 \
  --tables pages,queries,page_queries,countries,dates

# Coverage, missing and failed dates per table, and a running sync
gscdump sync --site example.com --status

# Limit concurrent day requests per table
gscdump sync --site example.com --concurrency 4 \
  --tables pages,queries,page_queries,countries,dates
```
::

Sync skips completed dates; `--force` refreshes them.
A day Google still updates stays `pending`, and the next sync fetches it again.
Sync records Google calls in a quota ledger in the Store directory.
If Google refuses a call for quota, sync stops, keeps the rest `pending`, and exits 0. The next run continues.
Cross-process locks coordinate `sync`, `compact`, and `gc`.
Pagination follows Google's 25,000-row pages and stops at the first short page, subject to [Google's data limits](https://developers.google.com/webmaster-tools/v1/how-tos/all-your-data).

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.