@nuxtseo/protocol 0.1.0 → 0.1.1

package/dist/v1/research.d.ts

@@ -543,6 +543,572 @@ export declare const storedResearchOverviewResponseSchema: import("./core.js").C
     }, z.core.$loose>;
 }, z.core.$strip>>;
 export type StoredResearchOverview = z.output<typeof storedResearchOverviewDataSchema.producer>;
+export declare const keywordResearchQuerySchema: z.ZodObject<{
+    topic: z.ZodString;
+    minVolume: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    maxVolume: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    minDifficulty: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    maxDifficulty: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    intent: z.ZodOptional<z.ZodString>;
+    includeRelated: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+        0: "0";
+        1: "1";
+        false: "false";
+        true: "true";
+    }>]>, z.ZodTransform<boolean, "0" | "1" | "false" | "true" | boolean>>>;
+    verbose: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+        0: "0";
+        1: "1";
+        false: "false";
+        true: "true";
+    }>]>, z.ZodTransform<boolean, "0" | "1" | "false" | "true" | boolean>>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    locationCode: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+declare const keywordResearchDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly topic: z.ZodString;
+    readonly keywords: z.ZodArray<z.ZodObject<{
+        readonly keyword: z.ZodString;
+        readonly volume: z.ZodNullable<z.ZodNumber>;
+        readonly difficulty: z.ZodNullable<z.ZodNumber>;
+        readonly intent: z.ZodNullable<z.ZodString>;
+        readonly secondaryIntents: z.ZodNullable<z.ZodArray<z.ZodString>>;
+        readonly cpc: z.ZodNullable<z.ZodNumber>;
+        readonly competition: z.ZodNullable<z.ZodNumber>;
+        readonly competitionLevel: z.ZodNullable<z.ZodEnum<{
+            HIGH: "HIGH";
+            LOW: "LOW";
+            MEDIUM: "MEDIUM";
+        }>>;
+        readonly lowBid: z.ZodNullable<z.ZodNumber>;
+        readonly highBid: z.ZodNullable<z.ZodNumber>;
+        readonly trend: z.ZodNullable<z.ZodArray<z.ZodObject<{
+            readonly year: z.ZodNumber;
+            readonly month: z.ZodNumber;
+            readonly volume: z.ZodNumber;
+        }, z.core.$strip>>>;
+        readonly serpFeatures: z.ZodNullable<z.ZodArray<z.ZodString>>;
+        readonly backlinks: z.ZodNullable<z.ZodNumber>;
+        readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    readonly totalFound: z.ZodNumber;
+    readonly filters: z.ZodObject<{
+        minVolume: z.ZodNumber;
+        maxVolume: z.ZodNumber;
+        minDifficulty: z.ZodNumber;
+        maxDifficulty: z.ZodNumber;
+        intent: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly message: z.ZodOptional<z.ZodString>;
+    readonly tip: z.ZodOptional<z.ZodString>;
+    readonly serpFallback: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        message: z.ZodString;
+        topResults: z.ZodArray<z.ZodObject<{
+            readonly position: z.ZodNumber;
+            readonly title: z.ZodString;
+            readonly domain: z.ZodString;
+            readonly url: z.ZodString;
+        }, z.core.$strip>>;
+        tip: z.ZodString;
+    }, z.core.$strict>>>;
+    readonly evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        _tag: z.ZodLiteral<"no-provider">;
+        provider: z.ZodNull;
+        spend: z.ZodObject<{
+            key: z.ZodLiteral<"dataforseo">;
+            units: z.ZodLiteral<0>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        _tag: z.ZodLiteral<"cache">;
+        provider: z.ZodLiteral<"dataforseo">;
+        spend: z.ZodObject<{
+            key: z.ZodLiteral<"dataforseo">;
+            units: z.ZodLiteral<0>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        _tag: z.ZodLiteral<"live">;
+        provider: z.ZodLiteral<"dataforseo">;
+        spend: z.ZodObject<{
+            key: z.ZodLiteral<"dataforseo">;
+            units: z.ZodLiteral<1>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "_tag">;
+}, z.core.$strip>, z.ZodObject<{
+    readonly topic: z.ZodString;
+    readonly keywords: z.ZodArray<z.ZodObject<{
+        readonly keyword: z.ZodString;
+        readonly volume: z.ZodNullable<z.ZodNumber>;
+        readonly difficulty: z.ZodNullable<z.ZodNumber>;
+        readonly intent: z.ZodNullable<z.ZodString>;
+        readonly secondaryIntents: z.ZodNullable<z.ZodArray<z.ZodString>>;
+        readonly cpc: z.ZodNullable<z.ZodNumber>;
+        readonly competition: z.ZodNullable<z.ZodNumber>;
+        readonly competitionLevel: z.ZodNullable<z.ZodEnum<{
+            HIGH: "HIGH";
+            LOW: "LOW";
+            MEDIUM: "MEDIUM";
+        }>>;
+        readonly lowBid: z.ZodNullable<z.ZodNumber>;
+        readonly highBid: z.ZodNullable<z.ZodNumber>;
+        readonly trend: z.ZodNullable<z.ZodArray<z.ZodObject<{
+            readonly year: z.ZodNumber;
+            readonly month: z.ZodNumber;
+            readonly volume: z.ZodNumber;
+        }, z.core.$strip>>>;
+        readonly serpFeatures: z.ZodNullable<z.ZodArray<z.ZodString>>;
+        readonly backlinks: z.ZodNullable<z.ZodNumber>;
+        readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    readonly totalFound: z.ZodNumber;
+    readonly filters: z.ZodObject<{
+        minVolume: z.ZodNumber;
+        maxVolume: z.ZodNumber;
+        minDifficulty: z.ZodNumber;
+        maxDifficulty: z.ZodNumber;
+        intent: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    readonly message: z.ZodOptional<z.ZodString>;
+    readonly tip: z.ZodOptional<z.ZodString>;
+    readonly serpFallback: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        message: z.ZodString;
+        topResults: z.ZodArray<z.ZodObject<{
+            readonly position: z.ZodNumber;
+            readonly title: z.ZodString;
+            readonly domain: z.ZodString;
+            readonly url: z.ZodString;
+        }, z.core.$strip>>;
+        tip: z.ZodString;
+    }, z.core.$loose>>>;
+    readonly evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        _tag: z.ZodLiteral<"no-provider">;
+        provider: z.ZodNull;
+        spend: z.ZodObject<{
+            key: z.ZodLiteral<"dataforseo">;
+            units: z.ZodLiteral<0>;
+        }, z.core.$loose>;
+    }, z.core.$loose>, z.ZodObject<{
+        _tag: z.ZodLiteral<"cache">;
+        provider: z.ZodLiteral<"dataforseo">;
+        spend: z.ZodObject<{
+            key: z.ZodLiteral<"dataforseo">;
+            units: z.ZodLiteral<0>;
+        }, z.core.$loose>;
+    }, z.core.$loose>, z.ZodObject<{
+        _tag: z.ZodLiteral<"live">;
+        provider: z.ZodLiteral<"dataforseo">;
+        spend: z.ZodObject<{
+            key: z.ZodLiteral<"dataforseo">;
+            units: z.ZodLiteral<1>;
+        }, z.core.$loose>;
+    }, z.core.$loose>], "_tag">;
+}, z.core.$strip>>;
+export declare const keywordResearchResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    data: z.ZodObject<{
+        readonly topic: z.ZodString;
+        readonly keywords: z.ZodArray<z.ZodObject<{
+            readonly keyword: z.ZodString;
+            readonly volume: z.ZodNullable<z.ZodNumber>;
+            readonly difficulty: z.ZodNullable<z.ZodNumber>;
+            readonly intent: z.ZodNullable<z.ZodString>;
+            readonly secondaryIntents: z.ZodNullable<z.ZodArray<z.ZodString>>;
+            readonly cpc: z.ZodNullable<z.ZodNumber>;
+            readonly competition: z.ZodNullable<z.ZodNumber>;
+            readonly competitionLevel: z.ZodNullable<z.ZodEnum<{
+                HIGH: "HIGH";
+                LOW: "LOW";
+                MEDIUM: "MEDIUM";
+            }>>;
+            readonly lowBid: z.ZodNullable<z.ZodNumber>;
+            readonly highBid: z.ZodNullable<z.ZodNumber>;
+            readonly trend: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                readonly year: z.ZodNumber;
+                readonly month: z.ZodNumber;
+                readonly volume: z.ZodNumber;
+            }, z.core.$strip>>>;
+            readonly serpFeatures: z.ZodNullable<z.ZodArray<z.ZodString>>;
+            readonly backlinks: z.ZodNullable<z.ZodNumber>;
+            readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+        readonly totalFound: z.ZodNumber;
+        readonly filters: z.ZodObject<{
+            minVolume: z.ZodNumber;
+            maxVolume: z.ZodNumber;
+            minDifficulty: z.ZodNumber;
+            maxDifficulty: z.ZodNumber;
+            intent: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        readonly message: z.ZodOptional<z.ZodString>;
+        readonly tip: z.ZodOptional<z.ZodString>;
+        readonly serpFallback: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            message: z.ZodString;
+            topResults: z.ZodArray<z.ZodObject<{
+                readonly position: z.ZodNumber;
+                readonly title: z.ZodString;
+                readonly domain: z.ZodString;
+                readonly url: z.ZodString;
+            }, z.core.$strip>>;
+            tip: z.ZodString;
+        }, z.core.$strict>>>;
+        readonly evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            _tag: z.ZodLiteral<"no-provider">;
+            provider: z.ZodNull;
+            spend: z.ZodObject<{
+                key: z.ZodLiteral<"dataforseo">;
+                units: z.ZodLiteral<0>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            _tag: z.ZodLiteral<"cache">;
+            provider: z.ZodLiteral<"dataforseo">;
+            spend: z.ZodObject<{
+                key: z.ZodLiteral<"dataforseo">;
+                units: z.ZodLiteral<0>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            _tag: z.ZodLiteral<"live">;
+            provider: z.ZodLiteral<"dataforseo">;
+            spend: z.ZodObject<{
+                key: z.ZodLiteral<"dataforseo">;
+                units: z.ZodLiteral<1>;
+            }, z.core.$strict>;
+        }, z.core.$strict>], "_tag">;
+    }, z.core.$strip>;
+    meta: z.ZodObject<{
+        requestId: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    data: z.ZodObject<{
+        readonly topic: z.ZodString;
+        readonly keywords: z.ZodArray<z.ZodObject<{
+            readonly keyword: z.ZodString;
+            readonly volume: z.ZodNullable<z.ZodNumber>;
+            readonly difficulty: z.ZodNullable<z.ZodNumber>;
+            readonly intent: z.ZodNullable<z.ZodString>;
+            readonly secondaryIntents: z.ZodNullable<z.ZodArray<z.ZodString>>;
+            readonly cpc: z.ZodNullable<z.ZodNumber>;
+            readonly competition: z.ZodNullable<z.ZodNumber>;
+            readonly competitionLevel: z.ZodNullable<z.ZodEnum<{
+                HIGH: "HIGH";
+                LOW: "LOW";
+                MEDIUM: "MEDIUM";
+            }>>;
+            readonly lowBid: z.ZodNullable<z.ZodNumber>;
+            readonly highBid: z.ZodNullable<z.ZodNumber>;
+            readonly trend: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                readonly year: z.ZodNumber;
+                readonly month: z.ZodNumber;
+                readonly volume: z.ZodNumber;
+            }, z.core.$strip>>>;
+            readonly serpFeatures: z.ZodNullable<z.ZodArray<z.ZodString>>;
+            readonly backlinks: z.ZodNullable<z.ZodNumber>;
+            readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+        readonly totalFound: z.ZodNumber;
+        readonly filters: z.ZodObject<{
+            minVolume: z.ZodNumber;
+            maxVolume: z.ZodNumber;
+            minDifficulty: z.ZodNumber;
+            maxDifficulty: z.ZodNumber;
+            intent: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        readonly message: z.ZodOptional<z.ZodString>;
+        readonly tip: z.ZodOptional<z.ZodString>;
+        readonly serpFallback: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            message: z.ZodString;
+            topResults: z.ZodArray<z.ZodObject<{
+                readonly position: z.ZodNumber;
+                readonly title: z.ZodString;
+                readonly domain: z.ZodString;
+                readonly url: z.ZodString;
+            }, z.core.$strip>>;
+            tip: z.ZodString;
+        }, z.core.$loose>>>;
+        readonly evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            _tag: z.ZodLiteral<"no-provider">;
+            provider: z.ZodNull;
+            spend: z.ZodObject<{
+                key: z.ZodLiteral<"dataforseo">;
+                units: z.ZodLiteral<0>;
+            }, z.core.$loose>;
+        }, z.core.$loose>, z.ZodObject<{
+            _tag: z.ZodLiteral<"cache">;
+            provider: z.ZodLiteral<"dataforseo">;
+            spend: z.ZodObject<{
+                key: z.ZodLiteral<"dataforseo">;
+                units: z.ZodLiteral<0>;
+            }, z.core.$loose>;
+        }, z.core.$loose>, z.ZodObject<{
+            _tag: z.ZodLiteral<"live">;
+            provider: z.ZodLiteral<"dataforseo">;
+            spend: z.ZodObject<{
+                key: z.ZodLiteral<"dataforseo">;
+                units: z.ZodLiteral<1>;
+            }, z.core.$loose>;
+        }, z.core.$loose>], "_tag">;
+    }, z.core.$strip>;
+    meta: z.ZodObject<{
+        requestId: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+    }, z.core.$loose>;
+}, z.core.$strip>>;
+export declare const serpResearchQuerySchema: z.ZodObject<{
+    keyword: z.ZodString;
+    depth: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    locationCode: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+declare const serpResearchDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly keyword: z.ZodString;
+    readonly depth: z.ZodNumber;
+    readonly results: z.ZodArray<z.ZodObject<{
+        readonly position: z.ZodNumber;
+        readonly url: z.ZodString;
+        readonly title: z.ZodString;
+        readonly domain: z.ZodString;
+        readonly description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    readonly serpFeatures: z.ZodArray<z.ZodString>;
+    readonly hasAiOverview: z.ZodBoolean;
+    readonly hasFeaturedSnippet: z.ZodBoolean;
+    readonly hasLocalPack: z.ZodBoolean;
+    readonly hasPeopleAlsoAsk: z.ZodBoolean;
+    readonly fetchedAt: z.ZodString;
+    readonly cached: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    readonly keyword: z.ZodString;
+    readonly depth: z.ZodNumber;
+    readonly results: z.ZodArray<z.ZodObject<{
+        readonly position: z.ZodNumber;
+        readonly url: z.ZodString;
+        readonly title: z.ZodString;
+        readonly domain: z.ZodString;
+        readonly description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    readonly serpFeatures: z.ZodArray<z.ZodString>;
+    readonly hasAiOverview: z.ZodBoolean;
+    readonly hasFeaturedSnippet: z.ZodBoolean;
+    readonly hasLocalPack: z.ZodBoolean;
+    readonly hasPeopleAlsoAsk: z.ZodBoolean;
+    readonly fetchedAt: z.ZodString;
+    readonly cached: z.ZodBoolean;
+}, z.core.$strip>>;
+export declare const serpResearchResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    data: z.ZodObject<{
+        readonly keyword: z.ZodString;
+        readonly depth: z.ZodNumber;
+        readonly results: z.ZodArray<z.ZodObject<{
+            readonly position: z.ZodNumber;
+            readonly url: z.ZodString;
+            readonly title: z.ZodString;
+            readonly domain: z.ZodString;
+            readonly description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        readonly serpFeatures: z.ZodArray<z.ZodString>;
+        readonly hasAiOverview: z.ZodBoolean;
+        readonly hasFeaturedSnippet: z.ZodBoolean;
+        readonly hasLocalPack: z.ZodBoolean;
+        readonly hasPeopleAlsoAsk: z.ZodBoolean;
+        readonly fetchedAt: z.ZodString;
+        readonly cached: z.ZodBoolean;
+    }, z.core.$strip>;
+    meta: z.ZodObject<{
+        requestId: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    data: z.ZodObject<{
+        readonly keyword: z.ZodString;
+        readonly depth: z.ZodNumber;
+        readonly results: z.ZodArray<z.ZodObject<{
+            readonly position: z.ZodNumber;
+            readonly url: z.ZodString;
+            readonly title: z.ZodString;
+            readonly domain: z.ZodString;
+            readonly description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        readonly serpFeatures: z.ZodArray<z.ZodString>;
+        readonly hasAiOverview: z.ZodBoolean;
+        readonly hasFeaturedSnippet: z.ZodBoolean;
+        readonly hasLocalPack: z.ZodBoolean;
+        readonly hasPeopleAlsoAsk: z.ZodBoolean;
+        readonly fetchedAt: z.ZodString;
+        readonly cached: z.ZodBoolean;
+    }, z.core.$strip>;
+    meta: z.ZodObject<{
+        requestId: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+    }, z.core.$loose>;
+}, z.core.$strip>>;
+export declare const rankingsResearchQuerySchema: z.ZodObject<{
+    domain: z.ZodString;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    minPosition: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    maxPosition: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    locationCode: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    order: z.ZodDefault<z.ZodEnum<{
+        position: "position";
+        traffic: "traffic";
+    }>>;
+}, z.core.$strict>;
+declare const rankingsResearchDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly domain: z.ZodString;
+    readonly keywords: z.ZodArray<z.ZodObject<{
+        readonly keyword: z.ZodString;
+        readonly position: z.ZodNumber;
+        readonly volume: z.ZodNumber;
+        readonly traffic: z.ZodNumber;
+        readonly url: z.ZodString;
+        readonly intent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    readonly totalFound: z.ZodNumber;
+    readonly metrics: z.ZodNullable<z.ZodObject<{
+        readonly organicTraffic: z.ZodNumber;
+        readonly totalKeywords: z.ZodNumber;
+        readonly keywordFootprint: z.ZodObject<{
+            score: z.ZodNullable<z.ZodNumber>;
+            scale: z.ZodObject<{
+                min: z.ZodLiteral<0>;
+                max: z.ZodLiteral<100>;
+            }, z.core.$strict>;
+            provenance: z.ZodLiteral<"local-keyword-count">;
+        }, z.core.$strict>;
+        readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+        readonly topPages: z.ZodArray<z.ZodObject<{
+            readonly path: z.ZodString;
+            readonly traffic: z.ZodNumber;
+            readonly keywords: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    readonly positionRange: z.ZodOptional<z.ZodObject<{
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+    }, z.core.$strict>>;
+    readonly message: z.ZodOptional<z.ZodString>;
+    readonly cached: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    readonly domain: z.ZodString;
+    readonly keywords: z.ZodArray<z.ZodObject<{
+        readonly keyword: z.ZodString;
+        readonly position: z.ZodNumber;
+        readonly volume: z.ZodNumber;
+        readonly traffic: z.ZodNumber;
+        readonly url: z.ZodString;
+        readonly intent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    readonly totalFound: z.ZodNumber;
+    readonly metrics: z.ZodNullable<z.ZodObject<{
+        readonly organicTraffic: z.ZodNumber;
+        readonly totalKeywords: z.ZodNumber;
+        readonly keywordFootprint: z.ZodObject<{
+            score: z.ZodNullable<z.ZodNumber>;
+            scale: z.ZodObject<{
+                min: z.ZodLiteral<0>;
+                max: z.ZodLiteral<100>;
+            }, z.core.$loose>;
+            provenance: z.ZodLiteral<"local-keyword-count">;
+        }, z.core.$loose>;
+        readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+        readonly topPages: z.ZodArray<z.ZodObject<{
+            readonly path: z.ZodString;
+            readonly traffic: z.ZodNumber;
+            readonly keywords: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    readonly positionRange: z.ZodOptional<z.ZodObject<{
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+    }, z.core.$loose>>;
+    readonly message: z.ZodOptional<z.ZodString>;
+    readonly cached: z.ZodBoolean;
+}, z.core.$strip>>;
+export declare const rankingsResearchResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    data: z.ZodObject<{
+        readonly domain: z.ZodString;
+        readonly keywords: z.ZodArray<z.ZodObject<{
+            readonly keyword: z.ZodString;
+            readonly position: z.ZodNumber;
+            readonly volume: z.ZodNumber;
+            readonly traffic: z.ZodNumber;
+            readonly url: z.ZodString;
+            readonly intent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>;
+        readonly totalFound: z.ZodNumber;
+        readonly metrics: z.ZodNullable<z.ZodObject<{
+            readonly organicTraffic: z.ZodNumber;
+            readonly totalKeywords: z.ZodNumber;
+            readonly keywordFootprint: z.ZodObject<{
+                score: z.ZodNullable<z.ZodNumber>;
+                scale: z.ZodObject<{
+                    min: z.ZodLiteral<0>;
+                    max: z.ZodLiteral<100>;
+                }, z.core.$strict>;
+                provenance: z.ZodLiteral<"local-keyword-count">;
+            }, z.core.$strict>;
+            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+            readonly topPages: z.ZodArray<z.ZodObject<{
+                readonly path: z.ZodString;
+                readonly traffic: z.ZodNumber;
+                readonly keywords: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        readonly positionRange: z.ZodOptional<z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+        }, z.core.$strict>>;
+        readonly message: z.ZodOptional<z.ZodString>;
+        readonly cached: z.ZodBoolean;
+    }, z.core.$strip>;
+    meta: z.ZodObject<{
+        requestId: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    data: z.ZodObject<{
+        readonly domain: z.ZodString;
+        readonly keywords: z.ZodArray<z.ZodObject<{
+            readonly keyword: z.ZodString;
+            readonly position: z.ZodNumber;
+            readonly volume: z.ZodNumber;
+            readonly traffic: z.ZodNumber;
+            readonly url: z.ZodString;
+            readonly intent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>;
+        readonly totalFound: z.ZodNumber;
+        readonly metrics: z.ZodNullable<z.ZodObject<{
+            readonly organicTraffic: z.ZodNumber;
+            readonly totalKeywords: z.ZodNumber;
+            readonly keywordFootprint: z.ZodObject<{
+                score: z.ZodNullable<z.ZodNumber>;
+                scale: z.ZodObject<{
+                    min: z.ZodLiteral<0>;
+                    max: z.ZodLiteral<100>;
+                }, z.core.$loose>;
+                provenance: z.ZodLiteral<"local-keyword-count">;
+            }, z.core.$loose>;
+            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+            readonly topPages: z.ZodArray<z.ZodObject<{
+                readonly path: z.ZodString;
+                readonly traffic: z.ZodNumber;
+                readonly keywords: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        readonly positionRange: z.ZodOptional<z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+        }, z.core.$loose>>;
+        readonly message: z.ZodOptional<z.ZodString>;
+        readonly cached: z.ZodBoolean;
+    }, z.core.$strip>;
+    meta: z.ZodObject<{
+        requestId: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+    }, z.core.$loose>;
+}, z.core.$strip>>;
+export type KeywordResearchQuery = z.input<typeof keywordResearchQuerySchema>;
+export type KeywordResearchData = z.output<typeof keywordResearchDataSchema.client>;
+export type SerpResearchQuery = z.input<typeof serpResearchQuerySchema>;
+export type SerpResearchData = z.output<typeof serpResearchDataSchema.client>;
+export type RankingsResearchQuery = z.input<typeof rankingsResearchQuerySchema>;
+export type RankingsResearchData = z.output<typeof rankingsResearchDataSchema.client>;
 export declare const storedResearchOverviewOperation: {
     readonly id: 'research.overview';
     readonly method: 'GET';
@@ -856,74 +1422,900 @@ export declare const storedResearchOverviewOperation: {
         }];
     };
 };
-export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
-    readonly overview: {
-        readonly id: 'research.overview';
-        readonly method: 'GET';
-        readonly path: '/api/v1/sites/{siteId}/research';
-        readonly visibility: 'public';
-        readonly semantics: {
-            readonly kind: 'query';
-            readonly sideEffects: 'none';
-            readonly retry: 'idempotent';
-            readonly readConsistency: 'primary';
-        };
-        readonly auth: {
-            readonly credentials: readonly ["session", "api_token"];
-            readonly scopes: readonly ["research:read"];
-            readonly minimumRole: 'viewer';
-            readonly ownership: 'site';
-        };
-        readonly request: {
-            readonly params: z.ZodObject<{
-                siteId: z.ZodString;
-            }, z.core.$strict>;
-            readonly query: null;
-            readonly headers: null;
-            readonly body: null;
-        };
-        readonly responses: {
-            readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
-                data: z.ZodObject<{
-                    readonly evidence: z.ZodObject<{
-                        _tag: z.ZodLiteral<"stored">;
-                        provider: z.ZodLiteral<"dataforseo">;
-                        collectedAt: z.ZodNullable<z.ZodString>;
+export declare const keywordResearchOperation: {
+    readonly id: 'research.keywords';
+    readonly method: 'GET';
+    readonly path: '/api/v1/sites/{siteId}/research/keywords';
+    readonly visibility: 'public';
+    readonly semantics: {
+        readonly kind: 'query';
+        readonly sideEffects: 'none';
+        readonly retry: 'idempotent';
+        readonly readConsistency: 'primary';
+    };
+    readonly auth: {
+        readonly credentials: readonly ['session', 'api_token'];
+        readonly scopes: readonly ['research:read'];
+        readonly minimumRole: 'viewer';
+        readonly ownership: 'site';
+    };
+    readonly request: {
+        readonly params: z.ZodObject<{
+            siteId: z.ZodString;
+        }, z.core.$strict>;
+        readonly query: z.ZodObject<{
+            topic: z.ZodString;
+            minVolume: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+            maxVolume: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+            minDifficulty: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+            maxDifficulty: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+            intent: z.ZodOptional<z.ZodString>;
+            includeRelated: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+                0: "0";
+                1: "1";
+                false: "false";
+                true: "true";
+            }>]>, z.ZodTransform<boolean, "0" | "1" | "false" | "true" | boolean>>>;
+            verbose: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+                0: "0";
+                1: "1";
+                false: "false";
+                true: "true";
+            }>]>, z.ZodTransform<boolean, "0" | "1" | "false" | "true" | boolean>>>;
+            limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+            locationCode: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        }, z.core.$strict>;
+        readonly headers: null;
+        readonly body: null;
+    };
+    readonly responses: {
+        readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+                readonly topic: z.ZodString;
+                readonly keywords: z.ZodArray<z.ZodObject<{
+                    readonly keyword: z.ZodString;
+                    readonly volume: z.ZodNullable<z.ZodNumber>;
+                    readonly difficulty: z.ZodNullable<z.ZodNumber>;
+                    readonly intent: z.ZodNullable<z.ZodString>;
+                    readonly secondaryIntents: z.ZodNullable<z.ZodArray<z.ZodString>>;
+                    readonly cpc: z.ZodNullable<z.ZodNumber>;
+                    readonly competition: z.ZodNullable<z.ZodNumber>;
+                    readonly competitionLevel: z.ZodNullable<z.ZodEnum<{
+                        HIGH: "HIGH";
+                        LOW: "LOW";
+                        MEDIUM: "MEDIUM";
+                    }>>;
+                    readonly lowBid: z.ZodNullable<z.ZodNumber>;
+                    readonly highBid: z.ZodNullable<z.ZodNumber>;
+                    readonly trend: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                        readonly year: z.ZodNumber;
+                        readonly month: z.ZodNumber;
+                        readonly volume: z.ZodNumber;
+                    }, z.core.$strip>>>;
+                    readonly serpFeatures: z.ZodNullable<z.ZodArray<z.ZodString>>;
+                    readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                    readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+                }, z.core.$strip>>;
+                readonly totalFound: z.ZodNumber;
+                readonly filters: z.ZodObject<{
+                    minVolume: z.ZodNumber;
+                    maxVolume: z.ZodNumber;
+                    minDifficulty: z.ZodNumber;
+                    maxDifficulty: z.ZodNumber;
+                    intent: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
+                readonly message: z.ZodOptional<z.ZodString>;
+                readonly tip: z.ZodOptional<z.ZodString>;
+                readonly serpFallback: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    message: z.ZodString;
+                    topResults: z.ZodArray<z.ZodObject<{
+                        readonly position: z.ZodNumber;
+                        readonly title: z.ZodString;
+                        readonly domain: z.ZodString;
+                        readonly url: z.ZodString;
+                    }, z.core.$strip>>;
+                    tip: z.ZodString;
+                }, z.core.$strict>>>;
+                readonly evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    _tag: z.ZodLiteral<"no-provider">;
+                    provider: z.ZodNull;
+                    spend: z.ZodObject<{
+                        key: z.ZodLiteral<"dataforseo">;
+                        units: z.ZodLiteral<0>;
                     }, z.core.$strict>;
-                    readonly summary: z.ZodObject<{
-                        competitorCount: z.ZodNumber;
-                        quickWins: z.ZodNumber;
-                        totalSharedKeywords: z.ZodNumber;
-                        totalTrafficValue: z.ZodNumber;
+                }, z.core.$strict>, z.ZodObject<{
+                    _tag: z.ZodLiteral<"cache">;
+                    provider: z.ZodLiteral<"dataforseo">;
+                    spend: z.ZodObject<{
+                        key: z.ZodLiteral<"dataforseo">;
+                        units: z.ZodLiteral<0>;
                     }, z.core.$strict>;
-                    readonly subject: z.ZodNullable<z.ZodObject<{
+                }, z.core.$strict>, z.ZodObject<{
+                    _tag: z.ZodLiteral<"live">;
+                    provider: z.ZodLiteral<"dataforseo">;
+                    spend: z.ZodObject<{
+                        key: z.ZodLiteral<"dataforseo">;
+                        units: z.ZodLiteral<1>;
+                    }, z.core.$strict>;
+                }, z.core.$strict>], "_tag">;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+                requestId: z.ZodString;
+                version: z.ZodLiteral<"1.0">;
+            }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+            data: z.ZodObject<{
+                readonly topic: z.ZodString;
+                readonly keywords: z.ZodArray<z.ZodObject<{
+                    readonly keyword: z.ZodString;
+                    readonly volume: z.ZodNullable<z.ZodNumber>;
+                    readonly difficulty: z.ZodNullable<z.ZodNumber>;
+                    readonly intent: z.ZodNullable<z.ZodString>;
+                    readonly secondaryIntents: z.ZodNullable<z.ZodArray<z.ZodString>>;
+                    readonly cpc: z.ZodNullable<z.ZodNumber>;
+                    readonly competition: z.ZodNullable<z.ZodNumber>;
+                    readonly competitionLevel: z.ZodNullable<z.ZodEnum<{
+                        HIGH: "HIGH";
+                        LOW: "LOW";
+                        MEDIUM: "MEDIUM";
+                    }>>;
+                    readonly lowBid: z.ZodNullable<z.ZodNumber>;
+                    readonly highBid: z.ZodNullable<z.ZodNumber>;
+                    readonly trend: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                        readonly year: z.ZodNumber;
+                        readonly month: z.ZodNumber;
+                        readonly volume: z.ZodNumber;
+                    }, z.core.$strip>>>;
+                    readonly serpFeatures: z.ZodNullable<z.ZodArray<z.ZodString>>;
+                    readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                    readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+                }, z.core.$strip>>;
+                readonly totalFound: z.ZodNumber;
+                readonly filters: z.ZodObject<{
+                    minVolume: z.ZodNumber;
+                    maxVolume: z.ZodNumber;
+                    minDifficulty: z.ZodNumber;
+                    maxDifficulty: z.ZodNumber;
+                    intent: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>;
+                readonly message: z.ZodOptional<z.ZodString>;
+                readonly tip: z.ZodOptional<z.ZodString>;
+                readonly serpFallback: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    message: z.ZodString;
+                    topResults: z.ZodArray<z.ZodObject<{
+                        readonly position: z.ZodNumber;
+                        readonly title: z.ZodString;
                         readonly domain: z.ZodString;
-                        readonly metrics: z.ZodObject<{
-                            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
-                            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
-                            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
-                            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
-                        }, z.core.$strip>;
-                        readonly history: z.ZodArray<z.ZodObject<{
-                            readonly observedAt: z.ZodNullable<z.ZodString>;
-                            readonly metrics: z.ZodObject<{
-                                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
-                                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
-                                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
-                                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
-                            }, z.core.$strip>;
-                        }, z.core.$strip>>;
-                        readonly collectedAt: z.ZodNullable<z.ZodString>;
+                        readonly url: z.ZodString;
                     }, z.core.$strip>>;
-                    readonly competitors: z.ZodArray<z.ZodObject<{
-                        readonly domain: z.ZodString;
-                        readonly discovery: z.ZodEnum<{
-                            automatic: "automatic";
-                            manual: "manual";
-                            unknown: "unknown";
-                        }>;
-                        readonly metrics: z.ZodObject<{
-                            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                    tip: z.ZodString;
+                }, z.core.$loose>>>;
+                readonly evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    _tag: z.ZodLiteral<"no-provider">;
+                    provider: z.ZodNull;
+                    spend: z.ZodObject<{
+                        key: z.ZodLiteral<"dataforseo">;
+                        units: z.ZodLiteral<0>;
+                    }, z.core.$loose>;
+                }, z.core.$loose>, z.ZodObject<{
+                    _tag: z.ZodLiteral<"cache">;
+                    provider: z.ZodLiteral<"dataforseo">;
+                    spend: z.ZodObject<{
+                        key: z.ZodLiteral<"dataforseo">;
+                        units: z.ZodLiteral<0>;
+                    }, z.core.$loose>;
+                }, z.core.$loose>, z.ZodObject<{
+                    _tag: z.ZodLiteral<"live">;
+                    provider: z.ZodLiteral<"dataforseo">;
+                    spend: z.ZodObject<{
+                        key: z.ZodLiteral<"dataforseo">;
+                        units: z.ZodLiteral<1>;
+                    }, z.core.$loose>;
+                }, z.core.$loose>], "_tag">;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+                requestId: z.ZodString;
+                version: z.ZodLiteral<"1.0">;
+            }, z.core.$loose>;
+        }, z.core.$strip>>;
+    };
+    readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "not_found", "entitlement_required", "quota_exhausted", "provider_unavailable", "conflict", "rate_limited", "contract_violation", "internal_error"];
+    readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+        readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+                auth_expired: "auth_expired";
+                conflict: "conflict";
+                contract_violation: "contract_violation";
+                entitlement_required: "entitlement_required";
+                forbidden: "forbidden";
+                internal_error: "internal_error";
+                invalid_request: "invalid_request";
+                not_found: "not_found";
+                provider_unavailable: "provider_unavailable";
+                quota_exhausted: "quota_exhausted";
+                rate_limited: "rate_limited";
+                site_ambiguous: "site_ambiguous";
+                stale_evidence: "stale_evidence";
+                unauthorized: "unauthorized";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strict>;
+    }, z.core.$strip>, z.ZodObject<{
+        readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+                auth_expired: "auth_expired";
+                conflict: "conflict";
+                contract_violation: "contract_violation";
+                entitlement_required: "entitlement_required";
+                forbidden: "forbidden";
+                internal_error: "internal_error";
+                invalid_request: "invalid_request";
+                not_found: "not_found";
+                provider_unavailable: "provider_unavailable";
+                quota_exhausted: "quota_exhausted";
+                rate_limited: "rate_limited";
+                site_ambiguous: "site_ambiguous";
+                stale_evidence: "stale_evidence";
+                unauthorized: "unauthorized";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$loose>;
+    }, z.core.$strip>>;
+    readonly resources: {
+        readonly reads: readonly [{
+            readonly type: 'site.research';
+            readonly idFrom: 'params.siteId';
+        }];
+        readonly changes: readonly [];
+    };
+    readonly policy: {
+        readonly rate: {
+            readonly name: 'public-v1-fixed-window';
+            readonly limit: 50;
+            readonly windowSeconds: 60;
+        };
+        readonly idempotency: {
+            readonly _tag: 'none';
+        };
+        readonly entitlement: 'growth';
+        readonly meter: {
+            readonly key: 'dataforseo';
+            readonly units: 1;
+            readonly charge: 'live-only';
+        };
+    };
+    readonly lifecycle: {
+        readonly introduced: '1.0.0';
+    };
+    readonly docs: {
+        readonly summary: 'Research keyword ideas';
+        readonly description: 'Returns keyword ideas with volume, difficulty, intent, cost data, and explicit provider execution and spend evidence. Local guidance and cached reads consume no units.';
+        readonly tags: readonly ["Research"];
+        readonly examples: readonly [{
+            readonly request: {
+                readonly params: {
+                    readonly siteId: 'site_01JXYZ';
+                };
+                readonly query: {
+                    readonly topic: 'nuxt seo';
+                    readonly limit: 20;
+                };
+            };
+            readonly response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly topic: 'nuxt seo';
+                        readonly keywords: readonly [];
+                        readonly totalFound: 0;
+                        readonly filters: {
+                            readonly minVolume: 10;
+                            readonly maxVolume: 10000;
+                            readonly minDifficulty: 0;
+                            readonly maxDifficulty: 60;
+                        };
+                        readonly evidence: {
+                            readonly _tag: 'live';
+                            readonly provider: 'dataforseo';
+                            readonly spend: {
+                                readonly key: 'dataforseo';
+                                readonly units: 1;
+                            };
+                        };
+                    };
+                    readonly meta: {
+                        readonly requestId: 'req_01JXYZ';
+                        readonly version: '1.0';
+                    };
+                };
+            };
+        }];
+    };
+};
+export declare const serpResearchOperation: {
+    readonly id: 'research.serp';
+    readonly method: 'GET';
+    readonly path: '/api/v1/sites/{siteId}/research/serp';
+    readonly visibility: 'public';
+    readonly semantics: {
+        readonly kind: 'query';
+        readonly sideEffects: 'none';
+        readonly retry: 'idempotent';
+        readonly readConsistency: 'primary';
+    };
+    readonly auth: {
+        readonly credentials: readonly ['session', 'api_token'];
+        readonly scopes: readonly ['research:read'];
+        readonly minimumRole: 'viewer';
+        readonly ownership: 'site';
+    };
+    readonly request: {
+        readonly params: z.ZodObject<{
+            siteId: z.ZodString;
+        }, z.core.$strict>;
+        readonly query: z.ZodObject<{
+            keyword: z.ZodString;
+            depth: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+            locationCode: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        }, z.core.$strict>;
+        readonly headers: null;
+        readonly body: null;
+    };
+    readonly responses: {
+        readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+                readonly keyword: z.ZodString;
+                readonly depth: z.ZodNumber;
+                readonly results: z.ZodArray<z.ZodObject<{
+                    readonly position: z.ZodNumber;
+                    readonly url: z.ZodString;
+                    readonly title: z.ZodString;
+                    readonly domain: z.ZodString;
+                    readonly description: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                readonly serpFeatures: z.ZodArray<z.ZodString>;
+                readonly hasAiOverview: z.ZodBoolean;
+                readonly hasFeaturedSnippet: z.ZodBoolean;
+                readonly hasLocalPack: z.ZodBoolean;
+                readonly hasPeopleAlsoAsk: z.ZodBoolean;
+                readonly fetchedAt: z.ZodString;
+                readonly cached: z.ZodBoolean;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+                requestId: z.ZodString;
+                version: z.ZodLiteral<"1.0">;
+            }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+            data: z.ZodObject<{
+                readonly keyword: z.ZodString;
+                readonly depth: z.ZodNumber;
+                readonly results: z.ZodArray<z.ZodObject<{
+                    readonly position: z.ZodNumber;
+                    readonly url: z.ZodString;
+                    readonly title: z.ZodString;
+                    readonly domain: z.ZodString;
+                    readonly description: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                readonly serpFeatures: z.ZodArray<z.ZodString>;
+                readonly hasAiOverview: z.ZodBoolean;
+                readonly hasFeaturedSnippet: z.ZodBoolean;
+                readonly hasLocalPack: z.ZodBoolean;
+                readonly hasPeopleAlsoAsk: z.ZodBoolean;
+                readonly fetchedAt: z.ZodString;
+                readonly cached: z.ZodBoolean;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+                requestId: z.ZodString;
+                version: z.ZodLiteral<"1.0">;
+            }, z.core.$loose>;
+        }, z.core.$strip>>;
+    };
+    readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "not_found", "entitlement_required", "quota_exhausted", "provider_unavailable", "conflict", "rate_limited", "contract_violation", "internal_error"];
+    readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+        readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+                auth_expired: "auth_expired";
+                conflict: "conflict";
+                contract_violation: "contract_violation";
+                entitlement_required: "entitlement_required";
+                forbidden: "forbidden";
+                internal_error: "internal_error";
+                invalid_request: "invalid_request";
+                not_found: "not_found";
+                provider_unavailable: "provider_unavailable";
+                quota_exhausted: "quota_exhausted";
+                rate_limited: "rate_limited";
+                site_ambiguous: "site_ambiguous";
+                stale_evidence: "stale_evidence";
+                unauthorized: "unauthorized";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strict>;
+    }, z.core.$strip>, z.ZodObject<{
+        readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+                auth_expired: "auth_expired";
+                conflict: "conflict";
+                contract_violation: "contract_violation";
+                entitlement_required: "entitlement_required";
+                forbidden: "forbidden";
+                internal_error: "internal_error";
+                invalid_request: "invalid_request";
+                not_found: "not_found";
+                provider_unavailable: "provider_unavailable";
+                quota_exhausted: "quota_exhausted";
+                rate_limited: "rate_limited";
+                site_ambiguous: "site_ambiguous";
+                stale_evidence: "stale_evidence";
+                unauthorized: "unauthorized";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$loose>;
+    }, z.core.$strip>>;
+    readonly resources: {
+        readonly reads: readonly [{
+            readonly type: 'site.research';
+            readonly idFrom: 'params.siteId';
+        }];
+        readonly changes: readonly [];
+    };
+    readonly policy: {
+        readonly rate: {
+            readonly name: 'public-v1-fixed-window';
+            readonly limit: 50;
+            readonly windowSeconds: 60;
+        };
+        readonly idempotency: {
+            readonly _tag: 'none';
+        };
+        readonly entitlement: 'growth';
+        readonly meter: {
+            readonly key: 'dataforseo';
+            readonly units: 1;
+            readonly charge: 'live-only';
+        };
+    };
+    readonly lifecycle: {
+        readonly introduced: '1.0.0';
+    };
+    readonly docs: {
+        readonly summary: 'Analyze a Google SERP';
+        readonly description: 'Returns one dated SERP snapshot and its result features. Cached reads consume no units.';
+        readonly tags: readonly ["Research"];
+        readonly examples: readonly [{
+            readonly request: {
+                readonly params: {
+                    readonly siteId: 'site_01JXYZ';
+                };
+                readonly query: {
+                    readonly keyword: 'nuxt seo';
+                    readonly depth: 10;
+                };
+            };
+            readonly response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly keyword: 'nuxt seo';
+                        readonly depth: 10;
+                        readonly results: readonly [];
+                        readonly serpFeatures: readonly [];
+                        readonly hasAiOverview: false;
+                        readonly hasFeaturedSnippet: false;
+                        readonly hasLocalPack: false;
+                        readonly hasPeopleAlsoAsk: false;
+                        readonly fetchedAt: '2026-08-20T00:00:00.000Z';
+                        readonly cached: false;
+                    };
+                    readonly meta: {
+                        readonly requestId: 'req_01JXYZ';
+                        readonly version: '1.0';
+                    };
+                };
+            };
+        }];
+    };
+};
+export declare const rankingsResearchOperation: {
+    readonly id: 'research.rankings';
+    readonly method: 'GET';
+    readonly path: '/api/v1/sites/{siteId}/research/rankings';
+    readonly visibility: 'public';
+    readonly semantics: {
+        readonly kind: 'query';
+        readonly sideEffects: 'none';
+        readonly retry: 'idempotent';
+        readonly readConsistency: 'primary';
+    };
+    readonly auth: {
+        readonly credentials: readonly ['session', 'api_token'];
+        readonly scopes: readonly ['research:read'];
+        readonly minimumRole: 'viewer';
+        readonly ownership: 'site';
+    };
+    readonly request: {
+        readonly params: z.ZodObject<{
+            siteId: z.ZodString;
+        }, z.core.$strict>;
+        readonly query: z.ZodObject<{
+            domain: z.ZodString;
+            limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+            minPosition: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+            maxPosition: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+            locationCode: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+            order: z.ZodDefault<z.ZodEnum<{
+                position: "position";
+                traffic: "traffic";
+            }>>;
+        }, z.core.$strict>;
+        readonly headers: null;
+        readonly body: null;
+    };
+    readonly responses: {
+        readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+                readonly domain: z.ZodString;
+                readonly keywords: z.ZodArray<z.ZodObject<{
+                    readonly keyword: z.ZodString;
+                    readonly position: z.ZodNumber;
+                    readonly volume: z.ZodNumber;
+                    readonly traffic: z.ZodNumber;
+                    readonly url: z.ZodString;
+                    readonly intent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>;
+                readonly totalFound: z.ZodNumber;
+                readonly metrics: z.ZodNullable<z.ZodObject<{
+                    readonly organicTraffic: z.ZodNumber;
+                    readonly totalKeywords: z.ZodNumber;
+                    readonly keywordFootprint: z.ZodObject<{
+                        score: z.ZodNullable<z.ZodNumber>;
+                        scale: z.ZodObject<{
+                            min: z.ZodLiteral<0>;
+                            max: z.ZodLiteral<100>;
+                        }, z.core.$strict>;
+                        provenance: z.ZodLiteral<"local-keyword-count">;
+                    }, z.core.$strict>;
+                    readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                    readonly topPages: z.ZodArray<z.ZodObject<{
+                        readonly path: z.ZodString;
+                        readonly traffic: z.ZodNumber;
+                        readonly keywords: z.ZodNumber;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+                readonly positionRange: z.ZodOptional<z.ZodObject<{
+                    min: z.ZodNumber;
+                    max: z.ZodNumber;
+                }, z.core.$strict>>;
+                readonly message: z.ZodOptional<z.ZodString>;
+                readonly cached: z.ZodBoolean;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+                requestId: z.ZodString;
+                version: z.ZodLiteral<"1.0">;
+            }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+            data: z.ZodObject<{
+                readonly domain: z.ZodString;
+                readonly keywords: z.ZodArray<z.ZodObject<{
+                    readonly keyword: z.ZodString;
+                    readonly position: z.ZodNumber;
+                    readonly volume: z.ZodNumber;
+                    readonly traffic: z.ZodNumber;
+                    readonly url: z.ZodString;
+                    readonly intent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>;
+                readonly totalFound: z.ZodNumber;
+                readonly metrics: z.ZodNullable<z.ZodObject<{
+                    readonly organicTraffic: z.ZodNumber;
+                    readonly totalKeywords: z.ZodNumber;
+                    readonly keywordFootprint: z.ZodObject<{
+                        score: z.ZodNullable<z.ZodNumber>;
+                        scale: z.ZodObject<{
+                            min: z.ZodLiteral<0>;
+                            max: z.ZodLiteral<100>;
+                        }, z.core.$loose>;
+                        provenance: z.ZodLiteral<"local-keyword-count">;
+                    }, z.core.$loose>;
+                    readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                    readonly topPages: z.ZodArray<z.ZodObject<{
+                        readonly path: z.ZodString;
+                        readonly traffic: z.ZodNumber;
+                        readonly keywords: z.ZodNumber;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+                readonly positionRange: z.ZodOptional<z.ZodObject<{
+                    min: z.ZodNumber;
+                    max: z.ZodNumber;
+                }, z.core.$loose>>;
+                readonly message: z.ZodOptional<z.ZodString>;
+                readonly cached: z.ZodBoolean;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+                requestId: z.ZodString;
+                version: z.ZodLiteral<"1.0">;
+            }, z.core.$loose>;
+        }, z.core.$strip>>;
+    };
+    readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "not_found", "entitlement_required", "quota_exhausted", "provider_unavailable", "conflict", "rate_limited", "contract_violation", "internal_error"];
+    readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+        readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+                auth_expired: "auth_expired";
+                conflict: "conflict";
+                contract_violation: "contract_violation";
+                entitlement_required: "entitlement_required";
+                forbidden: "forbidden";
+                internal_error: "internal_error";
+                invalid_request: "invalid_request";
+                not_found: "not_found";
+                provider_unavailable: "provider_unavailable";
+                quota_exhausted: "quota_exhausted";
+                rate_limited: "rate_limited";
+                site_ambiguous: "site_ambiguous";
+                stale_evidence: "stale_evidence";
+                unauthorized: "unauthorized";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strict>;
+    }, z.core.$strip>, z.ZodObject<{
+        readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+                auth_expired: "auth_expired";
+                conflict: "conflict";
+                contract_violation: "contract_violation";
+                entitlement_required: "entitlement_required";
+                forbidden: "forbidden";
+                internal_error: "internal_error";
+                invalid_request: "invalid_request";
+                not_found: "not_found";
+                provider_unavailable: "provider_unavailable";
+                quota_exhausted: "quota_exhausted";
+                rate_limited: "rate_limited";
+                site_ambiguous: "site_ambiguous";
+                stale_evidence: "stale_evidence";
+                unauthorized: "unauthorized";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$loose>;
+    }, z.core.$strip>>;
+    readonly resources: {
+        readonly reads: readonly [{
+            readonly type: 'site.research';
+            readonly idFrom: 'params.siteId';
+        }];
+        readonly changes: readonly [];
+    };
+    readonly policy: {
+        readonly rate: {
+            readonly name: 'public-v1-fixed-window';
+            readonly limit: 50;
+            readonly windowSeconds: 60;
+        };
+        readonly idempotency: {
+            readonly _tag: 'none';
+        };
+        readonly entitlement: 'growth';
+        readonly meter: {
+            readonly key: 'dataforseo';
+            readonly units: 1;
+            readonly charge: 'live-only';
+        };
+    };
+    readonly lifecycle: {
+        readonly introduced: '1.0.0';
+    };
+    readonly docs: {
+        readonly summary: 'Research domain rankings';
+        readonly description: 'Returns current keyword rankings and domain metrics. Cached reads consume no units.';
+        readonly tags: readonly ["Research"];
+        readonly examples: readonly [{
+            readonly request: {
+                readonly params: {
+                    readonly siteId: 'site_01JXYZ';
+                };
+                readonly query: {
+                    readonly domain: 'nuxtseo.com';
+                    readonly limit: 20;
+                };
+            };
+            readonly response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly domain: 'nuxtseo.com';
+                        readonly keywords: readonly [];
+                        readonly totalFound: 0;
+                        readonly metrics: null;
+                        readonly positionRange: {
+                            readonly min: 1;
+                            readonly max: 20;
+                        };
+                        readonly cached: false;
+                    };
+                    readonly meta: {
+                        readonly requestId: 'req_01JXYZ';
+                        readonly version: '1.0';
+                    };
+                };
+            };
+        }];
+    };
+};
+export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
+    readonly overview: {
+        readonly id: 'research.overview';
+        readonly method: 'GET';
+        readonly path: '/api/v1/sites/{siteId}/research';
+        readonly visibility: 'public';
+        readonly semantics: {
+            readonly kind: 'query';
+            readonly sideEffects: 'none';
+            readonly retry: 'idempotent';
+            readonly readConsistency: 'primary';
+        };
+        readonly auth: {
+            readonly credentials: readonly ["session", "api_token"];
+            readonly scopes: readonly ["research:read"];
+            readonly minimumRole: 'viewer';
+            readonly ownership: 'site';
+        };
+        readonly request: {
+            readonly params: z.ZodObject<{
+                siteId: z.ZodString;
+            }, z.core.$strict>;
+            readonly query: null;
+            readonly headers: null;
+            readonly body: null;
+        };
+        readonly responses: {
+            readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly evidence: z.ZodObject<{
+                        _tag: z.ZodLiteral<"stored">;
+                        provider: z.ZodLiteral<"dataforseo">;
+                        collectedAt: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strict>;
+                    readonly summary: z.ZodObject<{
+                        competitorCount: z.ZodNumber;
+                        quickWins: z.ZodNumber;
+                        totalSharedKeywords: z.ZodNumber;
+                        totalTrafficValue: z.ZodNumber;
+                    }, z.core.$strict>;
+                    readonly subject: z.ZodNullable<z.ZodObject<{
+                        readonly domain: z.ZodString;
+                        readonly metrics: z.ZodObject<{
+                            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                        }, z.core.$strip>;
+                        readonly history: z.ZodArray<z.ZodObject<{
+                            readonly observedAt: z.ZodNullable<z.ZodString>;
+                            readonly metrics: z.ZodObject<{
+                                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                            }, z.core.$strip>;
+                        }, z.core.$strip>>;
+                        readonly collectedAt: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                    readonly competitors: z.ZodArray<z.ZodObject<{
+                        readonly domain: z.ZodString;
+                        readonly discovery: z.ZodEnum<{
+                            automatic: "automatic";
+                            manual: "manual";
+                            unknown: "unknown";
+                        }>;
+                        readonly metrics: z.ZodObject<{
+                            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                        }, z.core.$strip>;
+                        readonly topKeywords: z.ZodArray<z.ZodObject<{
+                            readonly keyword: z.ZodString;
+                            readonly position: z.ZodNullable<z.ZodNumber>;
+                            readonly volume: z.ZodNullable<z.ZodNumber>;
+                            readonly traffic: z.ZodNullable<z.ZodNumber>;
+                            readonly url: z.ZodNullable<z.ZodString>;
+                            readonly intent: z.ZodNullable<z.ZodString>;
+                        }, z.core.$strip>>;
+                        readonly sharedKeywords: z.ZodArray<z.ZodObject<{
+                            readonly keyword: z.ZodString;
+                            readonly yourPosition: z.ZodNumber;
+                            readonly theirPosition: z.ZodNumber;
+                            readonly volume: z.ZodNumber;
+                        }, z.core.$strip>>;
+                        readonly keywordGaps: z.ZodArray<z.ZodObject<{
+                            readonly keyword: z.ZodString;
+                            readonly position: z.ZodNullable<z.ZodNumber>;
+                            readonly volume: z.ZodNullable<z.ZodNumber>;
+                            readonly traffic: z.ZodNullable<z.ZodNumber>;
+                            readonly url: z.ZodNullable<z.ZodString>;
+                            readonly intent: z.ZodNullable<z.ZodString>;
+                        }, z.core.$strip>>;
+                        readonly quickWins: z.ZodArray<z.ZodObject<{
+                            readonly keyword: z.ZodString;
+                            readonly yourPosition: z.ZodNumber;
+                            readonly theirPosition: z.ZodNumber;
+                            readonly volume: z.ZodNumber;
+                        }, z.core.$strip>>;
+                        readonly history: z.ZodArray<z.ZodObject<{
+                            readonly observedAt: z.ZodNullable<z.ZodString>;
+                            readonly metrics: z.ZodObject<{
+                                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                            }, z.core.$strip>;
+                        }, z.core.$strip>>;
+                        readonly collectedAt: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>;
+                meta: z.ZodObject<{
+                    requestId: z.ZodString;
+                    version: z.ZodLiteral<"1.0">;
+                }, z.core.$strict>;
+            }, z.core.$strip>, z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly evidence: z.ZodObject<{
+                        _tag: z.ZodLiteral<"stored">;
+                        provider: z.ZodLiteral<"dataforseo">;
+                        collectedAt: z.ZodNullable<z.ZodString>;
+                    }, z.core.$loose>;
+                    readonly summary: z.ZodObject<{
+                        competitorCount: z.ZodNumber;
+                        quickWins: z.ZodNumber;
+                        totalSharedKeywords: z.ZodNumber;
+                        totalTrafficValue: z.ZodNumber;
+                    }, z.core.$loose>;
+                    readonly subject: z.ZodNullable<z.ZodObject<{
+                        readonly domain: z.ZodString;
+                        readonly metrics: z.ZodObject<{
+                            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                        }, z.core.$strip>;
+                        readonly history: z.ZodArray<z.ZodObject<{
+                            readonly observedAt: z.ZodNullable<z.ZodString>;
+                            readonly metrics: z.ZodObject<{
+                                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                            }, z.core.$strip>;
+                        }, z.core.$strip>>;
+                        readonly collectedAt: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                    readonly competitors: z.ZodArray<z.ZodObject<{
+                        readonly domain: z.ZodString;
+                        readonly discovery: z.ZodEnum<{
+                            automatic: "automatic";
+                            manual: "manual";
+                            unknown: "unknown";
+                        }>;
+                        readonly metrics: z.ZodObject<{
+                            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
                             readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
                             readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
                             readonly trafficValue: z.ZodNullable<z.ZodNumber>;
@@ -942,31 +2334,509 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
                             readonly theirPosition: z.ZodNumber;
                             readonly volume: z.ZodNumber;
                         }, z.core.$strip>>;
-                        readonly keywordGaps: z.ZodArray<z.ZodObject<{
-                            readonly keyword: z.ZodString;
-                            readonly position: z.ZodNullable<z.ZodNumber>;
-                            readonly volume: z.ZodNullable<z.ZodNumber>;
-                            readonly traffic: z.ZodNullable<z.ZodNumber>;
-                            readonly url: z.ZodNullable<z.ZodString>;
-                            readonly intent: z.ZodNullable<z.ZodString>;
-                        }, z.core.$strip>>;
-                        readonly quickWins: z.ZodArray<z.ZodObject<{
-                            readonly keyword: z.ZodString;
-                            readonly yourPosition: z.ZodNumber;
-                            readonly theirPosition: z.ZodNumber;
+                        readonly keywordGaps: z.ZodArray<z.ZodObject<{
+                            readonly keyword: z.ZodString;
+                            readonly position: z.ZodNullable<z.ZodNumber>;
+                            readonly volume: z.ZodNullable<z.ZodNumber>;
+                            readonly traffic: z.ZodNullable<z.ZodNumber>;
+                            readonly url: z.ZodNullable<z.ZodString>;
+                            readonly intent: z.ZodNullable<z.ZodString>;
+                        }, z.core.$strip>>;
+                        readonly quickWins: z.ZodArray<z.ZodObject<{
+                            readonly keyword: z.ZodString;
+                            readonly yourPosition: z.ZodNumber;
+                            readonly theirPosition: z.ZodNumber;
+                            readonly volume: z.ZodNumber;
+                        }, z.core.$strip>>;
+                        readonly history: z.ZodArray<z.ZodObject<{
+                            readonly observedAt: z.ZodNullable<z.ZodString>;
+                            readonly metrics: z.ZodObject<{
+                                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
+                                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
+                                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
+                                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                            }, z.core.$strip>;
+                        }, z.core.$strip>>;
+                        readonly collectedAt: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>;
+                meta: z.ZodObject<{
+                    requestId: z.ZodString;
+                    version: z.ZodLiteral<"1.0">;
+                }, z.core.$loose>;
+            }, z.core.$strip>>;
+        };
+        readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "not_found", "rate_limited", "contract_violation", "internal_error"];
+        readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            readonly error: z.ZodObject<{
+                code: z.ZodEnum<{
+                    auth_expired: "auth_expired";
+                    conflict: "conflict";
+                    contract_violation: "contract_violation";
+                    entitlement_required: "entitlement_required";
+                    forbidden: "forbidden";
+                    internal_error: "internal_error";
+                    invalid_request: "invalid_request";
+                    not_found: "not_found";
+                    provider_unavailable: "provider_unavailable";
+                    quota_exhausted: "quota_exhausted";
+                    rate_limited: "rate_limited";
+                    site_ambiguous: "site_ambiguous";
+                    stale_evidence: "stale_evidence";
+                    unauthorized: "unauthorized";
+                }>;
+                message: z.ZodString;
+                requestId: z.ZodString;
+                retryable: z.ZodBoolean;
+                details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+            readonly error: z.ZodObject<{
+                code: z.ZodEnum<{
+                    auth_expired: "auth_expired";
+                    conflict: "conflict";
+                    contract_violation: "contract_violation";
+                    entitlement_required: "entitlement_required";
+                    forbidden: "forbidden";
+                    internal_error: "internal_error";
+                    invalid_request: "invalid_request";
+                    not_found: "not_found";
+                    provider_unavailable: "provider_unavailable";
+                    quota_exhausted: "quota_exhausted";
+                    rate_limited: "rate_limited";
+                    site_ambiguous: "site_ambiguous";
+                    stale_evidence: "stale_evidence";
+                    unauthorized: "unauthorized";
+                }>;
+                message: z.ZodString;
+                requestId: z.ZodString;
+                retryable: z.ZodBoolean;
+                details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$loose>;
+        }, z.core.$strip>>;
+        readonly resources: {
+            readonly reads: readonly [{
+                readonly type: 'site.research';
+                readonly idFrom: 'params.siteId';
+            }];
+            readonly changes: readonly [];
+        };
+        readonly policy: {
+            readonly rate: {
+                readonly name: 'public-v1-fixed-window';
+                readonly limit: 50;
+                readonly windowSeconds: 60;
+            };
+            readonly idempotency: {
+                readonly _tag: 'none';
+            };
+            readonly entitlement: null;
+            readonly meter: null;
+        };
+        readonly lifecycle: {
+            readonly introduced: '1.0.0';
+        };
+        readonly docs: {
+            readonly summary: 'Get stored Site Research';
+            readonly description: 'Returns retained competitor and keyword-gap evidence already collected for the Site. It never starts provider work and does not consume metered units.';
+            readonly tags: readonly ["Research"];
+            readonly examples: readonly [{
+                readonly request: {
+                    readonly params: {
+                        readonly siteId: 'site_01JXYZ';
+                    };
+                };
+                readonly response: {
+                    readonly status: 200;
+                    readonly body: {
+                        readonly data: {
+                            readonly evidence: {
+                                readonly _tag: 'stored';
+                                readonly provider: 'dataforseo';
+                                readonly collectedAt: null;
+                            };
+                            readonly summary: {
+                                readonly competitorCount: 0;
+                                readonly quickWins: 0;
+                                readonly totalSharedKeywords: 0;
+                                readonly totalTrafficValue: 0;
+                            };
+                            readonly subject: null;
+                            readonly competitors: readonly [];
+                        };
+                        readonly meta: {
+                            readonly requestId: 'req_01JXYZ';
+                            readonly version: '1.0';
+                        };
+                    };
+                };
+            }];
+        };
+    };
+    readonly keywords: {
+        readonly id: 'research.keywords';
+        readonly method: 'GET';
+        readonly path: '/api/v1/sites/{siteId}/research/keywords';
+        readonly visibility: 'public';
+        readonly semantics: {
+            readonly kind: 'query';
+            readonly sideEffects: 'none';
+            readonly retry: 'idempotent';
+            readonly readConsistency: 'primary';
+        };
+        readonly auth: {
+            readonly credentials: readonly ['session', 'api_token'];
+            readonly scopes: readonly ['research:read'];
+            readonly minimumRole: 'viewer';
+            readonly ownership: 'site';
+        };
+        readonly request: {
+            readonly params: z.ZodObject<{
+                siteId: z.ZodString;
+            }, z.core.$strict>;
+            readonly query: z.ZodObject<{
+                topic: z.ZodString;
+                minVolume: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+                maxVolume: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+                minDifficulty: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+                maxDifficulty: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+                intent: z.ZodOptional<z.ZodString>;
+                includeRelated: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+                    0: "0";
+                    1: "1";
+                    false: "false";
+                    true: "true";
+                }>]>, z.ZodTransform<boolean, "0" | "1" | "false" | "true" | boolean>>>;
+                verbose: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+                    0: "0";
+                    1: "1";
+                    false: "false";
+                    true: "true";
+                }>]>, z.ZodTransform<boolean, "0" | "1" | "false" | "true" | boolean>>>;
+                limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+                locationCode: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+            }, z.core.$strict>;
+            readonly headers: null;
+            readonly body: null;
+        };
+        readonly responses: {
+            readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly topic: z.ZodString;
+                    readonly keywords: z.ZodArray<z.ZodObject<{
+                        readonly keyword: z.ZodString;
+                        readonly volume: z.ZodNullable<z.ZodNumber>;
+                        readonly difficulty: z.ZodNullable<z.ZodNumber>;
+                        readonly intent: z.ZodNullable<z.ZodString>;
+                        readonly secondaryIntents: z.ZodNullable<z.ZodArray<z.ZodString>>;
+                        readonly cpc: z.ZodNullable<z.ZodNumber>;
+                        readonly competition: z.ZodNullable<z.ZodNumber>;
+                        readonly competitionLevel: z.ZodNullable<z.ZodEnum<{
+                            HIGH: "HIGH";
+                            LOW: "LOW";
+                            MEDIUM: "MEDIUM";
+                        }>>;
+                        readonly lowBid: z.ZodNullable<z.ZodNumber>;
+                        readonly highBid: z.ZodNullable<z.ZodNumber>;
+                        readonly trend: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                            readonly year: z.ZodNumber;
+                            readonly month: z.ZodNumber;
+                            readonly volume: z.ZodNumber;
+                        }, z.core.$strip>>>;
+                        readonly serpFeatures: z.ZodNullable<z.ZodArray<z.ZodString>>;
+                        readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                        readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+                    }, z.core.$strip>>;
+                    readonly totalFound: z.ZodNumber;
+                    readonly filters: z.ZodObject<{
+                        minVolume: z.ZodNumber;
+                        maxVolume: z.ZodNumber;
+                        minDifficulty: z.ZodNumber;
+                        maxDifficulty: z.ZodNumber;
+                        intent: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>;
+                    readonly message: z.ZodOptional<z.ZodString>;
+                    readonly tip: z.ZodOptional<z.ZodString>;
+                    readonly serpFallback: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                        message: z.ZodString;
+                        topResults: z.ZodArray<z.ZodObject<{
+                            readonly position: z.ZodNumber;
+                            readonly title: z.ZodString;
+                            readonly domain: z.ZodString;
+                            readonly url: z.ZodString;
+                        }, z.core.$strip>>;
+                        tip: z.ZodString;
+                    }, z.core.$strict>>>;
+                    readonly evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        _tag: z.ZodLiteral<"no-provider">;
+                        provider: z.ZodNull;
+                        spend: z.ZodObject<{
+                            key: z.ZodLiteral<"dataforseo">;
+                            units: z.ZodLiteral<0>;
+                        }, z.core.$strict>;
+                    }, z.core.$strict>, z.ZodObject<{
+                        _tag: z.ZodLiteral<"cache">;
+                        provider: z.ZodLiteral<"dataforseo">;
+                        spend: z.ZodObject<{
+                            key: z.ZodLiteral<"dataforseo">;
+                            units: z.ZodLiteral<0>;
+                        }, z.core.$strict>;
+                    }, z.core.$strict>, z.ZodObject<{
+                        _tag: z.ZodLiteral<"live">;
+                        provider: z.ZodLiteral<"dataforseo">;
+                        spend: z.ZodObject<{
+                            key: z.ZodLiteral<"dataforseo">;
+                            units: z.ZodLiteral<1>;
+                        }, z.core.$strict>;
+                    }, z.core.$strict>], "_tag">;
+                }, z.core.$strip>;
+                meta: z.ZodObject<{
+                    requestId: z.ZodString;
+                    version: z.ZodLiteral<"1.0">;
+                }, z.core.$strict>;
+            }, z.core.$strip>, z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly topic: z.ZodString;
+                    readonly keywords: z.ZodArray<z.ZodObject<{
+                        readonly keyword: z.ZodString;
+                        readonly volume: z.ZodNullable<z.ZodNumber>;
+                        readonly difficulty: z.ZodNullable<z.ZodNumber>;
+                        readonly intent: z.ZodNullable<z.ZodString>;
+                        readonly secondaryIntents: z.ZodNullable<z.ZodArray<z.ZodString>>;
+                        readonly cpc: z.ZodNullable<z.ZodNumber>;
+                        readonly competition: z.ZodNullable<z.ZodNumber>;
+                        readonly competitionLevel: z.ZodNullable<z.ZodEnum<{
+                            HIGH: "HIGH";
+                            LOW: "LOW";
+                            MEDIUM: "MEDIUM";
+                        }>>;
+                        readonly lowBid: z.ZodNullable<z.ZodNumber>;
+                        readonly highBid: z.ZodNullable<z.ZodNumber>;
+                        readonly trend: z.ZodNullable<z.ZodArray<z.ZodObject<{
+                            readonly year: z.ZodNumber;
+                            readonly month: z.ZodNumber;
                             readonly volume: z.ZodNumber;
+                        }, z.core.$strip>>>;
+                        readonly serpFeatures: z.ZodNullable<z.ZodArray<z.ZodString>>;
+                        readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                        readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+                    }, z.core.$strip>>;
+                    readonly totalFound: z.ZodNumber;
+                    readonly filters: z.ZodObject<{
+                        minVolume: z.ZodNumber;
+                        maxVolume: z.ZodNumber;
+                        minDifficulty: z.ZodNumber;
+                        maxDifficulty: z.ZodNumber;
+                        intent: z.ZodOptional<z.ZodString>;
+                    }, z.core.$loose>;
+                    readonly message: z.ZodOptional<z.ZodString>;
+                    readonly tip: z.ZodOptional<z.ZodString>;
+                    readonly serpFallback: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                        message: z.ZodString;
+                        topResults: z.ZodArray<z.ZodObject<{
+                            readonly position: z.ZodNumber;
+                            readonly title: z.ZodString;
+                            readonly domain: z.ZodString;
+                            readonly url: z.ZodString;
                         }, z.core.$strip>>;
