Skip to main content

​
Introduction

SE Ranking is an SEO platform for tracking organic keyword positions, search volume, competitor movement, and backlink health. The connector uses SE Ranking’s REST API (v4) to import daily keyword-position data for a specific tracked site on a specific search engine, and refreshes the rolling window twice a day. Each Adriel data source represents one site + one search engine combination — for example, example.com on Google United States. To track the same site across multiple engines (or multiple sites), create one Adriel data source per combination. As a SEO / Content connector, SE Ranking data is exposed as a Generic Table and can be blended with other SEO connectors via blend data settings. To connect this data source, see How to connect SE Ranking to Adriel.

​
Data refresh strategy

SE Ranking uses a daily cache. After the connection is created, historic daily data going back 180 days is retrieved. Refresh schedule.
  • 5:00 AM UTC daily — the latest 10 days of keyword-position data are refreshed.
  • 5:00 PM UTC daily — the latest 10 days of keyword-position data are refreshed.

​
Architecture levels

Account → Site → Engine → Keyword The Adriel data source is scoped to one Site + one Engine pair; individual keywords are rows within that scope.

​
Date range limits

​
Metrics

How to read the columnsData type uses this vocabulary: Number, Currency, Percentage, Ratio, Duration, Date, Text, URL, Array, Boolean.API Key in code style like position is the literal SE Ranking API v4 field name.

​
Keyword ranking

​
Search volume & value

​
Keyword metadata

​
Breakdowns

​
Standard

​
Time & date grouping

Adriel groups SE Ranking’s daily-granularity results into these standard views for reporting alongside other connectors.

​
Limitations

  • One site + one engine per data source — to track a site across multiple engines, or multiple sites, create one Adriel data source per combination.
  • 180-day historical limit — only the last 180 days of keyword-position data are ingested at connection time; older history from SE Ranking is not backfilled.
  • Search volume is per keyword, not per day — SE Ranking returns monthly search volume alongside daily positions, so the same value repeats across every day for a given keyword. Aggregate with max, not sum.
  • API v4 only — the connector is pinned to the SE Ranking API v4 base (https://api4.seranking.com); no version negotiation.
  • Generic Table shape — SE Ranking data is exposed as a Generic Table. To combine it with other connector types, use blend data settings.

​
API references (SE Ranking)

  • SE Ranking API v4 documentation
  • Endpoints used: GET /sites (site list), GET /sites/{siteId}/search-engines (engine list), GET /sites/{siteId}/positions (keyword positions).

​
See also