feat: SEO & GEO insights

backend/apps/cloud/src/analytics/analytics.controller.ts

@@ -883,6 +883,150 @@ export class AnalyticsController {
     return { keywords }
   }
 
+  @Get('gsc-dashboard')
+  @Auth(true, true)
+  async getGSCDashboard(
+    @Query() data: GetKeywordsDto,
+    @CurrentUserId() uid: string,
+    @Headers() headers: { 'x-password'?: string },
+  ) {
+    const {
+      pid,
+      period,
+      from,
+      to,
+      timezone = DEFAULT_TIMEZONE,
+      timeBucket,
+      filters,
+    } = data
+
+    await this.analyticsService.checkProjectAccess(
+      pid,
+      uid,
+      headers['x-password'],
+    )
+
+    await this.analyticsService.checkBillingAccess(pid)
+
+    const finalTimeBucket =
+      timeBucket ||
+      (['1h', 'today', 'yesterday', '1d'].includes(period) ? 'hour' : 'day')
+
+    this.logger.log(
+      `pid: ${pid}, period: ${period}, timeBucket: ${finalTimeBucket}, filters: ${filters}`,
+      'GET /analytics/gsc-dashboard',
+    )
+
+    let diff
+
+    if (period === 'all') {
+      const res = await this.analyticsService.calculateTimeBucketForAllTime(
+        pid,
+        'analytics',
+      )
+
+      diff = res.diff
+    }
+
+    const safeTimezone = this.analyticsService.getSafeTimezone(timezone)
+    const { groupFrom, groupTo } = this.analyticsService.getGroupFromTo(
+      from,
+      to,
+      null,
+      period,
+      safeTimezone,
+      diff,
+    )
+
+    return this.gscService.getDashboard(
+      pid,
+      groupFrom,
+      groupTo,
+      finalTimeBucket,
+      filters,
+    )
+  }
+
+  @Get('gsc-details')
+  @Auth(true, true)
+  async getGSCDetails(
+    @Query() data: GetKeywordsDto,
+    @CurrentUserId() uid: string,
+    @Headers() headers: { 'x-password'?: string },
+  ) {
+    const {
+      pid,
+      period,
+      from,
+      to,
+      timezone = DEFAULT_TIMEZONE,
+      page,
+      query,
+    } = data
+
+    this.logger.log(
+      `pid: ${pid}, period: ${period}, page: ${page}, query: ${query}`,
+      'GET /analytics/gsc-details',
+    )
+
+    await this.analyticsService.checkProjectAccess(
+      pid,
+      uid,
+      headers['x-password'],
+    )
+
+    await this.analyticsService.checkBillingAccess(pid)
+
+    let diff
+
+    if (period === 'all') {
+      const res = await this.analyticsService.calculateTimeBucketForAllTime(
+        pid,
+        'analytics',
+      )
+
+      diff = res.diff
+    }
+
+    const safeTimezone = this.analyticsService.getSafeTimezone(timezone)
+    const { groupFrom, groupTo } = this.analyticsService.getGroupFromTo(
+      from,
+      to,
+      null,
+      period,
+      safeTimezone,
+      diff,
+    )
+
+    if (page) {
+      const keywords = await this.gscService.getKeywords(
+        pid,
+        groupFrom,
+        groupTo,
+        50,
+        0,
+        undefined,
+        page,
+      )
+      return { type: 'queries', data: keywords }
+    }
+
+    if (query) {
+      const pages = await this.gscService.getTopPages(
+        pid,
+        groupFrom,
+        groupTo,
+        50,
+        0,
+        undefined,
+        query,
+      )
+      return { type: 'pages', data: pages }
+    }
+
+    return { type: 'none', data: [] }
+  }
+
   @Get('birdseye')
   @Auth(true, true)
   // returns overall short statistics per project

backend/apps/cloud/src/analytics/dto/get-keywords.dto.ts

@@ -18,4 +18,20 @@ export class GetKeywordsDto {
   @IsOptional()
   @IsString()
   timezone?: string
+
+  @IsOptional()
+  @IsString()
+  timeBucket?: string
+
+  @IsOptional()
+  @IsString()
+  filters?: string
+
+  @IsOptional()
+  @IsString()
+  page?: string
+
+  @IsOptional()
+  @IsString()
+  query?: string
 }

backend/apps/cloud/src/project/dto/project.dto.ts

@@ -5,6 +5,7 @@ import {
   IsEnum,
   IsOptional,
   IsArray,
+  IsString,
   IsUrl,
   MaxLength,
   ValidateIf,
@@ -87,4 +88,16 @@ export class ProjectDTO {
   @IsUrl({}, { message: 'websiteUrl must be a valid URL' })
   @MaxLength(512)
   websiteUrl?: string | null
+
+  @ApiProperty({
+    example: ['swetrix', 'swetrix analytics'],
+    required: false,
+    description:
+      'Brand keywords used to classify search queries as branded vs non-branded traffic.',
+  })
+  @IsOptional()
+  @ValidateIf((o) => o.brandKeywords !== null && o.brandKeywords !== undefined)
+  @IsArray()
+  @IsString({ each: true })
+  brandKeywords?: string[] | null
 }

backend/apps/cloud/src/project/entity/project.entity.ts

@@ -179,4 +179,8 @@ export class Project {
   @ApiProperty()
   @Column('varchar', { nullable: true, default: null, length: 512 })
   websiteUrl: string | null
+
+  @ApiProperty({ type: [String], nullable: true })
+  @Column('text', { nullable: true, default: null })
+  brandKeywords: string | null
 }