Skip to content

Open source alternative to Semrush and Ahrefs

Rank positions: report organic rank (rank_group), not absolute SERP slot (#429)

Ben Senescuc81fd7a130ef
diff --git a/src/server/features/keywords/services/research/serp.ts b/src/server/features/keywords/services/research/serp.ts
index 7fde9405..8eb404f7 100644
--- a/src/server/features/keywords/services/research/serp.ts
+++ b/src/server/features/keywords/services/research/serp.ts
@@ -41,7 +41,7 @@ function mapOrganicSerpItems(items: SerpLiveItem[]): SerpResultItem[] {
return items
.filter((item) => item.type === "organic")
.map((item) => ({
- rank: item.rank_absolute ?? item.rank_group ?? 0,
+ rank: item.rank_group ?? item.rank_absolute ?? 0,
title: item.title ?? "",
url: item.url ?? "",
domain: item.domain ?? "",
diff --git a/src/server/features/onboarding/onboardingMarketTools.ts b/src/server/features/onboarding/onboardingMarketTools.ts
index 4a12c421..142458a6 100644
--- a/src/server/features/onboarding/onboardingMarketTools.ts
+++ b/src/server/features/onboarding/onboardingMarketTools.ts
@@ -87,7 +87,7 @@ export function marketTools(ctx: ToolContext): ToolSet {
.filter((item) => item.type === "organic")
.slice(0, 10)
.map((item) => ({
- rank: item.rank_absolute ?? item.rank_group ?? null,
+ rank: item.rank_group ?? item.rank_absolute ?? null,
domain: item.domain ?? null,
title: item.title ?? null,
url: item.url ?? null,
diff --git a/src/server/lib/dataforseo/serp.test.ts b/src/server/lib/dataforseo/serp.test.ts
index 75130f34..f0073ce5 100644
--- a/src/server/lib/dataforseo/serp.test.ts
+++ b/src/server/lib/dataforseo/serp.test.ts
@@ -168,7 +168,7 @@ describe("rank check task queue", () => {
result: {
keywordId: "kw-1",
keyword: "alpha",
- position: 4,
+ position: 3,
url: "https://www.example.com/page",
serpFeatures: ["organic"],
},
diff --git a/src/server/lib/dataforseo/serp.ts b/src/server/lib/dataforseo/serp.ts
index 9ed6908a..6d9d7878 100644
--- a/src/server/lib/dataforseo/serp.ts
+++ b/src/server/lib/dataforseo/serp.ts
@@ -129,8 +129,11 @@ function buildRankCheckResult(
return {
keywordId: input.keywordId,
keyword: input.keyword,
+ // rank_group = position among organic results only (what users count as
+ // "my ranking"). rank_absolute would also count SERP features (local
+ // pack, PAA, AI overviews) and reads as worse than what users see.
position: organicMatch
- ? (organicMatch.rank_absolute ?? organicMatch.rank_group ?? null)
+ ? (organicMatch.rank_group ?? organicMatch.rank_absolute ?? null)
: null,
url: organicMatch?.url ?? null,
serpFeatures: [...new Set(items.map((item) => item.type).filter(Boolean))],