> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adriel.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Data reference
> Metrics, breakdowns, refresh cadence, and limits for the SE Ranking data source in Adriel.
## 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-sources/o-z/se-ranking/how-to-connect).
## 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
| Breakdown | Max range |
| -------------------------- | ------------------- |
| Daily | 93 days |
| Weekly | 1 year |
| Historical (any breakdown) | 180 days from today |
## Metrics
**How to read the columns**
**Data 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
| Metric | Description | Data type | API Key |
| --------------- | ------------------------------------------------------------------------------------------------------- | --------- | -------------------------- |
| Position | The keyword's current organic rank on the tracked search engine. | Number | `position` (from `p.pos`) |
| Position change | Rank movement since the previous tracked period. Positive = climbing toward rank 1; negative = falling. | Number | `change` (from `p.change`) |
| Depth | Crawl depth at which the ranking result was found. | Number | `depth` (from `p.depth`) |
### Search volume & value
| Metric | Description | Data type | API Key |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | --------------------------------- |
| Search volume | Estimated monthly search volume for the keyword. This value is shared across all position rows for the same keyword; its default aggregation is max rather than sum. | Number | `search_volume` (from `k.volume`) |
| Estimated CPC / price | CPC-equivalent price estimate for the keyword. | Currency | `price` (from `p.price`) |
### Keyword metadata
| Metric | Description | Data type | API Key |
| ------- | ------------------------------------------------------ | --------- | ------------------------- |
| Keyword | The tracked keyword text — also the primary breakdown. | Text | `keyword` (from `k.name`) |
## Breakdowns
### Standard
| Breakdown | Description | API Key |
| ---------------- | ------------------------------------------------------------------------------------------------------- | ----------------- |
| Keyword | Group by tracked keyword. | `keyword` |
| Data source name | Group by the Adriel data source name — useful when a workspace has multiple site + engine combinations. | *Adriel metadata* |
### Time & date grouping
Adriel groups SE Ranking's daily-granularity results into these standard views for reporting alongside other connectors.
| Breakdown | Description |
| ------------------- | ------------------------------------------------------------------------ |
| Auto Time Breakdown | Automatically picks the best granularity for the date range. |
| Daily | Split reports by day. Limited to 93 days per query. |
| Weekly (Start: Mon) | Split reports by ISO week, starting Monday. Limited to 1 year per query. |
| Monthly | Split reports by calendar month. |
| Quarterly | Split reports by calendar quarter. |
| Yearly | Split reports by calendar year. |
## 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](https://seranking.com/api.html)
* Endpoints used: `GET /sites` (site list), `GET /sites/{siteId}/search-engines` (engine list), `GET /sites/{siteId}/positions` (keyword positions).
## See also
* [How to connect SE Ranking](/data-sources/o-z/se-ranking/how-to-connect) (paired how-to)
* [Semrush data reference](/data-sources/o-z/semrush/data-reference) — for a compare-and-contrast SEO reference
* [Google Search Console data reference](/data-sources/g-n/google-search-console/data-reference) — for organic-search-console-side rankings