All tools
sync-keyword-rankingsstarterSync & Orchestration

Sync Keyword Rankings Tool

Sync keyword rankings for a tracked site. Without dates → today's rank check (one call per site). With `date_from`/`date_to` → historical fill via `historical_serps/live`, per-keyword fan-out, monthly resolution, 12-month DFS ceiling. Records null-rank rows when the site is absent from a month's SERP. Cost scales with active keyword count — surfaced in the response.

Parameters

NameTypeRequiredDescription
site_idintegerrequiredThe site ID.
date_fromstringoptionalOptional historical-fill start date (YYYY-MM-DD). Lookback ceiling is 12 months. Triggers historical mode.
date_tostringoptionalOptional historical-fill end date (YYYY-MM-DD). Defaults to today.

Plan access

Available on the starter tier and above. Live tools draw from your team's monthly credit budget at parity with upstream API cost (1 credit ≈ $0.001).

See plans