@nuxtseo/protocol 0.1.5 → 0.2.1

package/dist/v1/backlinks.d.ts

@@ -310,199 +310,6 @@ export declare const recoverableBacklinksOperation: {
         }];
     };
 };
-export declare const backlinksV1Registry: import("./core.js").PublicV1Registry<{
-    readonly recoverable: {
-        readonly id: 'backlinks.recoverable';
-        readonly method: 'GET';
-        readonly path: '/api/v1/sites/{siteId}/backlinks/recoverable';
-        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<{
-                limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
-                offset: 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 items: z.ZodArray<z.ZodObject<{
-                        readonly id: z.ZodString;
-                        readonly destinationUrl: z.ZodString;
-                        readonly referringUrl: z.ZodString;
-                        readonly referringDomain: z.ZodString;
-                        readonly anchor: z.ZodNullable<z.ZodString>;
-                        readonly destinationStatus: z.ZodNullable<z.ZodNumber>;
-                        readonly domainRank: z.ZodNullable<z.ZodNumber>;
-                        readonly pageRank: z.ZodNullable<z.ZodNumber>;
-                        readonly dofollow: z.ZodNullable<z.ZodBoolean>;
-                        readonly firstSeenAt: z.ZodNullable<z.ZodString>;
-                        readonly lastSeenAt: z.ZodNullable<z.ZodString>;
-                    }, z.core.$strip>>;
-                    readonly total: z.ZodNumber;
-                    readonly limit: z.ZodNumber;
-                    readonly offset: z.ZodNumber;
-                }, 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 items: z.ZodArray<z.ZodObject<{
-                        readonly id: z.ZodString;
-                        readonly destinationUrl: z.ZodString;
-                        readonly referringUrl: z.ZodString;
-                        readonly referringDomain: z.ZodString;
-                        readonly anchor: z.ZodNullable<z.ZodString>;
-                        readonly destinationStatus: z.ZodNullable<z.ZodNumber>;
-                        readonly domainRank: z.ZodNullable<z.ZodNumber>;
-                        readonly pageRank: z.ZodNullable<z.ZodNumber>;
-                        readonly dofollow: z.ZodNullable<z.ZodBoolean>;
-                        readonly firstSeenAt: z.ZodNullable<z.ZodString>;
-                        readonly lastSeenAt: z.ZodNullable<z.ZodString>;
-                    }, z.core.$strip>>;
-                    readonly total: z.ZodNumber;
-                    readonly limit: z.ZodNumber;
-                    readonly offset: z.ZodNumber;
-                }, 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.1.0';
-        };
-        readonly docs: {
-            readonly summary: 'List recoverable Backlinks';
-            readonly description: 'Returns retained inbound links whose destination is broken, ranked by referring domain authority. Each item carries the referring URL and the destination URL, so a redirect can be written without a crawl. 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 query: {
-                        readonly limit: 100;
-                        readonly offset: 0;
-                    };
-                };
-                readonly response: {
-                    readonly status: 200;
-                    readonly body: {
-                        readonly data: {
-                            readonly items: readonly [{
-                                readonly id: 'bl_01JXYZ';
-                                readonly destinationUrl: 'https://example.com/docs/utils';
-                                readonly referringUrl: 'https://news.example/posts/seo';
-                                readonly referringDomain: 'news.example';
-                                readonly anchor: 'Read the full documentation';
-                                readonly destinationStatus: 404;
-                                readonly domainRank: 529;
-                                readonly pageRank: 55;
-                                readonly dofollow: true;
-                                readonly firstSeenAt: '2026-02-09T20:43:50.000Z';
-                                readonly lastSeenAt: '2026-07-17T04:40:07.000Z';
-                            }];
-                            readonly total: 1;
-                            readonly limit: 100;
-                            readonly offset: 0;
-                        };
-                        readonly meta: {
-                            readonly requestId: 'req_01JXYZ';
-                            readonly version: '1.0';
-                        };
-                    };
-                };
-            }];
-        };
-    };
-}>;
 export declare const mentionsQuerySchema: z.ZodObject<{
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     includeFiltered: z.ZodPipe<z.ZodDefault<z.ZodEnum<{
@@ -1006,3 +813,2829 @@ export declare const mentionsV1Registry: import("./core.js").PublicV1Registry<{
         };
     };
 }>;
