---
title: "Sync"
description: "Sync and backfill Google Search Console data with gscdump."
canonical_url: "https://gscdump.com/gscdump-cli/api/sync"
---

> Index of every page on this site: [llms.txt](https://gscdump.com/llms.txt)

# 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 requests up to 25,000 rows per page and continues until Google returns an empty page, subject to [Google's data limits](https://developers.google.com/webmaster-tools/v1/how-tos/all-your-data). Short nonempty pages do not finish a date. Terminal-page requests count toward the quota ledger and `--max-calls`; if a read fails or the budget stops the run before completion, the previous stored date remains intact.

## Sitemap

See the full [sitemap](https://gscdump.com/sitemap.md) for all pages.