-                        readonly history: z.ZodArray<z.ZodObject<{
-                            readonly observedAt: z.ZodNullable<z.ZodString>;
-                            readonly metrics: z.ZodObject<{
-                                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
-                                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
-                                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
-                                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
-                            }, z.core.$strip>;
-                        }, z.core.$strip>>;
-                        readonly collectedAt: z.ZodNullable<z.ZodString>;
+                        tip: z.ZodString;
+                    }, z.core.$loose>>>;
+                    readonly evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        _tag: z.ZodLiteral<"no-provider">;
+                        provider: z.ZodNull;
+                        spend: z.ZodObject<{
+                            key: z.ZodLiteral<"dataforseo">;
+                            units: z.ZodLiteral<0>;
+                        }, z.core.$loose>;
+                    }, z.core.$loose>, z.ZodObject<{
+                        _tag: z.ZodLiteral<"cache">;
+                        provider: z.ZodLiteral<"dataforseo">;
+                        spend: z.ZodObject<{
+                            key: z.ZodLiteral<"dataforseo">;
+                            units: z.ZodLiteral<0>;
+                        }, z.core.$loose>;
+                    }, z.core.$loose>, z.ZodObject<{
+                        _tag: z.ZodLiteral<"live">;
+                        provider: z.ZodLiteral<"dataforseo">;
+                        spend: z.ZodObject<{
+                            key: z.ZodLiteral<"dataforseo">;
+                            units: z.ZodLiteral<1>;
+                        }, z.core.$loose>;
+                    }, z.core.$loose>], "_tag">;
+                }, z.core.$strip>;
+                meta: z.ZodObject<{
+                    requestId: z.ZodString;
+                    version: z.ZodLiteral<"1.0">;
+                }, z.core.$loose>;
+            }, z.core.$strip>>;
+        };
+        readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "not_found", "entitlement_required", "quota_exhausted", "provider_unavailable", "conflict", "rate_limited", "contract_violation", "internal_error"];
+        readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            readonly error: z.ZodObject<{
+                code: z.ZodEnum<{
+                    auth_expired: "auth_expired";
+                    conflict: "conflict";
+                    contract_violation: "contract_violation";
+                    entitlement_required: "entitlement_required";
+                    forbidden: "forbidden";
+                    internal_error: "internal_error";
+                    invalid_request: "invalid_request";
+                    not_found: "not_found";
+                    provider_unavailable: "provider_unavailable";
+                    quota_exhausted: "quota_exhausted";
+                    rate_limited: "rate_limited";
+                    site_ambiguous: "site_ambiguous";
+                    stale_evidence: "stale_evidence";
+                    unauthorized: "unauthorized";
+                }>;
+                message: z.ZodString;
+                requestId: z.ZodString;
+                retryable: z.ZodBoolean;
+                details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+            readonly error: z.ZodObject<{
+                code: z.ZodEnum<{
+                    auth_expired: "auth_expired";
+                    conflict: "conflict";
+                    contract_violation: "contract_violation";
+                    entitlement_required: "entitlement_required";
+                    forbidden: "forbidden";
+                    internal_error: "internal_error";
+                    invalid_request: "invalid_request";
+                    not_found: "not_found";
+                    provider_unavailable: "provider_unavailable";
+                    quota_exhausted: "quota_exhausted";
+                    rate_limited: "rate_limited";
+                    site_ambiguous: "site_ambiguous";
+                    stale_evidence: "stale_evidence";
+                    unauthorized: "unauthorized";
+                }>;
+                message: z.ZodString;
+                requestId: z.ZodString;
+                retryable: z.ZodBoolean;
+                details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$loose>;
+        }, z.core.$strip>>;
+        readonly resources: {
+            readonly reads: readonly [{
+                readonly type: 'site.research';
+                readonly idFrom: 'params.siteId';
+            }];
+            readonly changes: readonly [];
+        };
+        readonly policy: {
+            readonly rate: {
+                readonly name: 'public-v1-fixed-window';
+                readonly limit: 50;
+                readonly windowSeconds: 60;
+            };
+            readonly idempotency: {
+                readonly _tag: 'none';
+            };
+            readonly entitlement: 'growth';
+            readonly meter: {
+                readonly key: 'dataforseo';
+                readonly units: 1;
+                readonly charge: 'live-only';
+            };
+        };
+        readonly lifecycle: {
+            readonly introduced: '1.0.0';
+        };
+        readonly docs: {
+            readonly summary: 'Research keyword ideas';
+            readonly description: 'Returns keyword ideas with volume, difficulty, intent, cost data, and explicit provider execution and spend evidence. Local guidance and cached reads consume no units.';
+            readonly tags: readonly ["Research"];
+            readonly examples: readonly [{
+                readonly request: {
+                    readonly params: {
+                        readonly siteId: 'site_01JXYZ';
+                    };
+                    readonly query: {
+                        readonly topic: 'nuxt seo';
+                        readonly limit: 20;
+                    };
+                };
+                readonly response: {
+                    readonly status: 200;
+                    readonly body: {
+                        readonly data: {
+                            readonly topic: 'nuxt seo';
+                            readonly keywords: readonly [];
+                            readonly totalFound: 0;
+                            readonly filters: {
+                                readonly minVolume: 10;
+                                readonly maxVolume: 10000;
+                                readonly minDifficulty: 0;
+                                readonly maxDifficulty: 60;
+                            };
+                            readonly evidence: {
+                                readonly _tag: 'live';
+                                readonly provider: 'dataforseo';
+                                readonly spend: {
+                                    readonly key: 'dataforseo';
+                                    readonly units: 1;
+                                };
+                            };
+                        };
+                        readonly meta: {
+                            readonly requestId: 'req_01JXYZ';
+                            readonly version: '1.0';
+                        };
+                    };
+                };
+            }];
+        };
+    };
+    readonly serp: {
+        readonly id: 'research.serp';
+        readonly method: 'GET';
+        readonly path: '/api/v1/sites/{siteId}/research/serp';
+        readonly visibility: 'public';
+        readonly semantics: {
+            readonly kind: 'query';
+            readonly sideEffects: 'none';
+            readonly retry: 'idempotent';
+            readonly readConsistency: 'primary';
+        };
+        readonly auth: {
+            readonly credentials: readonly ['session', 'api_token'];
+            readonly scopes: readonly ['research:read'];
+            readonly minimumRole: 'viewer';
+            readonly ownership: 'site';
+        };
+        readonly request: {
+            readonly params: z.ZodObject<{
+                siteId: z.ZodString;
+            }, z.core.$strict>;
+            readonly query: z.ZodObject<{
+                keyword: z.ZodString;
+                depth: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+                locationCode: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+            }, z.core.$strict>;
+            readonly headers: null;
+            readonly body: null;
+        };
+        readonly responses: {
+            readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly keyword: z.ZodString;
+                    readonly depth: z.ZodNumber;
+                    readonly results: z.ZodArray<z.ZodObject<{
+                        readonly position: z.ZodNumber;
+                        readonly url: z.ZodString;
+                        readonly title: z.ZodString;
+                        readonly domain: z.ZodString;
+                        readonly description: z.ZodOptional<z.ZodString>;
                     }, z.core.$strip>>;
+                    readonly serpFeatures: z.ZodArray<z.ZodString>;
+                    readonly hasAiOverview: z.ZodBoolean;
+                    readonly hasFeaturedSnippet: z.ZodBoolean;
+                    readonly hasLocalPack: z.ZodBoolean;
+                    readonly hasPeopleAlsoAsk: z.ZodBoolean;
+                    readonly fetchedAt: z.ZodString;
+                    readonly cached: z.ZodBoolean;
                 }, z.core.$strip>;
                 meta: z.ZodObject<{
                     requestId: z.ZodString;
@@ -974,88 +2844,254 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
                 }, z.core.$strict>;
             }, z.core.$strip>, z.ZodObject<{
                 data: z.ZodObject<{
-                    readonly evidence: z.ZodObject<{
-                        _tag: z.ZodLiteral<"stored">;
-                        provider: z.ZodLiteral<"dataforseo">;
-                        collectedAt: z.ZodNullable<z.ZodString>;
-                    }, z.core.$loose>;
-                    readonly summary: z.ZodObject<{
-                        competitorCount: z.ZodNumber;
-                        quickWins: z.ZodNumber;
-                        totalSharedKeywords: z.ZodNumber;
-                        totalTrafficValue: z.ZodNumber;
-                    }, z.core.$loose>;
-                    readonly subject: z.ZodNullable<z.ZodObject<{
+                    readonly keyword: z.ZodString;
+                    readonly depth: z.ZodNumber;
+                    readonly results: z.ZodArray<z.ZodObject<{
+                        readonly position: z.ZodNumber;
+                        readonly url: z.ZodString;
+                        readonly title: z.ZodString;
                         readonly domain: z.ZodString;
-                        readonly metrics: z.ZodObject<{
-                            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
-                            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
-                            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
-                            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
-                        }, z.core.$strip>;
-                        readonly history: z.ZodArray<z.ZodObject<{
-                            readonly observedAt: z.ZodNullable<z.ZodString>;
-                            readonly metrics: z.ZodObject<{
-                                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
-                                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
-                                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
-                                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
-                            }, z.core.$strip>;
-                        }, z.core.$strip>>;
-                        readonly collectedAt: z.ZodNullable<z.ZodString>;
+                        readonly description: z.ZodOptional<z.ZodString>;
                     }, z.core.$strip>>;
-                    readonly competitors: z.ZodArray<z.ZodObject<{
-                        readonly domain: z.ZodString;
-                        readonly discovery: z.ZodEnum<{
-                            automatic: "automatic";
-                            manual: "manual";
-                            unknown: "unknown";
-                        }>;
-                        readonly metrics: z.ZodObject<{
-                            readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
-                            readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
-                            readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
-                            readonly trafficValue: z.ZodNullable<z.ZodNumber>;
-                        }, z.core.$strip>;
-                        readonly topKeywords: z.ZodArray<z.ZodObject<{
-                            readonly keyword: z.ZodString;
-                            readonly position: z.ZodNullable<z.ZodNumber>;
-                            readonly volume: z.ZodNullable<z.ZodNumber>;
-                            readonly traffic: z.ZodNullable<z.ZodNumber>;
-                            readonly url: z.ZodNullable<z.ZodString>;
-                            readonly intent: z.ZodNullable<z.ZodString>;
-                        }, z.core.$strip>>;
-                        readonly sharedKeywords: z.ZodArray<z.ZodObject<{
-                            readonly keyword: z.ZodString;
-                            readonly yourPosition: z.ZodNumber;
-                            readonly theirPosition: z.ZodNumber;
-                            readonly volume: z.ZodNumber;
-                        }, z.core.$strip>>;
-                        readonly keywordGaps: z.ZodArray<z.ZodObject<{
-                            readonly keyword: z.ZodString;
-                            readonly position: z.ZodNullable<z.ZodNumber>;
-                            readonly volume: z.ZodNullable<z.ZodNumber>;
-                            readonly traffic: z.ZodNullable<z.ZodNumber>;
-                            readonly url: z.ZodNullable<z.ZodString>;
-                            readonly intent: z.ZodNullable<z.ZodString>;
-                        }, z.core.$strip>>;
-                        readonly quickWins: z.ZodArray<z.ZodObject<{
-                            readonly keyword: z.ZodString;
-                            readonly yourPosition: z.ZodNumber;
-                            readonly theirPosition: z.ZodNumber;
-                            readonly volume: z.ZodNumber;
+                    readonly serpFeatures: z.ZodArray<z.ZodString>;
+                    readonly hasAiOverview: z.ZodBoolean;
+                    readonly hasFeaturedSnippet: z.ZodBoolean;
+                    readonly hasLocalPack: z.ZodBoolean;
+                    readonly hasPeopleAlsoAsk: z.ZodBoolean;
+                    readonly fetchedAt: z.ZodString;
+                    readonly cached: z.ZodBoolean;
+                }, z.core.$strip>;
+                meta: z.ZodObject<{
+                    requestId: z.ZodString;
+                    version: z.ZodLiteral<"1.0">;
+                }, z.core.$loose>;
+            }, z.core.$strip>>;
+        };
+        readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "not_found", "entitlement_required", "quota_exhausted", "provider_unavailable", "conflict", "rate_limited", "contract_violation", "internal_error"];
+        readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            readonly error: z.ZodObject<{
+                code: z.ZodEnum<{
+                    auth_expired: "auth_expired";
+                    conflict: "conflict";
+                    contract_violation: "contract_violation";
+                    entitlement_required: "entitlement_required";
+                    forbidden: "forbidden";
+                    internal_error: "internal_error";
+                    invalid_request: "invalid_request";
+                    not_found: "not_found";
+                    provider_unavailable: "provider_unavailable";
+                    quota_exhausted: "quota_exhausted";
+                    rate_limited: "rate_limited";
+                    site_ambiguous: "site_ambiguous";
+                    stale_evidence: "stale_evidence";
+                    unauthorized: "unauthorized";
+                }>;
+                message: z.ZodString;
+                requestId: z.ZodString;
+                retryable: z.ZodBoolean;
+                details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+            readonly error: z.ZodObject<{
+                code: z.ZodEnum<{
+                    auth_expired: "auth_expired";
+                    conflict: "conflict";
+                    contract_violation: "contract_violation";
+                    entitlement_required: "entitlement_required";
+                    forbidden: "forbidden";
+                    internal_error: "internal_error";
+                    invalid_request: "invalid_request";
+                    not_found: "not_found";
+                    provider_unavailable: "provider_unavailable";
+                    quota_exhausted: "quota_exhausted";
+                    rate_limited: "rate_limited";
+                    site_ambiguous: "site_ambiguous";
+                    stale_evidence: "stale_evidence";
+                    unauthorized: "unauthorized";
+                }>;
+                message: z.ZodString;
+                requestId: z.ZodString;
+                retryable: z.ZodBoolean;
+                details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$loose>;
+        }, z.core.$strip>>;
+        readonly resources: {
+            readonly reads: readonly [{
+                readonly type: 'site.research';
+                readonly idFrom: 'params.siteId';
+            }];
+            readonly changes: readonly [];
+        };
+        readonly policy: {
+            readonly rate: {
+                readonly name: 'public-v1-fixed-window';
+                readonly limit: 50;
+                readonly windowSeconds: 60;
+            };
+            readonly idempotency: {
+                readonly _tag: 'none';
+            };
+            readonly entitlement: 'growth';
+            readonly meter: {
+                readonly key: 'dataforseo';
+                readonly units: 1;
+                readonly charge: 'live-only';
+            };
+        };
+        readonly lifecycle: {
+            readonly introduced: '1.0.0';
+        };
+        readonly docs: {
+            readonly summary: 'Analyze a Google SERP';
+            readonly description: 'Returns one dated SERP snapshot and its result features. Cached reads consume no units.';
+            readonly tags: readonly ["Research"];
+            readonly examples: readonly [{
+                readonly request: {
+                    readonly params: {
+                        readonly siteId: 'site_01JXYZ';
+                    };
+                    readonly query: {
+                        readonly keyword: 'nuxt seo';
+                        readonly depth: 10;
+                    };
+                };
+                readonly response: {
+                    readonly status: 200;
+                    readonly body: {
+                        readonly data: {
+                            readonly keyword: 'nuxt seo';
+                            readonly depth: 10;
+                            readonly results: readonly [];
+                            readonly serpFeatures: readonly [];
+                            readonly hasAiOverview: false;
+                            readonly hasFeaturedSnippet: false;
+                            readonly hasLocalPack: false;
+                            readonly hasPeopleAlsoAsk: false;
+                            readonly fetchedAt: '2026-08-20T00:00:00.000Z';
+                            readonly cached: false;
+                        };
+                        readonly meta: {
+                            readonly requestId: 'req_01JXYZ';
+                            readonly version: '1.0';
+                        };
+                    };
+                };
+            }];
+        };
+    };
+    readonly rankings: {
+        readonly id: 'research.rankings';
+        readonly method: 'GET';
+        readonly path: '/api/v1/sites/{siteId}/research/rankings';
+        readonly visibility: 'public';
+        readonly semantics: {
+            readonly kind: 'query';
+            readonly sideEffects: 'none';
+            readonly retry: 'idempotent';
+            readonly readConsistency: 'primary';
+        };
+        readonly auth: {
+            readonly credentials: readonly ['session', 'api_token'];
+            readonly scopes: readonly ['research:read'];
+            readonly minimumRole: 'viewer';
+            readonly ownership: 'site';
+        };
+        readonly request: {
+            readonly params: z.ZodObject<{
+                siteId: z.ZodString;
+            }, z.core.$strict>;
+            readonly query: z.ZodObject<{
+                domain: z.ZodString;
+                limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+                minPosition: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+                maxPosition: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+                locationCode: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+                order: z.ZodDefault<z.ZodEnum<{
+                    position: "position";
+                    traffic: "traffic";
+                }>>;
+            }, z.core.$strict>;
+            readonly headers: null;
+            readonly body: null;
+        };
+        readonly responses: {
+            readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly domain: z.ZodString;
+                    readonly keywords: z.ZodArray<z.ZodObject<{
+                        readonly keyword: z.ZodString;
+                        readonly position: z.ZodNumber;
+                        readonly volume: z.ZodNumber;
+                        readonly traffic: z.ZodNumber;
+                        readonly url: z.ZodString;
+                        readonly intent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    readonly totalFound: z.ZodNumber;
+                    readonly metrics: z.ZodNullable<z.ZodObject<{
+                        readonly organicTraffic: z.ZodNumber;
+                        readonly totalKeywords: z.ZodNumber;
+                        readonly keywordFootprint: z.ZodObject<{
+                            score: z.ZodNullable<z.ZodNumber>;
+                            scale: z.ZodObject<{
+                                min: z.ZodLiteral<0>;
+                                max: z.ZodLiteral<100>;
+                            }, z.core.$strict>;
+                            provenance: z.ZodLiteral<"local-keyword-count">;
+                        }, z.core.$strict>;
+                        readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                        readonly topPages: z.ZodArray<z.ZodObject<{
+                            readonly path: z.ZodString;
+                            readonly traffic: z.ZodNumber;
+                            readonly keywords: z.ZodNumber;
                         }, z.core.$strip>>;
-                        readonly history: z.ZodArray<z.ZodObject<{
-                            readonly observedAt: z.ZodNullable<z.ZodString>;
-                            readonly metrics: z.ZodObject<{
-                                readonly organicTraffic: z.ZodNullable<z.ZodNumber>;
-                                readonly totalKeywords: z.ZodNullable<z.ZodNumber>;
-                                readonly keywordFootprint: z.ZodNullable<z.ZodNumber>;
-                                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
-                            }, z.core.$strip>;
+                    }, z.core.$strip>>;
+                    readonly positionRange: z.ZodOptional<z.ZodObject<{
+                        min: z.ZodNumber;
+                        max: z.ZodNumber;
+                    }, z.core.$strict>>;
+                    readonly message: z.ZodOptional<z.ZodString>;
+                    readonly cached: z.ZodBoolean;
+                }, z.core.$strip>;
+                meta: z.ZodObject<{
+                    requestId: z.ZodString;
+                    version: z.ZodLiteral<"1.0">;
+                }, z.core.$strict>;
+            }, z.core.$strip>, z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly domain: z.ZodString;
+                    readonly keywords: z.ZodArray<z.ZodObject<{
+                        readonly keyword: z.ZodString;
+                        readonly position: z.ZodNumber;
+                        readonly volume: z.ZodNumber;
+                        readonly traffic: z.ZodNumber;
+                        readonly url: z.ZodString;
+                        readonly intent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    readonly totalFound: z.ZodNumber;
+                    readonly metrics: z.ZodNullable<z.ZodObject<{
+                        readonly organicTraffic: z.ZodNumber;
+                        readonly totalKeywords: z.ZodNumber;
+                        readonly keywordFootprint: z.ZodObject<{
+                            score: z.ZodNullable<z.ZodNumber>;
+                            scale: z.ZodObject<{
+                                min: z.ZodLiteral<0>;
+                                max: z.ZodLiteral<100>;
+                            }, z.core.$loose>;
+                            provenance: z.ZodLiteral<"local-keyword-count">;
+                        }, z.core.$loose>;
+                        readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                        readonly topPages: z.ZodArray<z.ZodObject<{
+                            readonly path: z.ZodString;
+                            readonly traffic: z.ZodNumber;
+                            readonly keywords: z.ZodNumber;
                         }, z.core.$strip>>;
-                        readonly collectedAt: z.ZodNullable<z.ZodString>;
                     }, z.core.$strip>>;
+                    readonly positionRange: z.ZodOptional<z.ZodObject<{
+                        min: z.ZodNumber;
+                        max: z.ZodNumber;
+                    }, z.core.$loose>>;
+                    readonly message: z.ZodOptional<z.ZodString>;
+                    readonly cached: z.ZodBoolean;
                 }, z.core.$strip>;
                 meta: z.ZodObject<{
                     requestId: z.ZodString;
@@ -1063,7 +3099,7 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
                 }, z.core.$loose>;
             }, z.core.$strip>>;
         };
-        readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "not_found", "rate_limited", "contract_violation", "internal_error"];
+        readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "not_found", "entitlement_required", "quota_exhausted", "provider_unavailable", "conflict", "rate_limited", "contract_violation", "internal_error"];
         readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
             readonly error: z.ZodObject<{
                 code: z.ZodEnum<{
@@ -1127,39 +3163,43 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
             readonly idempotency: {
                 readonly _tag: 'none';
             };
-            readonly entitlement: null;
-            readonly meter: null;
+            readonly entitlement: 'growth';
+            readonly meter: {
+                readonly key: 'dataforseo';
+                readonly units: 1;
+                readonly charge: 'live-only';
+            };
         };
         readonly lifecycle: {
             readonly introduced: '1.0.0';
         };
         readonly docs: {
-            readonly summary: 'Get stored Site Research';
-            readonly description: 'Returns retained competitor and keyword-gap evidence already collected for the Site. It never starts provider work and does not consume metered units.';
+            readonly summary: 'Research domain rankings';
+            readonly description: 'Returns current keyword rankings and domain metrics. Cached reads consume no units.';
             readonly tags: readonly ["Research"];
             readonly examples: readonly [{
                 readonly request: {
                     readonly params: {
                         readonly siteId: 'site_01JXYZ';
                     };
+                    readonly query: {
+                        readonly domain: 'nuxtseo.com';
+                        readonly limit: 20;
+                    };
                 };
                 readonly response: {
                     readonly status: 200;
                     readonly body: {
                         readonly data: {
-                            readonly evidence: {
-                                readonly _tag: 'stored';
-                                readonly provider: 'dataforseo';
-                                readonly collectedAt: null;
+                            readonly domain: 'nuxtseo.com';
+                            readonly keywords: readonly [];
+                            readonly totalFound: 0;
+                            readonly metrics: null;
+                            readonly positionRange: {
+                                readonly min: 1;
+                                readonly max: 20;
                             };
-                            readonly summary: {
-                                readonly competitorCount: 0;
-                                readonly quickWins: 0;
-                                readonly totalSharedKeywords: 0;
-                                readonly totalTrafficValue: 0;
-                            };
-                            readonly subject: null;
-                            readonly competitors: readonly [];
+                            readonly cached: false;
                         };
                         readonly meta: {
                             readonly requestId: 'req_01JXYZ';
@@ -1171,3 +3211,4 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
         };
     };
 }>;
+export {};