Rank Tracking

Ranking distribution trend

Changed on

Keyword counts per position bucket over time, with rising, falling, new and lost movement between periods.

get/v3/rank-tracking/distribution-trend

Request

  • Base URL: https://api.snowseo.com
  • URL: https://api.snowseo.com/v3/rank-tracking/distribution-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)

devicestring

Device filter

typestring

Search type filter

countrystring

Country filter

scope'all' | 'ranked' | 'tracked'

Keyword universe: all (GSC + tracked merged), ranked (GSC only), tracked (tracked only). Defaults to all.

Response

Default Response

Changes

  • 3976341798f4Revision changes
    • info

      api tag Rank Tracking added

    • info

      added the new optional query request parameter country

    • info

      added the new optional query request parameter days

    • info

      added the new optional query request parameter device

    • info

      added the new optional query request parameter endDate

    • info

      added the new optional query request parameter scope

    • info

      added the new optional query request parameter startDate

    • info

      added the new optional query request parameter teamId

    • info

      added the new optional query request parameter type

    • info

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