Keyword Ranking

Track and analyze keyword rankings from GSC performance data.

---

source

get_keyword_rankings

def get_keyword_rankings(
    session, # Active database session
    site_url:str, # GSC property URL
    keywords:list, # Keywords to look up
    range_type:str='last_7_days', # Date range type
    country:str | None=None, # ISO 3166-1 alpha-3 country code
)->list:

Get aggregated ranking metrics for keywords with period-over-period position change.

---

source

get_previous_period

def get_previous_period(
    start:str, # Start date (YYYY-MM-DD)
    end:str, # End date (YYYY-MM-DD)
)->tuple:

Return the date range immediately preceding the given range with equal duration.

---

source

get_keyword_rankings_daily

def get_keyword_rankings_daily(
    session, # Active database session
    site_url:str, # GSC property URL
    keywords:list, # Keywords to look up
    range_type:str='last_7_days', # Date range type
    days:NoneType=None, months:NoneType=None, country:str | None=None, # ISO 3166-1 alpha-3 country code
)->list:

Fetch daily ranking metrics per keyword for trend charts.

---

source

plot_keyword_rankings

def plot_keyword_rankings(
    results:list, # Output of [`get_keyword_rankings_daily`](https://abdelkareemkobo.github.io/seo_rat/keyword_ranking.html#get_keyword_rankings_daily)
)->VConcatChart:

Plot keyword position and clicks over time as a two-panel chart.