+/** The target a live Backlinks read resolves to: the Site's own bare domain. */
+export declare const liveBacklinksQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+export declare const backlinksSummaryDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly target: z.ZodString;
+    readonly rank: z.ZodNullable<z.ZodNumber>;
+    readonly backlinks: z.ZodNullable<z.ZodNumber>;
+    readonly brokenBacklinks: z.ZodNullable<z.ZodNumber>;
+    readonly brokenPages: z.ZodNullable<z.ZodNumber>;
+    readonly crawledPages: z.ZodNullable<z.ZodNumber>;
+    readonly spamScore: z.ZodNullable<z.ZodNumber>;
+    readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+    readonly referringDomainsNofollow: z.ZodNullable<z.ZodNumber>;
+    readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+    readonly referringIps: z.ZodNullable<z.ZodNumber>;
+    readonly referringSubnets: z.ZodNullable<z.ZodNumber>;
+    readonly referringPages: z.ZodNullable<z.ZodNumber>;
+    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 target: z.ZodString;
+    readonly rank: z.ZodNullable<z.ZodNumber>;
+    readonly backlinks: z.ZodNullable<z.ZodNumber>;
+    readonly brokenBacklinks: z.ZodNullable<z.ZodNumber>;
+    readonly brokenPages: z.ZodNullable<z.ZodNumber>;
+    readonly crawledPages: z.ZodNullable<z.ZodNumber>;
+    readonly spamScore: z.ZodNullable<z.ZodNumber>;
+    readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+    readonly referringDomainsNofollow: z.ZodNullable<z.ZodNumber>;
+    readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+    readonly referringIps: z.ZodNullable<z.ZodNumber>;
+    readonly referringSubnets: z.ZodNullable<z.ZodNumber>;
+    readonly referringPages: z.ZodNullable<z.ZodNumber>;
+    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 backlinksSummaryResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    data: z.ZodObject<{
+        readonly target: z.ZodString;
+        readonly rank: z.ZodNullable<z.ZodNumber>;
+        readonly backlinks: z.ZodNullable<z.ZodNumber>;
+        readonly brokenBacklinks: z.ZodNullable<z.ZodNumber>;
+        readonly brokenPages: z.ZodNullable<z.ZodNumber>;
+        readonly crawledPages: z.ZodNullable<z.ZodNumber>;
+        readonly spamScore: z.ZodNullable<z.ZodNumber>;
+        readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+        readonly referringDomainsNofollow: z.ZodNullable<z.ZodNumber>;
+        readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+        readonly referringIps: z.ZodNullable<z.ZodNumber>;
+        readonly referringSubnets: z.ZodNullable<z.ZodNumber>;
+        readonly referringPages: z.ZodNullable<z.ZodNumber>;
+        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 target: z.ZodString;
+        readonly rank: z.ZodNullable<z.ZodNumber>;
+        readonly backlinks: z.ZodNullable<z.ZodNumber>;
+        readonly brokenBacklinks: z.ZodNullable<z.ZodNumber>;
+        readonly brokenPages: z.ZodNullable<z.ZodNumber>;
+        readonly crawledPages: z.ZodNullable<z.ZodNumber>;
+        readonly spamScore: z.ZodNullable<z.ZodNumber>;
+        readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+        readonly referringDomainsNofollow: z.ZodNullable<z.ZodNumber>;
+        readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+        readonly referringIps: z.ZodNullable<z.ZodNumber>;
+        readonly referringSubnets: z.ZodNullable<z.ZodNumber>;
+        readonly referringPages: z.ZodNullable<z.ZodNumber>;
+        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 BacklinksSummary = z.output<typeof backlinksSummaryDataSchema.producer>;
+export declare const backlinksSummaryOperation: {
+    readonly id: 'backlinks.summary';
+    readonly method: 'GET';
+    readonly path: '/api/v1/sites/{siteId}/backlinks/summary';
+    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 target: z.ZodString;
+                readonly rank: z.ZodNullable<z.ZodNumber>;
+                readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                readonly brokenBacklinks: z.ZodNullable<z.ZodNumber>;
+                readonly brokenPages: z.ZodNullable<z.ZodNumber>;
+                readonly crawledPages: z.ZodNullable<z.ZodNumber>;
+                readonly spamScore: z.ZodNullable<z.ZodNumber>;
+                readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+                readonly referringDomainsNofollow: z.ZodNullable<z.ZodNumber>;
+                readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+                readonly referringIps: z.ZodNullable<z.ZodNumber>;
+                readonly referringSubnets: z.ZodNullable<z.ZodNumber>;
+                readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                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 target: z.ZodString;
+                readonly rank: z.ZodNullable<z.ZodNumber>;
+                readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                readonly brokenBacklinks: z.ZodNullable<z.ZodNumber>;
+                readonly brokenPages: z.ZodNullable<z.ZodNumber>;
+                readonly crawledPages: z.ZodNullable<z.ZodNumber>;
+                readonly spamScore: z.ZodNullable<z.ZodNumber>;
+                readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+                readonly referringDomainsNofollow: z.ZodNullable<z.ZodNumber>;
+                readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+                readonly referringIps: z.ZodNullable<z.ZodNumber>;
+                readonly referringSubnets: z.ZodNullable<z.ZodNumber>;
+                readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                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: 'Get Backlinks summary';
+        readonly description: 'Returns whole-domain inbound link totals for the Site: backlinks, referring domains, broken counts, and the domain rank. Cached reads consume no 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 target: 'example.com';
+                        readonly rank: 214;
+                        readonly backlinks: 5120;
+                        readonly brokenBacklinks: 34;
+                        readonly brokenPages: 7;
+                        readonly crawledPages: 890;
+                        readonly spamScore: 4;
+                        readonly referringDomains: 412;
+                        readonly referringDomainsNofollow: 88;
+                        readonly referringMainDomains: 388;
+                        readonly referringIps: 350;
+                        readonly referringSubnets: 322;
+                        readonly referringPages: 4800;
+                        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 referringDomainSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly domain: z.ZodString;
+    readonly rank: z.ZodNullable<z.ZodNumber>;
+    readonly backlinks: z.ZodNullable<z.ZodNumber>;
+    readonly brokenBacklinks: z.ZodNullable<z.ZodNumber>;
+    readonly brokenPages: z.ZodNullable<z.ZodNumber>;
+    readonly referringPages: z.ZodNullable<z.ZodNumber>;
+    readonly spamScore: z.ZodNullable<z.ZodNumber>;
+    readonly firstSeen: z.ZodNullable<z.ZodString>;
+    readonly lostDate: z.ZodNullable<z.ZodString>;
+    /** 90-day referral sessions from this domain, or null when no Web Analytics property is linked. */
+    readonly sessions: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    readonly domain: z.ZodString;
+    readonly rank: z.ZodNullable<z.ZodNumber>;
+    readonly backlinks: z.ZodNullable<z.ZodNumber>;
+    readonly brokenBacklinks: z.ZodNullable<z.ZodNumber>;
+    readonly brokenPages: z.ZodNullable<z.ZodNumber>;
+    readonly referringPages: z.ZodNullable<z.ZodNumber>;
+    readonly spamScore: z.ZodNullable<z.ZodNumber>;
+    readonly firstSeen: z.ZodNullable<z.ZodString>;
+    readonly lostDate: z.ZodNullable<z.ZodString>;
+    readonly sessions: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>>;
+export declare const referringDomainsDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly target: z.ZodString;
+    readonly items: z.ZodArray<z.ZodObject<{
+        readonly domain: z.ZodString;
+        readonly rank: z.ZodNullable<z.ZodNumber>;
+        readonly backlinks: z.ZodNullable<z.ZodNumber>;
+        readonly brokenBacklinks: z.ZodNullable<z.ZodNumber>;
+        readonly brokenPages: z.ZodNullable<z.ZodNumber>;
+        readonly referringPages: z.ZodNullable<z.ZodNumber>;
+        readonly spamScore: z.ZodNullable<z.ZodNumber>;
+        readonly firstSeen: z.ZodNullable<z.ZodString>;
+        readonly lostDate: z.ZodNullable<z.ZodString>;
+        /** 90-day referral sessions from this domain, or null when no Web Analytics property is linked. */
+        readonly sessions: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    readonly total: z.ZodNumber;
+    readonly limit: z.ZodNumber;
+    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 target: z.ZodString;
+    readonly items: z.ZodArray<z.ZodObject<{
+        readonly domain: z.ZodString;
+        readonly rank: z.ZodNullable<z.ZodNumber>;
+        readonly backlinks: z.ZodNullable<z.ZodNumber>;
+        readonly brokenBacklinks: z.ZodNullable<z.ZodNumber>;
+        readonly brokenPages: z.ZodNullable<z.ZodNumber>;
+        readonly referringPages: z.ZodNullable<z.ZodNumber>;
+        readonly spamScore: z.ZodNullable<z.ZodNumber>;
+        readonly firstSeen: z.ZodNullable<z.ZodString>;
+        readonly lostDate: z.ZodNullable<z.ZodString>;
+        readonly sessions: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    readonly total: z.ZodNumber;
+    readonly limit: z.ZodNumber;
+    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 referringDomainsResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    data: z.ZodObject<{
+        readonly target: z.ZodString;
+        readonly items: z.ZodArray<z.ZodObject<{
+            readonly domain: z.ZodString;
+            readonly rank: z.ZodNullable<z.ZodNumber>;
+            readonly backlinks: z.ZodNullable<z.ZodNumber>;
+            readonly brokenBacklinks: z.ZodNullable<z.ZodNumber>;
+            readonly brokenPages: z.ZodNullable<z.ZodNumber>;
+            readonly referringPages: z.ZodNullable<z.ZodNumber>;
+            readonly spamScore: z.ZodNullable<z.ZodNumber>;
+            readonly firstSeen: z.ZodNullable<z.ZodString>;
+            readonly lostDate: z.ZodNullable<z.ZodString>;
+            /** 90-day referral sessions from this domain, or null when no Web Analytics property is linked. */
+            readonly sessions: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+        readonly total: z.ZodNumber;
+        readonly limit: z.ZodNumber;
+        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 target: z.ZodString;
+        readonly items: z.ZodArray<z.ZodObject<{
+            readonly domain: z.ZodString;
+            readonly rank: z.ZodNullable<z.ZodNumber>;
+            readonly backlinks: z.ZodNullable<z.ZodNumber>;
+            readonly brokenBacklinks: z.ZodNullable<z.ZodNumber>;
+            readonly brokenPages: z.ZodNullable<z.ZodNumber>;
+            readonly referringPages: z.ZodNullable<z.ZodNumber>;
+            readonly spamScore: z.ZodNullable<z.ZodNumber>;
+            readonly firstSeen: z.ZodNullable<z.ZodString>;
+            readonly lostDate: z.ZodNullable<z.ZodString>;
+            readonly sessions: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+        readonly total: z.ZodNumber;
+        readonly limit: z.ZodNumber;
+        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 ReferringDomains = z.output<typeof referringDomainsDataSchema.producer>;
+export declare const referringDomainsOperation: {
+    readonly id: 'backlinks.referring.domains';
+    readonly method: 'GET';
+    readonly path: '/api/v1/sites/{siteId}/backlinks/referring-domains';
+    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<{
+            limit: 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 target: z.ZodString;
+                readonly items: z.ZodArray<z.ZodObject<{
+                    readonly domain: z.ZodString;
+                    readonly rank: z.ZodNullable<z.ZodNumber>;
+                    readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                    readonly brokenBacklinks: z.ZodNullable<z.ZodNumber>;
+                    readonly brokenPages: z.ZodNullable<z.ZodNumber>;
+                    readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                    readonly spamScore: z.ZodNullable<z.ZodNumber>;
+                    readonly firstSeen: z.ZodNullable<z.ZodString>;
+                    readonly lostDate: z.ZodNullable<z.ZodString>;
+                    /** 90-day referral sessions from this domain, or null when no Web Analytics property is linked. */
+                    readonly sessions: z.ZodNullable<z.ZodNumber>;
+                }, z.core.$strip>>;
+                readonly total: z.ZodNumber;
+                readonly limit: z.ZodNumber;
+                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 target: z.ZodString;
+                readonly items: z.ZodArray<z.ZodObject<{
+                    readonly domain: z.ZodString;
+                    readonly rank: z.ZodNullable<z.ZodNumber>;
+                    readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                    readonly brokenBacklinks: z.ZodNullable<z.ZodNumber>;
+                    readonly brokenPages: z.ZodNullable<z.ZodNumber>;
+                    readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                    readonly spamScore: z.ZodNullable<z.ZodNumber>;
+                    readonly firstSeen: z.ZodNullable<z.ZodString>;
+                    readonly lostDate: z.ZodNullable<z.ZodString>;
+                    readonly sessions: z.ZodNullable<z.ZodNumber>;
+                }, z.core.$strip>>;
+                readonly total: z.ZodNumber;
+                readonly limit: z.ZodNumber;
+                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: 'List referring domains';
+        readonly description: 'Returns the domains that link to the Site, highest authority first, with spam score and broken-link counts. When a Web Analytics property is linked, each row also carries its 90-day referral sessions, so a link that sends nobody is visible. Cached reads consume no units.';
+        readonly tags: readonly ["Research"];
+        readonly examples: readonly [{
+            readonly request: {
+                readonly params: {
+                    readonly siteId: 'site_01JXYZ';
+                };
+                readonly query: {
+                    readonly limit: 100;
+                };
+            };
+            readonly response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly target: 'example.com';
+                        readonly items: readonly [{
+                            readonly domain: 'news.example';
+                            readonly rank: 529;
+                            readonly backlinks: 12;
+                            readonly brokenBacklinks: 0;
+                            readonly brokenPages: 0;
+                            readonly referringPages: 9;
+                            readonly spamScore: 2;
+                            readonly firstSeen: '2026-02-09 20:43:50 +00:00';
+                            readonly lostDate: null;
+                            readonly sessions: 143;
+                        }];
+                        readonly total: 1;
+                        readonly limit: 100;
+                        readonly evidence: {
+                            readonly _tag: 'cache';
+                            readonly provider: 'dataforseo';
+                            readonly spend: {
+                                readonly key: 'dataforseo';
+                                readonly units: 0;
+                            };
+                        };
+                    };
+                    readonly meta: {
+                        readonly requestId: 'req_01JXYZ';
+                        readonly version: '1.0';
+                    };
+                };
+            };
+        }];
+    };
+};
+export declare const backlinkAnchorSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly anchor: z.ZodString;
+    readonly rank: z.ZodNullable<z.ZodNumber>;
+    readonly backlinks: z.ZodNullable<z.ZodNumber>;
+    readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+    readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+    readonly referringPages: z.ZodNullable<z.ZodNumber>;
+    readonly spamScore: z.ZodNullable<z.ZodNumber>;
+    readonly firstSeen: z.ZodNullable<z.ZodString>;
+    readonly lostDate: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    readonly anchor: z.ZodString;
+    readonly rank: z.ZodNullable<z.ZodNumber>;
+    readonly backlinks: z.ZodNullable<z.ZodNumber>;
+    readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+    readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+    readonly referringPages: z.ZodNullable<z.ZodNumber>;
+    readonly spamScore: z.ZodNullable<z.ZodNumber>;
+    readonly firstSeen: z.ZodNullable<z.ZodString>;
+    readonly lostDate: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>>;
+export declare const backlinkAnchorsDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly target: z.ZodString;
+    readonly items: z.ZodArray<z.ZodObject<{
+        readonly anchor: z.ZodString;
+        readonly rank: z.ZodNullable<z.ZodNumber>;
+        readonly backlinks: z.ZodNullable<z.ZodNumber>;
+        readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+        readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+        readonly referringPages: z.ZodNullable<z.ZodNumber>;
+        readonly spamScore: z.ZodNullable<z.ZodNumber>;
+        readonly firstSeen: z.ZodNullable<z.ZodString>;
+        readonly lostDate: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    readonly total: z.ZodNumber;
+    readonly limit: z.ZodNumber;
+    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 target: z.ZodString;
+    readonly items: z.ZodArray<z.ZodObject<{
+        readonly anchor: z.ZodString;
+        readonly rank: z.ZodNullable<z.ZodNumber>;
+        readonly backlinks: z.ZodNullable<z.ZodNumber>;
+        readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+        readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+        readonly referringPages: z.ZodNullable<z.ZodNumber>;
+        readonly spamScore: z.ZodNullable<z.ZodNumber>;
+        readonly firstSeen: z.ZodNullable<z.ZodString>;
+        readonly lostDate: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    readonly total: z.ZodNumber;
+    readonly limit: z.ZodNumber;
+    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 backlinkAnchorsResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    data: z.ZodObject<{
+        readonly target: z.ZodString;
+        readonly items: z.ZodArray<z.ZodObject<{
+            readonly anchor: z.ZodString;
+            readonly rank: z.ZodNullable<z.ZodNumber>;
+            readonly backlinks: z.ZodNullable<z.ZodNumber>;
+            readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+            readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+            readonly referringPages: z.ZodNullable<z.ZodNumber>;
+            readonly spamScore: z.ZodNullable<z.ZodNumber>;
+            readonly firstSeen: z.ZodNullable<z.ZodString>;
+            readonly lostDate: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        readonly total: z.ZodNumber;
+        readonly limit: z.ZodNumber;
+        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 target: z.ZodString;
+        readonly items: z.ZodArray<z.ZodObject<{
+            readonly anchor: z.ZodString;
+            readonly rank: z.ZodNullable<z.ZodNumber>;
+            readonly backlinks: z.ZodNullable<z.ZodNumber>;
+            readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+            readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+            readonly referringPages: z.ZodNullable<z.ZodNumber>;
+            readonly spamScore: z.ZodNullable<z.ZodNumber>;
+            readonly firstSeen: z.ZodNullable<z.ZodString>;
+            readonly lostDate: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        readonly total: z.ZodNumber;
+        readonly limit: z.ZodNumber;
+        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 BacklinkAnchors = z.output<typeof backlinkAnchorsDataSchema.producer>;
+export declare const backlinkAnchorsOperation: {
+    readonly id: 'backlinks.anchors';
+    readonly method: 'GET';
+    readonly path: '/api/v1/sites/{siteId}/backlinks/anchors';
+    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<{
+            limit: 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 target: z.ZodString;
+                readonly items: z.ZodArray<z.ZodObject<{
+                    readonly anchor: z.ZodString;
+                    readonly rank: z.ZodNullable<z.ZodNumber>;
+                    readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                    readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+                    readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+                    readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                    readonly spamScore: z.ZodNullable<z.ZodNumber>;
+                    readonly firstSeen: z.ZodNullable<z.ZodString>;
+                    readonly lostDate: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+                readonly total: z.ZodNumber;
+                readonly limit: z.ZodNumber;
+                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 target: z.ZodString;
+                readonly items: z.ZodArray<z.ZodObject<{
+                    readonly anchor: z.ZodString;
+                    readonly rank: z.ZodNullable<z.ZodNumber>;
+                    readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                    readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+                    readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+                    readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                    readonly spamScore: z.ZodNullable<z.ZodNumber>;
+                    readonly firstSeen: z.ZodNullable<z.ZodString>;
+                    readonly lostDate: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+                readonly total: z.ZodNumber;
+                readonly limit: z.ZodNumber;
+                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: 'List Backlink anchors';
+        readonly description: 'Returns the anchor text distribution of the Site inbound links, most linked first. Use it to find over-optimised or off-brand anchors. Cached reads consume no units.';
+        readonly tags: readonly ["Research"];
+        readonly examples: readonly [{
+            readonly request: {
+                readonly params: {
+                    readonly siteId: 'site_01JXYZ';
+                };
+                readonly query: {
+                    readonly limit: 100;
+                };
+            };
+            readonly response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly target: 'example.com';
+                        readonly items: readonly [{
+                            readonly anchor: 'nuxt seo';
+                            readonly rank: 480;
+                            readonly backlinks: 212;
+                            readonly referringDomains: 64;
+                            readonly referringMainDomains: 60;
+                            readonly referringPages: 190;
+                            readonly spamScore: 3;
+                            readonly firstSeen: '2026-01-04 11:02:11 +00:00';
+                            readonly lostDate: null;
+                        }];
+                        readonly total: 1;
+                        readonly limit: 100;
+                        readonly evidence: {
+                            readonly _tag: 'cache';
+                            readonly provider: 'dataforseo';
+                            readonly spend: {
+                                readonly key: 'dataforseo';
+                                readonly units: 0;
+                            };
+                        };
+                    };
+                    readonly meta: {
+                        readonly requestId: 'req_01JXYZ';
+                        readonly version: '1.0';
+                    };
+                };
+            };
+        }];
+    };
+};
+export declare const backlinksHistoryQuerySchema: z.ZodObject<{
+    dateFrom: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const backlinksHistoryPointSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly date: z.ZodString;
+    readonly rank: z.ZodNullable<z.ZodNumber>;
+    readonly backlinks: z.ZodNullable<z.ZodNumber>;
+    readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+    readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+    readonly referringPages: z.ZodNullable<z.ZodNumber>;
+    readonly newReferringDomains: z.ZodNullable<z.ZodNumber>;
+    readonly lostReferringDomains: z.ZodNullable<z.ZodNumber>;
+    readonly newBacklinks: z.ZodNullable<z.ZodNumber>;
+    readonly lostBacklinks: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    readonly date: z.ZodString;
+    readonly rank: z.ZodNullable<z.ZodNumber>;
+    readonly backlinks: z.ZodNullable<z.ZodNumber>;
+    readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+    readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+    readonly referringPages: z.ZodNullable<z.ZodNumber>;
+    readonly newReferringDomains: z.ZodNullable<z.ZodNumber>;
+    readonly lostReferringDomains: z.ZodNullable<z.ZodNumber>;
+    readonly newBacklinks: z.ZodNullable<z.ZodNumber>;
+    readonly lostBacklinks: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>>;
+export declare const backlinksHistoryDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    readonly target: z.ZodString;
+    readonly items: z.ZodArray<z.ZodObject<{
+        readonly date: z.ZodString;
+        readonly rank: z.ZodNullable<z.ZodNumber>;
+        readonly backlinks: z.ZodNullable<z.ZodNumber>;
+        readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+        readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+        readonly referringPages: z.ZodNullable<z.ZodNumber>;
+        readonly newReferringDomains: z.ZodNullable<z.ZodNumber>;
+        readonly lostReferringDomains: z.ZodNullable<z.ZodNumber>;
+        readonly newBacklinks: z.ZodNullable<z.ZodNumber>;
+        readonly lostBacklinks: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    readonly total: z.ZodNumber;
+    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 target: z.ZodString;
+    readonly items: z.ZodArray<z.ZodObject<{
+        readonly date: z.ZodString;
+        readonly rank: z.ZodNullable<z.ZodNumber>;
+        readonly backlinks: z.ZodNullable<z.ZodNumber>;
+        readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+        readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+        readonly referringPages: z.ZodNullable<z.ZodNumber>;
+        readonly newReferringDomains: z.ZodNullable<z.ZodNumber>;
+        readonly lostReferringDomains: z.ZodNullable<z.ZodNumber>;
+        readonly newBacklinks: z.ZodNullable<z.ZodNumber>;
+        readonly lostBacklinks: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    readonly total: z.ZodNumber;
+    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 backlinksHistoryResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    data: z.ZodObject<{
+        readonly target: z.ZodString;
+        readonly items: z.ZodArray<z.ZodObject<{
+            readonly date: z.ZodString;
+            readonly rank: z.ZodNullable<z.ZodNumber>;
+            readonly backlinks: z.ZodNullable<z.ZodNumber>;
+            readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+            readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+            readonly referringPages: z.ZodNullable<z.ZodNumber>;
+            readonly newReferringDomains: z.ZodNullable<z.ZodNumber>;
+            readonly lostReferringDomains: z.ZodNullable<z.ZodNumber>;
+            readonly newBacklinks: z.ZodNullable<z.ZodNumber>;
+            readonly lostBacklinks: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+        readonly total: z.ZodNumber;
+        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 target: z.ZodString;
+        readonly items: z.ZodArray<z.ZodObject<{
+            readonly date: z.ZodString;
+            readonly rank: z.ZodNullable<z.ZodNumber>;
+            readonly backlinks: z.ZodNullable<z.ZodNumber>;
+            readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+            readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+            readonly referringPages: z.ZodNullable<z.ZodNumber>;
+            readonly newReferringDomains: z.ZodNullable<z.ZodNumber>;
+            readonly lostReferringDomains: z.ZodNullable<z.ZodNumber>;
+            readonly newBacklinks: z.ZodNullable<z.ZodNumber>;
+            readonly lostBacklinks: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+        readonly total: z.ZodNumber;
+        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 BacklinksHistory = z.output<typeof backlinksHistoryDataSchema.producer>;
+export declare const backlinksHistoryOperation: {
+    readonly id: 'backlinks.history';
+    readonly method: 'GET';
+    readonly path: '/api/v1/sites/{siteId}/backlinks/history';
+    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<{
+            dateFrom: z.ZodOptional<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 target: z.ZodString;
+                readonly items: z.ZodArray<z.ZodObject<{
+                    readonly date: z.ZodString;
+                    readonly rank: z.ZodNullable<z.ZodNumber>;
+                    readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                    readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+                    readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+                    readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                    readonly newReferringDomains: z.ZodNullable<z.ZodNumber>;
+                    readonly lostReferringDomains: z.ZodNullable<z.ZodNumber>;
+                    readonly newBacklinks: z.ZodNullable<z.ZodNumber>;
+                    readonly lostBacklinks: z.ZodNullable<z.ZodNumber>;
+                }, z.core.$strip>>;
+                readonly total: z.ZodNumber;
+                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 target: z.ZodString;
+                readonly items: z.ZodArray<z.ZodObject<{
+                    readonly date: z.ZodString;
+                    readonly rank: z.ZodNullable<z.ZodNumber>;
+                    readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                    readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+                    readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+                    readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                    readonly newReferringDomains: z.ZodNullable<z.ZodNumber>;
+                    readonly lostReferringDomains: z.ZodNullable<z.ZodNumber>;
+                    readonly newBacklinks: z.ZodNullable<z.ZodNumber>;
+                    readonly lostBacklinks: z.ZodNullable<z.ZodNumber>;
+                }, z.core.$strip>>;
+                readonly total: z.ZodNumber;
+                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: 'Get Backlinks history';
+        readonly description: 'Returns a monthly series of inbound link totals with the domains gained and lost in each month. It defaults to about twelve months; pass dateFrom for a longer window. Cached reads consume no units.';
+        readonly tags: readonly ["Research"];
+        readonly examples: readonly [{
+            readonly request: {
+                readonly params: {
+                    readonly siteId: 'site_01JXYZ';
+                };
+                readonly query: {
+                    readonly dateFrom: '2026-01-01';
+                };
+            };
+            readonly response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly target: 'example.com';
+                        readonly items: readonly [{
+                            readonly date: '2026-08-01';
+                            readonly rank: 214;
+                            readonly backlinks: 5120;
+                            readonly referringDomains: 412;
+                            readonly referringMainDomains: 388;
+                            readonly referringPages: 4800;
+                            readonly newReferringDomains: 18;
+                            readonly lostReferringDomains: 4;
+                            readonly newBacklinks: 210;
+                            readonly lostBacklinks: 62;
+                        }];
+                        readonly total: 1;
+                        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 backlinksV1Registry: import("./core.js").PublicV1Registry<{
+    readonly recoverable: {
+        readonly id: 'backlinks.recoverable';
+        readonly method: 'GET';
+        readonly path: '/api/v1/sites/{siteId}/backlinks/recoverable';
+        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<{
+                limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+                offset: 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 items: z.ZodArray<z.ZodObject<{
+                        readonly id: z.ZodString;
+                        readonly destinationUrl: z.ZodString;
+                        readonly referringUrl: z.ZodString;
+                        readonly referringDomain: z.ZodString;
+                        readonly anchor: z.ZodNullable<z.ZodString>;
+                        readonly destinationStatus: z.ZodNullable<z.ZodNumber>;
+                        readonly domainRank: z.ZodNullable<z.ZodNumber>;
+                        readonly pageRank: z.ZodNullable<z.ZodNumber>;
+                        readonly dofollow: z.ZodNullable<z.ZodBoolean>;
+                        readonly firstSeenAt: z.ZodNullable<z.ZodString>;
+                        readonly lastSeenAt: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                    readonly total: z.ZodNumber;
+                    readonly limit: z.ZodNumber;
+                    readonly offset: z.ZodNumber;
+                }, 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 items: z.ZodArray<z.ZodObject<{
+                        readonly id: z.ZodString;
+                        readonly destinationUrl: z.ZodString;
+                        readonly referringUrl: z.ZodString;
+                        readonly referringDomain: z.ZodString;
+                        readonly anchor: z.ZodNullable<z.ZodString>;
+                        readonly destinationStatus: z.ZodNullable<z.ZodNumber>;
+                        readonly domainRank: z.ZodNullable<z.ZodNumber>;
+                        readonly pageRank: z.ZodNullable<z.ZodNumber>;
+                        readonly dofollow: z.ZodNullable<z.ZodBoolean>;
+                        readonly firstSeenAt: z.ZodNullable<z.ZodString>;
+                        readonly lastSeenAt: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                    readonly total: z.ZodNumber;
+                    readonly limit: z.ZodNumber;
+                    readonly offset: z.ZodNumber;
+                }, 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.1.0';
+        };
+        readonly docs: {
+            readonly summary: 'List recoverable Backlinks';
+            readonly description: 'Returns retained inbound links whose destination is broken, ranked by referring domain authority. Each item carries the referring URL and the destination URL, so a redirect can be written without a crawl. 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 query: {
+                        readonly limit: 100;
+                        readonly offset: 0;
+                    };
+                };
+                readonly response: {
+                    readonly status: 200;
+                    readonly body: {
+                        readonly data: {
+                            readonly items: readonly [{
+                                readonly id: 'bl_01JXYZ';
+                                readonly destinationUrl: 'https://example.com/docs/utils';
+                                readonly referringUrl: 'https://news.example/posts/seo';
+                                readonly referringDomain: 'news.example';
+                                readonly anchor: 'Read the full documentation';
+                                readonly destinationStatus: 404;
+                                readonly domainRank: 529;
+                                readonly pageRank: 55;
+                                readonly dofollow: true;
+                                readonly firstSeenAt: '2026-02-09T20:43:50.000Z';
+                                readonly lastSeenAt: '2026-07-17T04:40:07.000Z';
+                            }];
+                            readonly total: 1;
+                            readonly limit: 100;
+                            readonly offset: 0;
+                        };
+                        readonly meta: {
+                            readonly requestId: 'req_01JXYZ';
+                            readonly version: '1.0';
+                        };
+                    };
+                };
+            }];
+        };
+    };
+    readonly summary: {
+        readonly id: 'backlinks.summary';
+        readonly method: 'GET';
+        readonly path: '/api/v1/sites/{siteId}/backlinks/summary';
+        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 target: z.ZodString;
+                    readonly rank: z.ZodNullable<z.ZodNumber>;
+                    readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                    readonly brokenBacklinks: z.ZodNullable<z.ZodNumber>;
+                    readonly brokenPages: z.ZodNullable<z.ZodNumber>;
+                    readonly crawledPages: z.ZodNullable<z.ZodNumber>;
+                    readonly spamScore: z.ZodNullable<z.ZodNumber>;
+                    readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+                    readonly referringDomainsNofollow: z.ZodNullable<z.ZodNumber>;
+                    readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+                    readonly referringIps: z.ZodNullable<z.ZodNumber>;
+                    readonly referringSubnets: z.ZodNullable<z.ZodNumber>;
+                    readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                    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 target: z.ZodString;
+                    readonly rank: z.ZodNullable<z.ZodNumber>;
+                    readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                    readonly brokenBacklinks: z.ZodNullable<z.ZodNumber>;
+                    readonly brokenPages: z.ZodNullable<z.ZodNumber>;
+                    readonly crawledPages: z.ZodNullable<z.ZodNumber>;
+                    readonly spamScore: z.ZodNullable<z.ZodNumber>;
+                    readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+                    readonly referringDomainsNofollow: z.ZodNullable<z.ZodNumber>;
+                    readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+                    readonly referringIps: z.ZodNullable<z.ZodNumber>;
+                    readonly referringSubnets: z.ZodNullable<z.ZodNumber>;
+                    readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                    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: 'Get Backlinks summary';
+            readonly description: 'Returns whole-domain inbound link totals for the Site: backlinks, referring domains, broken counts, and the domain rank. Cached reads consume no 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 target: 'example.com';
+                            readonly rank: 214;
+                            readonly backlinks: 5120;
+                            readonly brokenBacklinks: 34;
+                            readonly brokenPages: 7;
+                            readonly crawledPages: 890;
+                            readonly spamScore: 4;
+                            readonly referringDomains: 412;
+                            readonly referringDomainsNofollow: 88;
+                            readonly referringMainDomains: 388;
+                            readonly referringIps: 350;
+                            readonly referringSubnets: 322;
+                            readonly referringPages: 4800;
+                            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 referringDomains: {
+        readonly id: 'backlinks.referring.domains';
+        readonly method: 'GET';
+        readonly path: '/api/v1/sites/{siteId}/backlinks/referring-domains';
+        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<{
+                limit: 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 target: z.ZodString;
+                    readonly items: z.ZodArray<z.ZodObject<{
+                        readonly domain: z.ZodString;
+                        readonly rank: z.ZodNullable<z.ZodNumber>;
+                        readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                        readonly brokenBacklinks: z.ZodNullable<z.ZodNumber>;
+                        readonly brokenPages: z.ZodNullable<z.ZodNumber>;
+                        readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                        readonly spamScore: z.ZodNullable<z.ZodNumber>;
+                        readonly firstSeen: z.ZodNullable<z.ZodString>;
+                        readonly lostDate: z.ZodNullable<z.ZodString>;
+                        /** 90-day referral sessions from this domain, or null when no Web Analytics property is linked. */
+                        readonly sessions: z.ZodNullable<z.ZodNumber>;
+                    }, z.core.$strip>>;
+                    readonly total: z.ZodNumber;
+                    readonly limit: z.ZodNumber;
+                    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 target: z.ZodString;
+                    readonly items: z.ZodArray<z.ZodObject<{
+                        readonly domain: z.ZodString;
+                        readonly rank: z.ZodNullable<z.ZodNumber>;
+                        readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                        readonly brokenBacklinks: z.ZodNullable<z.ZodNumber>;
+                        readonly brokenPages: z.ZodNullable<z.ZodNumber>;
+                        readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                        readonly spamScore: z.ZodNullable<z.ZodNumber>;
+                        readonly firstSeen: z.ZodNullable<z.ZodString>;
+                        readonly lostDate: z.ZodNullable<z.ZodString>;
+                        readonly sessions: z.ZodNullable<z.ZodNumber>;
+                    }, z.core.$strip>>;
+                    readonly total: z.ZodNumber;
+                    readonly limit: z.ZodNumber;
+                    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: 'List referring domains';
+            readonly description: 'Returns the domains that link to the Site, highest authority first, with spam score and broken-link counts. When a Web Analytics property is linked, each row also carries its 90-day referral sessions, so a link that sends nobody is visible. Cached reads consume no units.';
+            readonly tags: readonly ["Research"];
+            readonly examples: readonly [{
+                readonly request: {
+                    readonly params: {
+                        readonly siteId: 'site_01JXYZ';
+                    };
+                    readonly query: {
+                        readonly limit: 100;
+                    };
+                };
+                readonly response: {
+                    readonly status: 200;
+                    readonly body: {
+                        readonly data: {
+                            readonly target: 'example.com';
+                            readonly items: readonly [{
+                                readonly domain: 'news.example';
+                                readonly rank: 529;
+                                readonly backlinks: 12;
+                                readonly brokenBacklinks: 0;
+                                readonly brokenPages: 0;
+                                readonly referringPages: 9;
+                                readonly spamScore: 2;
+                                readonly firstSeen: '2026-02-09 20:43:50 +00:00';
+                                readonly lostDate: null;
+                                readonly sessions: 143;
+                            }];
+                            readonly total: 1;
+                            readonly limit: 100;
+                            readonly evidence: {
+                                readonly _tag: 'cache';
+                                readonly provider: 'dataforseo';
+                                readonly spend: {
+                                    readonly key: 'dataforseo';
+                                    readonly units: 0;
+                                };
+                            };
+                        };
+                        readonly meta: {
+                            readonly requestId: 'req_01JXYZ';
+                            readonly version: '1.0';
+                        };
+                    };
+                };
+            }];
+        };
+    };
+    readonly anchors: {
+        readonly id: 'backlinks.anchors';
+        readonly method: 'GET';
+        readonly path: '/api/v1/sites/{siteId}/backlinks/anchors';
+        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<{
+                limit: 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 target: z.ZodString;
+                    readonly items: z.ZodArray<z.ZodObject<{
+                        readonly anchor: z.ZodString;
+                        readonly rank: z.ZodNullable<z.ZodNumber>;
+                        readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                        readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+                        readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+                        readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                        readonly spamScore: z.ZodNullable<z.ZodNumber>;
+                        readonly firstSeen: z.ZodNullable<z.ZodString>;
+                        readonly lostDate: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                    readonly total: z.ZodNumber;
+                    readonly limit: z.ZodNumber;
+                    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 target: z.ZodString;
+                    readonly items: z.ZodArray<z.ZodObject<{
+                        readonly anchor: z.ZodString;
+                        readonly rank: z.ZodNullable<z.ZodNumber>;
+                        readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                        readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+                        readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+                        readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                        readonly spamScore: z.ZodNullable<z.ZodNumber>;
+                        readonly firstSeen: z.ZodNullable<z.ZodString>;
+                        readonly lostDate: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>>;
+                    readonly total: z.ZodNumber;
+                    readonly limit: z.ZodNumber;
+                    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: 'List Backlink anchors';
+            readonly description: 'Returns the anchor text distribution of the Site inbound links, most linked first. Use it to find over-optimised or off-brand anchors. Cached reads consume no units.';
+            readonly tags: readonly ["Research"];
+            readonly examples: readonly [{
+                readonly request: {
+                    readonly params: {
+                        readonly siteId: 'site_01JXYZ';
+                    };
+                    readonly query: {
+                        readonly limit: 100;
+                    };
+                };
+                readonly response: {
+                    readonly status: 200;
+                    readonly body: {
+                        readonly data: {
+                            readonly target: 'example.com';
+                            readonly items: readonly [{
+                                readonly anchor: 'nuxt seo';
+                                readonly rank: 480;
+                                readonly backlinks: 212;
+                                readonly referringDomains: 64;
+                                readonly referringMainDomains: 60;
+                                readonly referringPages: 190;
+                                readonly spamScore: 3;
+                                readonly firstSeen: '2026-01-04 11:02:11 +00:00';
+                                readonly lostDate: null;
+                            }];
+                            readonly total: 1;
+                            readonly limit: 100;
+                            readonly evidence: {
+                                readonly _tag: 'cache';
+                                readonly provider: 'dataforseo';
+                                readonly spend: {
+                                    readonly key: 'dataforseo';
+                                    readonly units: 0;
+                                };
+                            };
+                        };
+                        readonly meta: {
+                            readonly requestId: 'req_01JXYZ';
+                            readonly version: '1.0';
+                        };
+                    };
+                };
+            }];
+        };
+    };
+    readonly history: {
+        readonly id: 'backlinks.history';
+        readonly method: 'GET';
+        readonly path: '/api/v1/sites/{siteId}/backlinks/history';
+        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<{
+                dateFrom: z.ZodOptional<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 target: z.ZodString;
+                    readonly items: z.ZodArray<z.ZodObject<{
+                        readonly date: z.ZodString;
+                        readonly rank: z.ZodNullable<z.ZodNumber>;
+                        readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                        readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+                        readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+                        readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                        readonly newReferringDomains: z.ZodNullable<z.ZodNumber>;
+                        readonly lostReferringDomains: z.ZodNullable<z.ZodNumber>;
+                        readonly newBacklinks: z.ZodNullable<z.ZodNumber>;
+                        readonly lostBacklinks: z.ZodNullable<z.ZodNumber>;
+                    }, z.core.$strip>>;
+                    readonly total: z.ZodNumber;
+                    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 target: z.ZodString;
+                    readonly items: z.ZodArray<z.ZodObject<{
+                        readonly date: z.ZodString;
+                        readonly rank: z.ZodNullable<z.ZodNumber>;
+                        readonly backlinks: z.ZodNullable<z.ZodNumber>;
+                        readonly referringDomains: z.ZodNullable<z.ZodNumber>;
+                        readonly referringMainDomains: z.ZodNullable<z.ZodNumber>;
+                        readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                        readonly newReferringDomains: z.ZodNullable<z.ZodNumber>;
+                        readonly lostReferringDomains: z.ZodNullable<z.ZodNumber>;
+                        readonly newBacklinks: z.ZodNullable<z.ZodNumber>;
+                        readonly lostBacklinks: z.ZodNullable<z.ZodNumber>;
+                    }, z.core.$strip>>;
+                    readonly total: z.ZodNumber;
+                    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: 'Get Backlinks history';
+            readonly description: 'Returns a monthly series of inbound link totals with the domains gained and lost in each month. It defaults to about twelve months; pass dateFrom for a longer window. Cached reads consume no units.';
+            readonly tags: readonly ["Research"];
+            readonly examples: readonly [{
+                readonly request: {
+                    readonly params: {
+                        readonly siteId: 'site_01JXYZ';
+                    };
+                    readonly query: {
+                        readonly dateFrom: '2026-01-01';
+                    };
+                };
+                readonly response: {
+                    readonly status: 200;
+                    readonly body: {
+                        readonly data: {
+                            readonly target: 'example.com';
+                            readonly items: readonly [{
+                                readonly date: '2026-08-01';
+                                readonly rank: 214;
+                                readonly backlinks: 5120;
+                                readonly referringDomains: 412;
+                                readonly referringMainDomains: 388;
+                                readonly referringPages: 4800;
+                                readonly newReferringDomains: 18;
+                                readonly lostReferringDomains: 4;
+                                readonly newBacklinks: 210;
+                                readonly lostBacklinks: 62;
+                            }];
+                            readonly total: 1;
+                            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';
+                        };
+                    };
+                };
+            }];
+        };
+    };
+}>;