SE Ranking icon

SE Ranking

Interact with SE Ranking API for SEO data

Actions221

Project Management → Get Ranking Trends

AI-generated

Summary

Retrieve ranking trends for a SE Ranking project over a date range, optionally filtering by search engine, metric, keyword group, keyword IDs, or landing-page tag IDs.

Inputs

  • Site ID (required) — The project (site) ID to query.
  • Site Engine ID — Limit results to one search engine; this omits the cross-engine average row.
  • Date From — Range start in YYYY-MM-DD format. Defaults to 7 days ago.
  • Date To — Range end in YYYY-MM-DD format. Defaults to today.
  • Metric Type — Ranking metric to retrieve: average position, visibility raw score, visibility percentage, Top 10 count, or Top 10 percentage. Defaults to average position.
  • Group ID — Filter results to a keyword group.
  • Keyword IDs — Comma-separated keyword IDs to filter.
  • Tag IDs — Comma-separated landing-page tag IDs to filter.

Output shape

A ranking-trends response from the SE Ranking API.

The source pack contains only a signature-level view of the operation implementation, so the precise response fields and envelope are not shown.

Examples

Example 1: Retrieve average-position trends for the last 7 days

Provide a Site ID and leave Additional Fields at their defaults.

Example 2: Retrieve visibility percentage for selected keywords and dates

Provide a Site ID, set Metric Type to Visibility (%), enter Date From and Date To, and list Keyword IDs separated by commas.

Links

Discussion