@nuxtseo/protocol 0.1.4 → 0.2.0

package/dist/v1/research.d.ts

@@ -2159,11 +2159,1477 @@ export declare const rankingsResearchOperation: {
         }];
     };
 };
+export declare const domainTrafficQuerySchema: z.ZodObject<{
+    domain: z.ZodString;
+}, z.core.$strict>;
+export declare const domainAvailabilityQuerySchema: z.ZodObject<{
+    domains: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>;
+}, z.core.$strict>;
+export declare const domainTrafficPageSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly path: z.ZodString;
+    readonly traffic: z.ZodNumber;
+    readonly keywords: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    readonly path: z.ZodString;
+    readonly traffic: z.ZodNumber;
+    readonly keywords: z.ZodNumber;
+}, z.core.$strip>>;
+export declare const domainTrafficDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly domain: z.ZodString;
+    readonly monthlyTraffic: z.ZodNumber;
+    readonly trend: z.ZodEnum<{
+        declining: "declining";
+        growing: "growing";
+        stable: "stable";
+    }>;
+    readonly changePercent: z.ZodNumber;
+    readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+    readonly keywordFootprint: 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 topCountries: z.ZodArray<z.ZodObject<{
+        country: z.ZodString;
+        percent: z.ZodNumber;
+    }, z.core.$strict>>;
+    readonly message: z.ZodNullable<z.ZodString>;
+    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 domain: z.ZodString;
+    readonly monthlyTraffic: z.ZodNumber;
+    readonly trend: z.ZodEnum<{
+        declining: "declining";
+        growing: "growing";
+        stable: "stable";
+    }>;
+    readonly changePercent: z.ZodNumber;
+    readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+    readonly keywordFootprint: 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 topCountries: z.ZodArray<z.ZodObject<{
+        country: z.ZodString;
+        percent: z.ZodNumber;
+    }, z.core.$loose>>;
+    readonly message: z.ZodNullable<z.ZodString>;
+    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 domainTrafficResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    data: z.ZodObject<{
+        readonly domain: z.ZodString;
+        readonly monthlyTraffic: z.ZodNumber;
+        readonly trend: z.ZodEnum<{
+            declining: "declining";
+            growing: "growing";
+            stable: "stable";
+        }>;
+        readonly changePercent: z.ZodNumber;
+        readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+        readonly keywordFootprint: 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 topCountries: z.ZodArray<z.ZodObject<{
+            country: z.ZodString;
+            percent: z.ZodNumber;
+        }, z.core.$strict>>;
+        readonly message: z.ZodNullable<z.ZodString>;
+        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 domain: z.ZodString;
+        readonly monthlyTraffic: z.ZodNumber;
+        readonly trend: z.ZodEnum<{
+            declining: "declining";
+            growing: "growing";
+            stable: "stable";
+        }>;
+        readonly changePercent: z.ZodNumber;
+        readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+        readonly keywordFootprint: 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 topCountries: z.ZodArray<z.ZodObject<{
+            country: z.ZodString;
+            percent: z.ZodNumber;
+        }, z.core.$loose>>;
+        readonly message: z.ZodNullable<z.ZodString>;
+        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 type DomainTraffic = z.output<typeof domainTrafficDataSchema.producer>;
+export declare const domainTrafficOperation: {
+    readonly id: 'research.domain.traffic';
+    readonly method: 'GET';
+    readonly path: '/api/v1/sites/{siteId}/research/domain-traffic';
+    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;
+        }, 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 monthlyTraffic: z.ZodNumber;
+                readonly trend: z.ZodEnum<{
+                    declining: "declining";
+                    growing: "growing";
+                    stable: "stable";
+                }>;
+                readonly changePercent: z.ZodNumber;
+                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                readonly keywordFootprint: 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 topCountries: z.ZodArray<z.ZodObject<{
+                    country: z.ZodString;
+                    percent: z.ZodNumber;
+                }, z.core.$strict>>;
+                readonly message: z.ZodNullable<z.ZodString>;
+                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 domain: z.ZodString;
+                readonly monthlyTraffic: z.ZodNumber;
+                readonly trend: z.ZodEnum<{
+                    declining: "declining";
+                    growing: "growing";
+                    stable: "stable";
+                }>;
+                readonly changePercent: z.ZodNumber;
+                readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                readonly keywordFootprint: 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 topCountries: z.ZodArray<z.ZodObject<{
+                    country: z.ZodString;
+                    percent: z.ZodNumber;
+                }, z.core.$loose>>;
+                readonly message: z.ZodNullable<z.ZodString>;
+                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.2.0';
+    };
+    readonly docs: {
+        readonly summary: 'Estimate domain traffic';
+        readonly description: 'Returns an estimate of one domain organic search traffic, its trend, its top pages and countries. The domain does not have to be one of your Sites, so this reads a competitor as readily as your own. 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 response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly domain: 'nuxtseo.com';
+                        readonly monthlyTraffic: 48200;
+                        readonly trend: 'growing';
+                        readonly changePercent: 12.4;
+                        readonly trafficValue: 31200;
+                        readonly keywordFootprint: 62;
+                        readonly topPages: readonly [{
+                            readonly path: '/docs/sitemap';
+                            readonly traffic: 4100;
+                            readonly keywords: 220;
+                        }];
+                        readonly topCountries: readonly [{
+                            readonly country: 'US';
+                            readonly percent: 41.2;
+                        }];
+                        readonly message: null;
+                        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 domainStatusSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly domain: z.ZodString;
+    readonly available: z.ZodBoolean;
+    readonly registrar: z.ZodNullable<z.ZodString>;
+    readonly expiration: z.ZodNullable<z.ZodString>;
+    readonly created: z.ZodNullable<z.ZodString>;
+    readonly note: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    readonly domain: z.ZodString;
+    readonly available: z.ZodBoolean;
+    readonly registrar: z.ZodNullable<z.ZodString>;
+    readonly expiration: z.ZodNullable<z.ZodString>;
+    readonly created: z.ZodNullable<z.ZodString>;
+    readonly note: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>>;
+export declare const domainAvailabilityDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly results: z.ZodArray<z.ZodObject<{
+        readonly domain: z.ZodString;
+        readonly available: z.ZodBoolean;
+        readonly registrar: z.ZodNullable<z.ZodString>;
+        readonly expiration: z.ZodNullable<z.ZodString>;
+        readonly created: z.ZodNullable<z.ZodString>;
+        readonly note: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    readonly message: z.ZodNullable<z.ZodString>;
+    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 results: z.ZodArray<z.ZodObject<{
+        readonly domain: z.ZodString;
+        readonly available: z.ZodBoolean;
+        readonly registrar: z.ZodNullable<z.ZodString>;
+        readonly expiration: z.ZodNullable<z.ZodString>;
+        readonly created: z.ZodNullable<z.ZodString>;
+        readonly note: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    readonly message: z.ZodNullable<z.ZodString>;
+    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 domainAvailabilityResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    data: z.ZodObject<{
+        readonly results: z.ZodArray<z.ZodObject<{
+            readonly domain: z.ZodString;
+            readonly available: z.ZodBoolean;
+            readonly registrar: z.ZodNullable<z.ZodString>;
+            readonly expiration: z.ZodNullable<z.ZodString>;
+            readonly created: z.ZodNullable<z.ZodString>;
+            readonly note: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        readonly message: z.ZodNullable<z.ZodString>;
+        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 results: z.ZodArray<z.ZodObject<{
+            readonly domain: z.ZodString;
+            readonly available: z.ZodBoolean;
+            readonly registrar: z.ZodNullable<z.ZodString>;
+            readonly expiration: z.ZodNullable<z.ZodString>;
+            readonly created: z.ZodNullable<z.ZodString>;
+            readonly note: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        readonly message: z.ZodNullable<z.ZodString>;
+        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 type DomainAvailability = z.output<typeof domainAvailabilityDataSchema.producer>;
+export declare const domainAvailabilityOperation: {
+    readonly id: 'research.domain.availability';
+    readonly method: 'GET';
+    readonly path: '/api/v1/sites/{siteId}/research/domain-availability';
+    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<{
+            domains: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>;
+        }, z.core.$strict>;
+        readonly headers: null;
+        readonly body: null;
+    };
+    readonly responses: {
+        readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+                readonly results: z.ZodArray<z.ZodObject<{
+                    readonly domain: z.ZodString;
+                    readonly available: z.ZodBoolean;
+                    readonly registrar: z.ZodNullable<z.ZodString>;
+                    readonly expiration: z.ZodNullable<z.ZodString>;
+                    readonly created: z.ZodNullable<z.ZodString>;
+                    readonly note: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+                readonly message: z.ZodNullable<z.ZodString>;
+                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 results: z.ZodArray<z.ZodObject<{
+                    readonly domain: z.ZodString;
+                    readonly available: z.ZodBoolean;
+                    readonly registrar: z.ZodNullable<z.ZodString>;
+                    readonly expiration: z.ZodNullable<z.ZodString>;
+                    readonly created: z.ZodNullable<z.ZodString>;
+                    readonly note: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+                readonly message: z.ZodNullable<z.ZodString>;
+                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.2.0';
+    };
+    readonly docs: {
+        readonly summary: 'Check domain availability';
+        readonly description: 'Returns the registration status of up to ten domains, with the registrar and expiry when the domain is taken. Repeat the domains parameter for each domain. Cached reads consume no units.';
+        readonly tags: readonly ["Research"];
+        readonly examples: readonly [{
+            readonly request: {
+                readonly params: {
+                    readonly siteId: 'site_01JXYZ';
+                };
+                readonly query: {
+                    readonly domains: readonly ["example.com", "example.dev"];
+                };
+            };
+            readonly response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly results: readonly [{
+                            readonly domain: 'example.com';
+                            readonly available: false;
+                            readonly registrar: 'Example Registrar';
+                            readonly expiration: '2027-04-01';
+                            readonly created: '1995-08-14';
+                            readonly note: null;
+                        }];
+                        readonly message: null;
+                        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 researchV1Registry: import("./core.js").PublicV1Registry<{
     readonly overview: {
         readonly id: 'research.overview';
         readonly method: 'GET';
-        readonly path: '/api/v1/sites/{siteId}/research';
+        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>;
+                        }, 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.$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>>;
+                        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';
@@ -2172,8 +3638,8 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
             readonly readConsistency: 'primary';
         };
         readonly auth: {
-            readonly credentials: readonly ["session", "api_token"];
-            readonly scopes: readonly ["research:read"];
+            readonly credentials: readonly ['session', 'api_token'];
+            readonly scopes: readonly ['research:read'];
             readonly minimumRole: 'viewer';
             readonly ownership: 'site';
         };
@@ -2181,95 +3647,33 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
             readonly params: z.ZodObject<{
                 siteId: z.ZodString;
             }, z.core.$strict>;
-            readonly query: null;
+            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 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 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 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>;
+                        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;
@@ -2277,88 +3681,22 @@ 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 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 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 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>;
+                        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;
@@ -2366,7 +3704,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<{
@@ -2430,39 +3768,44 @@ 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: '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 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 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';
@@ -2473,10 +3816,10 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
             }];
         };
     };
-    readonly keywords: {
-        readonly id: 'research.keywords';
+    readonly rankings: {
+        readonly id: 'research.rankings';
         readonly method: 'GET';
-        readonly path: '/api/v1/sites/{siteId}/research/keywords';
+        readonly path: '/api/v1/sites/{siteId}/research/rankings';
         readonly visibility: 'public';
         readonly semantics: {
             readonly kind: 'query';
@@ -2495,26 +3838,15 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
                 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>>>;
+                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;
@@ -2522,73 +3854,40 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
         readonly responses: {
             readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
                 data: z.ZodObject<{
-                    readonly topic: z.ZodString;
+                    readonly domain: 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>;
+                        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 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>;
+                    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>;
-                    }, z.core.$strict>], "_tag">;
+                        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;
@@ -2596,73 +3895,40 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
                 }, z.core.$strict>;
             }, z.core.$strip>, z.ZodObject<{
                 data: z.ZodObject<{
-                    readonly topic: z.ZodString;
+                    readonly domain: 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>;
+                        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 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>;
+                    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>;
-                    }, z.core.$loose>], "_tag">;
+                        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;
@@ -2745,8 +4011,8 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
             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 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: {
@@ -2754,7 +4020,7 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
                         readonly siteId: 'site_01JXYZ';
                     };
                     readonly query: {
-                        readonly topic: 'nuxt seo';
+                        readonly domain: 'nuxtseo.com';
                         readonly limit: 20;
                     };
                 };
@@ -2762,23 +4028,15 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
                     readonly status: 200;
                     readonly body: {
                         readonly data: {
-                            readonly topic: 'nuxt seo';
+                            readonly domain: 'nuxtseo.com';
                             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 metrics: null;
+                            readonly positionRange: {
+                                readonly min: 1;
+                                readonly max: 20;
                             };
+                            readonly cached: false;
                         };
                         readonly meta: {
                             readonly requestId: 'req_01JXYZ';
@@ -2789,10 +4047,10 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
             }];
         };
     };
-    readonly serp: {
-        readonly id: 'research.serp';
+    readonly domainTraffic: {
+        readonly id: 'research.domain.traffic';
         readonly method: 'GET';
-        readonly path: '/api/v1/sites/{siteId}/research/serp';
+        readonly path: '/api/v1/sites/{siteId}/research/domain-traffic';
         readonly visibility: 'public';
         readonly semantics: {
             readonly kind: 'query';
@@ -2811,32 +4069,56 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
                 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>>;
+                domain: z.ZodString;
             }, 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>;
+            readonly body: null;
+        };
+        readonly responses: {
+            readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly domain: z.ZodString;
+                    readonly monthlyTraffic: z.ZodNumber;
+                    readonly trend: z.ZodEnum<{
+                        declining: "declining";
+                        growing: "growing";
+                        stable: "stable";
+                    }>;
+                    readonly changePercent: z.ZodNumber;
+                    readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                    readonly keywordFootprint: 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 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;
+                    readonly topCountries: z.ZodArray<z.ZodObject<{
+                        country: z.ZodString;
+                        percent: z.ZodNumber;
+                    }, z.core.$strict>>;
+                    readonly message: z.ZodNullable<z.ZodString>;
+                    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;
@@ -2844,22 +4126,48 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
                 }, 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>;
+                    readonly domain: z.ZodString;
+                    readonly monthlyTraffic: z.ZodNumber;
+                    readonly trend: z.ZodEnum<{
+                        declining: "declining";
+                        growing: "growing";
+                        stable: "stable";
+                    }>;
+                    readonly changePercent: z.ZodNumber;
+                    readonly trafficValue: z.ZodNullable<z.ZodNumber>;
+                    readonly keywordFootprint: 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 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;
+                    readonly topCountries: z.ZodArray<z.ZodObject<{
+                        country: z.ZodString;
+                        percent: z.ZodNumber;
+                    }, z.core.$loose>>;
+                    readonly message: z.ZodNullable<z.ZodString>;
+                    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;
@@ -2939,11 +4247,11 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
             };
         };
         readonly lifecycle: {
-            readonly introduced: '1.0.0';
+            readonly introduced: '1.2.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 summary: 'Estimate domain traffic';
+            readonly description: 'Returns an estimate of one domain organic search traffic, its trend, its top pages and countries. The domain does not have to be one of your Sites, so this reads a competitor as readily as your own. Cached reads consume no units.';
             readonly tags: readonly ["Research"];
             readonly examples: readonly [{
                 readonly request: {
@@ -2951,24 +4259,37 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
                         readonly siteId: 'site_01JXYZ';
                     };
                     readonly query: {
-                        readonly keyword: 'nuxt seo';
-                        readonly depth: 10;
+                        readonly domain: 'nuxtseo.com';
                     };
                 };
                 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 domain: 'nuxtseo.com';
+                            readonly monthlyTraffic: 48200;
+                            readonly trend: 'growing';
+                            readonly changePercent: 12.4;
+                            readonly trafficValue: 31200;
+                            readonly keywordFootprint: 62;
+                            readonly topPages: readonly [{
+                                readonly path: '/docs/sitemap';
+                                readonly traffic: 4100;
+                                readonly keywords: 220;
+                            }];
+                            readonly topCountries: readonly [{
+                                readonly country: 'US';
+                                readonly percent: 41.2;
+                            }];
+                            readonly message: null;
+                            readonly evidence: {
+                                readonly _tag: 'live';
+                                readonly provider: 'dataforseo';
+                                readonly spend: {
+                                    readonly key: 'dataforseo';
+                                    readonly units: 1;
+                                };
+                            };
                         };
                         readonly meta: {
                             readonly requestId: 'req_01JXYZ';
@@ -2979,10 +4300,10 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
             }];
         };
     };
-    readonly rankings: {
-        readonly id: 'research.rankings';
+    readonly domainAvailability: {
+        readonly id: 'research.domain.availability';
         readonly method: 'GET';
-        readonly path: '/api/v1/sites/{siteId}/research/rankings';
+        readonly path: '/api/v1/sites/{siteId}/research/domain-availability';
         readonly visibility: 'public';
         readonly semantics: {
             readonly kind: 'query';
@@ -3001,15 +4322,7 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
                 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";
-                }>>;
+                domains: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>;
             }, z.core.$strict>;
             readonly headers: null;
             readonly body: null;
@@ -3017,40 +4330,37 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
         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>>;
+                    readonly results: z.ZodArray<z.ZodObject<{
+                        readonly domain: z.ZodString;
+                        readonly available: z.ZodBoolean;
+                        readonly registrar: z.ZodNullable<z.ZodString>;
+                        readonly expiration: z.ZodNullable<z.ZodString>;
+                        readonly created: z.ZodNullable<z.ZodString>;
+                        readonly note: 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">;
+                    readonly message: z.ZodNullable<z.ZodString>;
+                    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 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.$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;
@@ -3058,40 +4368,37 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
                 }, 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>>;
+                    readonly results: z.ZodArray<z.ZodObject<{
+                        readonly domain: z.ZodString;
+                        readonly available: z.ZodBoolean;
+                        readonly registrar: z.ZodNullable<z.ZodString>;
+                        readonly expiration: z.ZodNullable<z.ZodString>;
+                        readonly created: z.ZodNullable<z.ZodString>;
+                        readonly note: 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">;
+                    readonly message: z.ZodNullable<z.ZodString>;
+                    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>;
-                        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.$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;
@@ -3171,11 +4478,11 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
             };
         };
         readonly lifecycle: {
-            readonly introduced: '1.0.0';
+            readonly introduced: '1.2.0';
         };
         readonly docs: {
-            readonly summary: 'Research domain rankings';
-            readonly description: 'Returns current keyword rankings and domain metrics. Cached reads consume no units.';
+            readonly summary: 'Check domain availability';
+            readonly description: 'Returns the registration status of up to ten domains, with the registrar and expiry when the domain is taken. Repeat the domains parameter for each domain. Cached reads consume no units.';
             readonly tags: readonly ["Research"];
             readonly examples: readonly [{
                 readonly request: {
@@ -3183,23 +4490,30 @@ export declare const researchV1Registry: import("./core.js").PublicV1Registry<{
                         readonly siteId: 'site_01JXYZ';
                     };
                     readonly query: {
-                        readonly domain: 'nuxtseo.com';
-                        readonly limit: 20;
+                        readonly domains: readonly ["example.com", "example.dev"];
                     };
                 };
                 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 results: readonly [{
+                                readonly domain: 'example.com';
+                                readonly available: false;
+                                readonly registrar: 'Example Registrar';
+                                readonly expiration: '2027-04-01';
+                                readonly created: '1995-08-14';
+                                readonly note: null;
+                            }];
+                            readonly message: null;
+                            readonly evidence: {
+                                readonly _tag: 'live';
+                                readonly provider: 'dataforseo';
+                                readonly spend: {
+                                    readonly key: 'dataforseo';
+                                    readonly units: 1;
+                                };
                             };
-                            readonly cached: false;
                         };
                         readonly meta: {
                             readonly requestId: 'req_01JXYZ';