Rank Tracking

Domain position trend

Changed on

Average SERP position over time for the brand and competing domains across tracked keywords, with optional period comparison.

get/v3/rank-tracking/domain-position-trend

Request

  • Base URL: https://api.snowseo.com
  • URL: https://api.snowseo.com/v3/rank-tracking/domain-position-trend
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Query parameters

teamIdstring

Team ID

startDatestring

Start date (YYYY-MM-DD, UTC). Preferred over days; explicit ranges over 365 days are clamped. Omit with endDate set for All Time: tracked data starts at the first stored reading, Search Console at its oldest kept day (about 16 months). The whole-window comparison is absent for All Time; per-bucket movement in distribution-trend is still returned.

endDatestring

End date (YYYY-MM-DD, UTC). Preferred over days.

daysinteger

Number of days to look back (legacy fallback)

compareStartDatestring

Comparison period start (YYYY-MM-DD)

compareEndDatestring

Comparison period end (YYYY-MM-DD)

keywordsstring

Comma-separated keywords to scope to

keywordstring

Older single-value spelling of keywords

domainsstring

Comma-separated comparison domains (max 3)

autoPickstring

Pass 'false' to disable auto-picked comparison domains

Response

Default Response

brandDomainstring nullable
keywordCountinteger
truncatedboolean
keywordUniverseCountinteger

Changes

  • 7ede4ba45814Revision changes
    • warning

      removed the optional property from the response with the status

  • 3976341798f4Revision changes
    • info

      api tag Rank Tracking added

    • info

      added the new optional query request parameter autoPick

    • info

      added the new optional query request parameter compareEndDate

    • info

      added the new optional query request parameter compareStartDate

    • info

      added the new optional query request parameter days

    • info

      added the new optional query request parameter domains

    • info

      added the new optional query request parameter endDate

    • info

      added the new optional query request parameter keyword

    • info

      added the new optional query request parameter keywords

    • info

      added the new optional query request parameter startDate

    • info

      added the new optional query request parameter teamId

    • info

      added the media type application/json for the response with the status