Index of every page on this site: llms.txt
Skip to content

Sync

# 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. 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.