@nuxtseo/protocol 0.4.0 → 0.5.0

package/dist/v1/backlinks.d.ts

@@ -1201,6 +1201,47 @@ export declare const mentionsV1Registry: import("./core.js").PublicV1Registry<{
 export declare const liveBacklinksQuerySchema: z.ZodObject<{
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strict>;
+/**
+ * A Link Spam Network: referring domains that each place one generated anchor
+ * with the Site's host written into it, one link per domain. It is read from
+ * the retained Backlinks rows, never from `spamScore`. Google ignores most
+ * links like these, so the summary counts them apart from the profile.
+ */
+export declare const linkSpamNetworkSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    /** Stable for one anchor template on one Site. */
+    readonly id: z.ZodString;
+    /** The anchor as the provider reported it, with the Site's host in it. */
+    readonly anchor: z.ZodString;
+    readonly referringDomains: z.ZodNumber;
+    readonly backlinks: z.ZodNumber;
+    /** When the provider first saw the anchor. */
+    readonly firstSeen: z.ZodNullable<z.ZodString>;
+    /** When the newest sampled member domain was first seen. */
+    readonly latestSeen: z.ZodNullable<z.ZodString>;
+    /** The linking page path every sampled member shares, or null when they differ. */
+    readonly linkingPath: z.ZodNullable<z.ZodString>;
+    /** Paths on the Site that the sampled members link to, most linked first. */
+    readonly targetPaths: z.ZodArray<z.ZodString>;
+    /** Other Sites whose anchors carry the same template. */
+    readonly otherSites: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    /** Stable for one anchor template on one Site. */
+    readonly id: z.ZodString;
+    /** The anchor as the provider reported it, with the Site's host in it. */
+    readonly anchor: z.ZodString;
+    readonly referringDomains: z.ZodNumber;
+    readonly backlinks: z.ZodNumber;
+    /** When the provider first saw the anchor. */
+    readonly firstSeen: z.ZodNullable<z.ZodString>;
+    /** When the newest sampled member domain was first seen. */
+    readonly latestSeen: z.ZodNullable<z.ZodString>;
+    /** The linking page path every sampled member shares, or null when they differ. */
+    readonly linkingPath: z.ZodNullable<z.ZodString>;
+    /** Paths on the Site that the sampled members link to, most linked first. */
+    readonly targetPaths: z.ZodArray<z.ZodString>;
+    /** Other Sites whose anchors carry the same template. */
+    readonly otherSites: z.ZodNumber;
+}, z.core.$strip>>;
 export declare const backlinksSummaryDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
     readonly target: z.ZodString;
     readonly rank: z.ZodNullable<z.ZodNumber>;
@@ -1215,6 +1256,41 @@ export declare const backlinksSummaryDataSchema: import("./core.js").CompatibleR
     readonly referringIps: z.ZodNullable<z.ZodNumber>;
     readonly referringSubnets: z.ZodNullable<z.ZodNumber>;
     readonly referringPages: z.ZodNullable<z.ZodNumber>;
+    /**
+     * The Site's Link Spam Networks, largest first. Empty for most Sites. The
+     * counts above still include them.
+     *
+     * A producer must send it and `withoutLinkSpamNetworks`. A client treats
+     * both as optional, because a client newer than the deployed server reads
+     * answers that predate the fields.
+     */
+    readonly linkSpamNetworks: z.ZodArray<z.ZodObject<{
+        /** Stable for one anchor template on one Site. */
+        readonly id: z.ZodString;
+        /** The anchor as the provider reported it, with the Site's host in it. */
+        readonly anchor: z.ZodString;
+        readonly referringDomains: z.ZodNumber;
+        readonly backlinks: z.ZodNumber;
+        /** When the provider first saw the anchor. */
+        readonly firstSeen: z.ZodNullable<z.ZodString>;
+        /** When the newest sampled member domain was first seen. */
+        readonly latestSeen: z.ZodNullable<z.ZodString>;
+        /** The linking page path every sampled member shares, or null when they differ. */
+        readonly linkingPath: z.ZodNullable<z.ZodString>;
+        /** Paths on the Site that the sampled members link to, most linked first. */
+        readonly targetPaths: z.ZodArray<z.ZodString>;
+        /** Other Sites whose anchors carry the same template. */
+        readonly otherSites: z.ZodNumber;
+    }, z.core.$strip>>;
+    /**
+     * `referringDomains` and `backlinks` without the networks. Null when the
+     * Site has no network, or when the provider returned no total to subtract
+     * from.
+     */
+    readonly withoutLinkSpamNetworks: z.ZodNullable<z.ZodObject<{
+        readonly referringDomains: z.ZodNumber;
+        readonly backlinks: z.ZodNumber;
+    }, z.core.$strip>>;
     readonly evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
         _tag: z.ZodLiteral<"no-provider">;
         provider: z.ZodNull;
@@ -1251,6 +1327,28 @@ export declare const backlinksSummaryDataSchema: import("./core.js").CompatibleR
     readonly referringIps: z.ZodNullable<z.ZodNumber>;
     readonly referringSubnets: z.ZodNullable<z.ZodNumber>;
     readonly referringPages: z.ZodNullable<z.ZodNumber>;
+    readonly linkSpamNetworks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Stable for one anchor template on one Site. */
+        readonly id: z.ZodString;
+        /** The anchor as the provider reported it, with the Site's host in it. */
+        readonly anchor: z.ZodString;
+        readonly referringDomains: z.ZodNumber;
+        readonly backlinks: z.ZodNumber;
+        /** When the provider first saw the anchor. */
+        readonly firstSeen: z.ZodNullable<z.ZodString>;
+        /** When the newest sampled member domain was first seen. */
+        readonly latestSeen: z.ZodNullable<z.ZodString>;
+        /** The linking page path every sampled member shares, or null when they differ. */
+        readonly linkingPath: z.ZodNullable<z.ZodString>;
+        /** Paths on the Site that the sampled members link to, most linked first. */
+        readonly targetPaths: z.ZodArray<z.ZodString>;
+        /** Other Sites whose anchors carry the same template. */
+        readonly otherSites: z.ZodNumber;
+    }, z.core.$strip>>>;
+    readonly withoutLinkSpamNetworks: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        readonly referringDomains: z.ZodNumber;
+        readonly backlinks: z.ZodNumber;
+    }, z.core.$strip>>>;
     readonly evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
         _tag: z.ZodLiteral<"no-provider">;
         provider: z.ZodNull;
@@ -1289,6 +1387,41 @@ export declare const backlinksSummaryResponseSchema: import("./core.js").Compati
         readonly referringIps: z.ZodNullable<z.ZodNumber>;
         readonly referringSubnets: z.ZodNullable<z.ZodNumber>;
         readonly referringPages: z.ZodNullable<z.ZodNumber>;
+        /**
+         * The Site's Link Spam Networks, largest first. Empty for most Sites. The
+         * counts above still include them.
+         *
+         * A producer must send it and `withoutLinkSpamNetworks`. A client treats
+         * both as optional, because a client newer than the deployed server reads
+         * answers that predate the fields.
+         */
+        readonly linkSpamNetworks: z.ZodArray<z.ZodObject<{
+            /** Stable for one anchor template on one Site. */
+            readonly id: z.ZodString;
+            /** The anchor as the provider reported it, with the Site's host in it. */
+            readonly anchor: z.ZodString;
+            readonly referringDomains: z.ZodNumber;
+            readonly backlinks: z.ZodNumber;
+            /** When the provider first saw the anchor. */
+            readonly firstSeen: z.ZodNullable<z.ZodString>;
+            /** When the newest sampled member domain was first seen. */
+            readonly latestSeen: z.ZodNullable<z.ZodString>;
+            /** The linking page path every sampled member shares, or null when they differ. */
+            readonly linkingPath: z.ZodNullable<z.ZodString>;
+            /** Paths on the Site that the sampled members link to, most linked first. */
+            readonly targetPaths: z.ZodArray<z.ZodString>;
+            /** Other Sites whose anchors carry the same template. */
+            readonly otherSites: z.ZodNumber;
+        }, z.core.$strip>>;
+        /**
+         * `referringDomains` and `backlinks` without the networks. Null when the
+         * Site has no network, or when the provider returned no total to subtract
+         * from.
+         */
+        readonly withoutLinkSpamNetworks: z.ZodNullable<z.ZodObject<{
+            readonly referringDomains: z.ZodNumber;
+            readonly backlinks: z.ZodNumber;
+        }, z.core.$strip>>;
         readonly evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
             _tag: z.ZodLiteral<"no-provider">;
             provider: z.ZodNull;
@@ -1331,6 +1464,28 @@ export declare const backlinksSummaryResponseSchema: import("./core.js").Compati
         readonly referringIps: z.ZodNullable<z.ZodNumber>;
         readonly referringSubnets: z.ZodNullable<z.ZodNumber>;
         readonly referringPages: z.ZodNullable<z.ZodNumber>;
+        readonly linkSpamNetworks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            /** Stable for one anchor template on one Site. */
+            readonly id: z.ZodString;
+            /** The anchor as the provider reported it, with the Site's host in it. */
+            readonly anchor: z.ZodString;
+            readonly referringDomains: z.ZodNumber;
+            readonly backlinks: z.ZodNumber;
+            /** When the provider first saw the anchor. */
+            readonly firstSeen: z.ZodNullable<z.ZodString>;
+            /** When the newest sampled member domain was first seen. */
+            readonly latestSeen: z.ZodNullable<z.ZodString>;
+            /** The linking page path every sampled member shares, or null when they differ. */
+            readonly linkingPath: z.ZodNullable<z.ZodString>;
+            /** Paths on the Site that the sampled members link to, most linked first. */
+            readonly targetPaths: z.ZodArray<z.ZodString>;
+            /** Other Sites whose anchors carry the same template. */
+            readonly otherSites: z.ZodNumber;
+        }, z.core.$strip>>>;
+        readonly withoutLinkSpamNetworks: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            readonly referringDomains: z.ZodNumber;
+            readonly backlinks: z.ZodNumber;
+        }, z.core.$strip>>>;
         readonly evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
             _tag: z.ZodLiteral<"no-provider">;
             provider: z.ZodNull;
@@ -1360,6 +1515,8 @@ export declare const backlinksSummaryResponseSchema: import("./core.js").Compati
     }, z.core.$loose>;
 }, z.core.$strip>>;
 export type BacklinksSummary = z.output<typeof backlinksSummaryDataSchema.producer>;
+/** What a consumer receives. See `PageInspectData` for why it is looser. */
+export type BacklinksSummaryData = z.output<typeof backlinksSummaryDataSchema.client>;
 export declare const backlinksSummaryOperation: {
     readonly id: 'backlinks.summary';
     readonly method: 'GET';
@@ -1401,6 +1558,41 @@ export declare const backlinksSummaryOperation: {
                 readonly referringIps: z.ZodNullable<z.ZodNumber>;
                 readonly referringSubnets: z.ZodNullable<z.ZodNumber>;
                 readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                /**
+                 * The Site's Link Spam Networks, largest first. Empty for most Sites. The
+                 * counts above still include them.
+                 *
+                 * A producer must send it and `withoutLinkSpamNetworks`. A client treats
+                 * both as optional, because a client newer than the deployed server reads
+                 * answers that predate the fields.
+                 */
+                readonly linkSpamNetworks: z.ZodArray<z.ZodObject<{
+                    /** Stable for one anchor template on one Site. */
+                    readonly id: z.ZodString;
+                    /** The anchor as the provider reported it, with the Site's host in it. */
+                    readonly anchor: z.ZodString;
+                    readonly referringDomains: z.ZodNumber;
+                    readonly backlinks: z.ZodNumber;
+                    /** When the provider first saw the anchor. */
+                    readonly firstSeen: z.ZodNullable<z.ZodString>;
+                    /** When the newest sampled member domain was first seen. */
+                    readonly latestSeen: z.ZodNullable<z.ZodString>;
+                    /** The linking page path every sampled member shares, or null when they differ. */
+                    readonly linkingPath: z.ZodNullable<z.ZodString>;
+                    /** Paths on the Site that the sampled members link to, most linked first. */
+                    readonly targetPaths: z.ZodArray<z.ZodString>;
+                    /** Other Sites whose anchors carry the same template. */
+                    readonly otherSites: z.ZodNumber;
+                }, z.core.$strip>>;
+                /**
+                 * `referringDomains` and `backlinks` without the networks. Null when the
+                 * Site has no network, or when the provider returned no total to subtract
+                 * from.
+                 */
+                readonly withoutLinkSpamNetworks: z.ZodNullable<z.ZodObject<{
+                    readonly referringDomains: z.ZodNumber;
+                    readonly backlinks: z.ZodNumber;
+                }, z.core.$strip>>;
                 readonly evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     _tag: z.ZodLiteral<"no-provider">;
                     provider: z.ZodNull;
@@ -1443,6 +1635,28 @@ export declare const backlinksSummaryOperation: {
                 readonly referringIps: z.ZodNullable<z.ZodNumber>;
                 readonly referringSubnets: z.ZodNullable<z.ZodNumber>;
                 readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                readonly linkSpamNetworks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    /** Stable for one anchor template on one Site. */
+                    readonly id: z.ZodString;
+                    /** The anchor as the provider reported it, with the Site's host in it. */
+                    readonly anchor: z.ZodString;
+                    readonly referringDomains: z.ZodNumber;
+                    readonly backlinks: z.ZodNumber;
+                    /** When the provider first saw the anchor. */
+                    readonly firstSeen: z.ZodNullable<z.ZodString>;
+                    /** When the newest sampled member domain was first seen. */
+                    readonly latestSeen: z.ZodNullable<z.ZodString>;
+                    /** The linking page path every sampled member shares, or null when they differ. */
+                    readonly linkingPath: z.ZodNullable<z.ZodString>;
+                    /** Paths on the Site that the sampled members link to, most linked first. */
+                    readonly targetPaths: z.ZodArray<z.ZodString>;
+                    /** Other Sites whose anchors carry the same template. */
+                    readonly otherSites: z.ZodNumber;
+                }, z.core.$strip>>>;
+                readonly withoutLinkSpamNetworks: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    readonly referringDomains: z.ZodNumber;
+                    readonly backlinks: z.ZodNumber;
+                }, z.core.$strip>>>;
                 readonly evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     _tag: z.ZodLiteral<"no-provider">;
                     provider: z.ZodNull;
@@ -1548,7 +1762,7 @@ export declare const backlinksSummaryOperation: {
     };
     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 description: 'Returns whole-domain inbound link totals for the Site: backlinks, referring domains, broken counts, and the domain rank. It also lists the link spam networks in the retained rows, and the totals without them. Cached reads consume no units.';
         readonly tags: readonly ["Research"];
         readonly examples: readonly [{
             readonly request: {
@@ -1573,6 +1787,21 @@ export declare const backlinksSummaryOperation: {
                         readonly referringIps: 350;
                         readonly referringSubnets: 322;
                         readonly referringPages: 4800;
+                        readonly linkSpamNetworks: readonly [{
+                            readonly id: 'lsn_5d1c07a2';
+                            readonly anchor: 'Premium SEO Link Building Experts Helping example.com Websites Rank Higher';
+                            readonly referringDomains: 42;
+                            readonly backlinks: 42;
+                            readonly firstSeen: '2026-08-02T00:00:00.000Z';
+                            readonly latestSeen: '2026-09-20T00:00:00.000Z';
+                            readonly linkingPath: '/dir/organic-visibility-backlinks-86677';
+                            readonly targetPaths: readonly ["/"];
+                            readonly otherSites: 201;
+                        }];
+                        readonly withoutLinkSpamNetworks: {
+                            readonly referringDomains: 370;
+                            readonly backlinks: 5078;
+                        };
                         readonly evidence: {
                             readonly _tag: 'live';
                             readonly provider: 'dataforseo';
@@ -1603,6 +1832,14 @@ export declare const referringDomainSchema: import("./core.js").CompatibleRespon
     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>;
+    /**
+     * The id of the Link Spam Network this domain is a known member of, as in
+     * the summary's `linkSpamNetworks`. `null` means not known to be in one,
+     * never verified clean: membership is known only for the domains the
+     * retained rows sampled or the Timeline recorded. A producer must send it;
+     * a client treats it as optional, because older servers do not.
+     */
+    readonly linkSpamNetworkId: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     readonly domain: z.ZodString;
     readonly rank: z.ZodNullable<z.ZodNumber>;
@@ -1614,6 +1851,7 @@ export declare const referringDomainSchema: import("./core.js").CompatibleRespon
     readonly firstSeen: z.ZodNullable<z.ZodString>;
     readonly lostDate: z.ZodNullable<z.ZodString>;
     readonly sessions: z.ZodNullable<z.ZodNumber>;
+    readonly linkSpamNetworkId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>>;
 export declare const referringDomainsDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
     readonly target: z.ZodString;
@@ -1629,6 +1867,14 @@ export declare const referringDomainsDataSchema: import("./core.js").CompatibleR
         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>;
+        /**
+         * The id of the Link Spam Network this domain is a known member of, as in
+         * the summary's `linkSpamNetworks`. `null` means not known to be in one,
+         * never verified clean: membership is known only for the domains the
+         * retained rows sampled or the Timeline recorded. A producer must send it;
+         * a client treats it as optional, because older servers do not.
+         */
+        readonly linkSpamNetworkId: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
     readonly total: z.ZodNumber;
     readonly limit: z.ZodNumber;
@@ -1667,6 +1913,7 @@ export declare const referringDomainsDataSchema: import("./core.js").CompatibleR
         readonly firstSeen: z.ZodNullable<z.ZodString>;
         readonly lostDate: z.ZodNullable<z.ZodString>;
         readonly sessions: z.ZodNullable<z.ZodNumber>;
+        readonly linkSpamNetworkId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>;
     readonly total: z.ZodNumber;
     readonly limit: z.ZodNumber;
@@ -1708,6 +1955,14 @@ export declare const referringDomainsResponseSchema: import("./core.js").Compati
             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>;
+            /**
+             * The id of the Link Spam Network this domain is a known member of, as in
+             * the summary's `linkSpamNetworks`. `null` means not known to be in one,
+             * never verified clean: membership is known only for the domains the
+             * retained rows sampled or the Timeline recorded. A producer must send it;
+             * a client treats it as optional, because older servers do not.
+             */
+            readonly linkSpamNetworkId: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>>;
         readonly total: z.ZodNumber;
         readonly limit: z.ZodNumber;
@@ -1752,6 +2007,7 @@ export declare const referringDomainsResponseSchema: import("./core.js").Compati
             readonly firstSeen: z.ZodNullable<z.ZodString>;
             readonly lostDate: z.ZodNullable<z.ZodString>;
             readonly sessions: z.ZodNullable<z.ZodNumber>;
+            readonly linkSpamNetworkId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>>;
         readonly total: z.ZodNumber;
         readonly limit: z.ZodNumber;
@@ -1784,6 +2040,8 @@ export declare const referringDomainsResponseSchema: import("./core.js").Compati
     }, z.core.$loose>;
 }, z.core.$strip>>;
 export type ReferringDomains = z.output<typeof referringDomainsDataSchema.producer>;
+/** What a consumer receives. See `PageInspectData` for why it is looser. */
+export type ReferringDomainsData = z.output<typeof referringDomainsDataSchema.client>;
 export declare const referringDomainsOperation: {
     readonly id: 'backlinks.referring.domains';
     readonly method: 'GET';
@@ -1827,6 +2085,14 @@ export declare const referringDomainsOperation: {
                     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>;
+                    /**
+                     * The id of the Link Spam Network this domain is a known member of, as in
+                     * the summary's `linkSpamNetworks`. `null` means not known to be in one,
+                     * never verified clean: membership is known only for the domains the
+                     * retained rows sampled or the Timeline recorded. A producer must send it;
+                     * a client treats it as optional, because older servers do not.
+                     */
+                    readonly linkSpamNetworkId: z.ZodNullable<z.ZodString>;
                 }, z.core.$strip>>;
                 readonly total: z.ZodNumber;
                 readonly limit: z.ZodNumber;
@@ -1871,6 +2137,7 @@ export declare const referringDomainsOperation: {
                     readonly firstSeen: z.ZodNullable<z.ZodString>;
                     readonly lostDate: z.ZodNullable<z.ZodString>;
                     readonly sessions: z.ZodNullable<z.ZodNumber>;
+                    readonly linkSpamNetworkId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 }, z.core.$strip>>;
                 readonly total: z.ZodNumber;
                 readonly limit: z.ZodNumber;
@@ -1979,7 +2246,7 @@ export declare const referringDomainsOperation: {
     };
     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 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. A row that is a known member of a link spam network carries its id. Cached reads consume no units.';
         readonly tags: readonly ["Research"];
         readonly examples: readonly [{
             readonly request: {
@@ -2006,6 +2273,7 @@ export declare const referringDomainsOperation: {
                             readonly firstSeen: '2026-02-09 20:43:50 +00:00';
                             readonly lostDate: null;
                             readonly sessions: 143;
+                            readonly linkSpamNetworkId: null;
                         }];
                         readonly total: 1;
                         readonly limit: 100;
@@ -2037,6 +2305,14 @@ export declare const backlinkAnchorSchema: import("./core.js").CompatibleRespons
     readonly spamScore: z.ZodNullable<z.ZodNumber>;
     readonly firstSeen: z.ZodNullable<z.ZodString>;
     readonly lostDate: z.ZodNullable<z.ZodString>;
+    /**
+     * The id of the Link Spam Network whose generated sentence this anchor is,
+     * as in the summary's `linkSpamNetworks`. Exact, because the anchor is the
+     * evidence. `null` means not known to be in one, never verified clean. A
+     * producer must send it; a client treats it as optional, because older
+     * servers do not.
+     */
+    readonly linkSpamNetworkId: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     readonly anchor: z.ZodString;
     readonly rank: z.ZodNullable<z.ZodNumber>;
@@ -2047,6 +2323,7 @@ export declare const backlinkAnchorSchema: import("./core.js").CompatibleRespons
     readonly spamScore: z.ZodNullable<z.ZodNumber>;
     readonly firstSeen: z.ZodNullable<z.ZodString>;
     readonly lostDate: z.ZodNullable<z.ZodString>;
+    readonly linkSpamNetworkId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>>;
 export declare const backlinkAnchorsDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
     readonly target: z.ZodString;
@@ -2060,6 +2337,14 @@ export declare const backlinkAnchorsDataSchema: import("./core.js").CompatibleRe
         readonly spamScore: z.ZodNullable<z.ZodNumber>;
         readonly firstSeen: z.ZodNullable<z.ZodString>;
         readonly lostDate: z.ZodNullable<z.ZodString>;
+        /**
+         * The id of the Link Spam Network whose generated sentence this anchor is,
+         * as in the summary's `linkSpamNetworks`. Exact, because the anchor is the
+         * evidence. `null` means not known to be in one, never verified clean. A
+         * producer must send it; a client treats it as optional, because older
+         * servers do not.
+         */
+        readonly linkSpamNetworkId: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
     readonly total: z.ZodNumber;
     readonly limit: z.ZodNumber;
@@ -2097,6 +2382,7 @@ export declare const backlinkAnchorsDataSchema: import("./core.js").CompatibleRe
         readonly spamScore: z.ZodNullable<z.ZodNumber>;
         readonly firstSeen: z.ZodNullable<z.ZodString>;
         readonly lostDate: z.ZodNullable<z.ZodString>;
+        readonly linkSpamNetworkId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>;
     readonly total: z.ZodNumber;
     readonly limit: z.ZodNumber;
@@ -2136,6 +2422,14 @@ export declare const backlinkAnchorsResponseSchema: import("./core.js").Compatib
             readonly spamScore: z.ZodNullable<z.ZodNumber>;
             readonly firstSeen: z.ZodNullable<z.ZodString>;
             readonly lostDate: z.ZodNullable<z.ZodString>;
+            /**
+             * The id of the Link Spam Network whose generated sentence this anchor is,
+             * as in the summary's `linkSpamNetworks`. Exact, because the anchor is the
+             * evidence. `null` means not known to be in one, never verified clean. A
+             * producer must send it; a client treats it as optional, because older
+             * servers do not.
+             */
+            readonly linkSpamNetworkId: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>>;
         readonly total: z.ZodNumber;
         readonly limit: z.ZodNumber;
@@ -2179,6 +2473,7 @@ export declare const backlinkAnchorsResponseSchema: import("./core.js").Compatib
             readonly spamScore: z.ZodNullable<z.ZodNumber>;
             readonly firstSeen: z.ZodNullable<z.ZodString>;
             readonly lostDate: z.ZodNullable<z.ZodString>;
+            readonly linkSpamNetworkId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>>;
         readonly total: z.ZodNumber;
         readonly limit: z.ZodNumber;
@@ -2211,6 +2506,8 @@ export declare const backlinkAnchorsResponseSchema: import("./core.js").Compatib
     }, z.core.$loose>;
 }, z.core.$strip>>;
 export type BacklinkAnchors = z.output<typeof backlinkAnchorsDataSchema.producer>;
+/** What a consumer receives. See `PageInspectData` for why it is looser. */
+export type BacklinkAnchorsData = z.output<typeof backlinkAnchorsDataSchema.client>;
 export declare const backlinkAnchorsOperation: {
     readonly id: 'backlinks.anchors';
     readonly method: 'GET';
@@ -2252,6 +2549,14 @@ export declare const backlinkAnchorsOperation: {
                     readonly spamScore: z.ZodNullable<z.ZodNumber>;
                     readonly firstSeen: z.ZodNullable<z.ZodString>;
                     readonly lostDate: z.ZodNullable<z.ZodString>;
+                    /**
+                     * The id of the Link Spam Network whose generated sentence this anchor is,
+                     * as in the summary's `linkSpamNetworks`. Exact, because the anchor is the
+                     * evidence. `null` means not known to be in one, never verified clean. A
+                     * producer must send it; a client treats it as optional, because older
+                     * servers do not.
+                     */
+                    readonly linkSpamNetworkId: z.ZodNullable<z.ZodString>;
                 }, z.core.$strip>>;
                 readonly total: z.ZodNumber;
                 readonly limit: z.ZodNumber;
@@ -2295,6 +2600,7 @@ export declare const backlinkAnchorsOperation: {
                     readonly spamScore: z.ZodNullable<z.ZodNumber>;
                     readonly firstSeen: z.ZodNullable<z.ZodString>;
                     readonly lostDate: z.ZodNullable<z.ZodString>;
+                    readonly linkSpamNetworkId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 }, z.core.$strip>>;
                 readonly total: z.ZodNumber;
                 readonly limit: z.ZodNumber;
@@ -2403,7 +2709,7 @@ export declare const backlinkAnchorsOperation: {
     };
     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 description: 'Returns the anchor text distribution of the Site inbound links, most linked first. Use it to find over-optimised or off-brand anchors. An anchor that is the generated sentence of a link spam network carries its id. Cached reads consume no units.';
         readonly tags: readonly ["Research"];
         readonly examples: readonly [{
             readonly request: {
@@ -2429,6 +2735,7 @@ export declare const backlinkAnchorsOperation: {
                             readonly spamScore: 3;
                             readonly firstSeen: '2026-01-04 11:02:11 +00:00';
                             readonly lostDate: null;
+                            readonly linkSpamNetworkId: null;
                         }];
                         readonly total: 1;
                         readonly limit: 100;
@@ -3171,6 +3478,41 @@ export declare const backlinksV1Registry: import("./core.js").PublicV1Registry<{
                     readonly referringIps: z.ZodNullable<z.ZodNumber>;
                     readonly referringSubnets: z.ZodNullable<z.ZodNumber>;
                     readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                    /**
+                     * The Site's Link Spam Networks, largest first. Empty for most Sites. The
+                     * counts above still include them.
+                     *
+                     * A producer must send it and `withoutLinkSpamNetworks`. A client treats
+                     * both as optional, because a client newer than the deployed server reads
+                     * answers that predate the fields.
+                     */
+                    readonly linkSpamNetworks: z.ZodArray<z.ZodObject<{
+                        /** Stable for one anchor template on one Site. */
+                        readonly id: z.ZodString;
+                        /** The anchor as the provider reported it, with the Site's host in it. */
+                        readonly anchor: z.ZodString;
+                        readonly referringDomains: z.ZodNumber;
+                        readonly backlinks: z.ZodNumber;
+                        /** When the provider first saw the anchor. */
+                        readonly firstSeen: z.ZodNullable<z.ZodString>;
+                        /** When the newest sampled member domain was first seen. */
+                        readonly latestSeen: z.ZodNullable<z.ZodString>;
+                        /** The linking page path every sampled member shares, or null when they differ. */
+                        readonly linkingPath: z.ZodNullable<z.ZodString>;
+                        /** Paths on the Site that the sampled members link to, most linked first. */
+                        readonly targetPaths: z.ZodArray<z.ZodString>;
+                        /** Other Sites whose anchors carry the same template. */
+                        readonly otherSites: z.ZodNumber;
+                    }, z.core.$strip>>;
+                    /**
+                     * `referringDomains` and `backlinks` without the networks. Null when the
+                     * Site has no network, or when the provider returned no total to subtract
+                     * from.
+                     */
+                    readonly withoutLinkSpamNetworks: z.ZodNullable<z.ZodObject<{
+                        readonly referringDomains: z.ZodNumber;
+                        readonly backlinks: z.ZodNumber;
+                    }, z.core.$strip>>;
                     readonly evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
                         _tag: z.ZodLiteral<"no-provider">;
                         provider: z.ZodNull;
@@ -3213,6 +3555,28 @@ export declare const backlinksV1Registry: import("./core.js").PublicV1Registry<{
                     readonly referringIps: z.ZodNullable<z.ZodNumber>;
                     readonly referringSubnets: z.ZodNullable<z.ZodNumber>;
                     readonly referringPages: z.ZodNullable<z.ZodNumber>;
+                    readonly linkSpamNetworks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        /** Stable for one anchor template on one Site. */
+                        readonly id: z.ZodString;
+                        /** The anchor as the provider reported it, with the Site's host in it. */
+                        readonly anchor: z.ZodString;
+                        readonly referringDomains: z.ZodNumber;
+                        readonly backlinks: z.ZodNumber;
+                        /** When the provider first saw the anchor. */
+                        readonly firstSeen: z.ZodNullable<z.ZodString>;
+                        /** When the newest sampled member domain was first seen. */
+                        readonly latestSeen: z.ZodNullable<z.ZodString>;
+                        /** The linking page path every sampled member shares, or null when they differ. */
+                        readonly linkingPath: z.ZodNullable<z.ZodString>;
+                        /** Paths on the Site that the sampled members link to, most linked first. */
+                        readonly targetPaths: z.ZodArray<z.ZodString>;
+                        /** Other Sites whose anchors carry the same template. */
+                        readonly otherSites: z.ZodNumber;
+                    }, z.core.$strip>>>;
+                    readonly withoutLinkSpamNetworks: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                        readonly referringDomains: z.ZodNumber;
+                        readonly backlinks: z.ZodNumber;
+                    }, z.core.$strip>>>;
                     readonly evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
                         _tag: z.ZodLiteral<"no-provider">;
                         provider: z.ZodNull;
@@ -3318,7 +3682,7 @@ export declare const backlinksV1Registry: import("./core.js").PublicV1Registry<{
         };
         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 description: 'Returns whole-domain inbound link totals for the Site: backlinks, referring domains, broken counts, and the domain rank. It also lists the link spam networks in the retained rows, and the totals without them. Cached reads consume no units.';
             readonly tags: readonly ["Research"];
             readonly examples: readonly [{
                 readonly request: {
@@ -3343,6 +3707,21 @@ export declare const backlinksV1Registry: import("./core.js").PublicV1Registry<{
                             readonly referringIps: 350;
                             readonly referringSubnets: 322;
                             readonly referringPages: 4800;
+                            readonly linkSpamNetworks: readonly [{
+                                readonly id: 'lsn_5d1c07a2';
+                                readonly anchor: 'Premium SEO Link Building Experts Helping example.com Websites Rank Higher';
+                                readonly referringDomains: 42;
+                                readonly backlinks: 42;
+                                readonly firstSeen: '2026-08-02T00:00:00.000Z';
+                                readonly latestSeen: '2026-09-20T00:00:00.000Z';
+                                readonly linkingPath: '/dir/organic-visibility-backlinks-86677';
+                                readonly targetPaths: readonly ["/"];
+                                readonly otherSites: 201;
+                            }];
+                            readonly withoutLinkSpamNetworks: {
+                                readonly referringDomains: 370;
+                                readonly backlinks: 5078;
+                            };
                             readonly evidence: {
                                 readonly _tag: 'live';
                                 readonly provider: 'dataforseo';
@@ -3404,6 +3783,14 @@ export declare const backlinksV1Registry: import("./core.js").PublicV1Registry<{
                         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>;
+                        /**
+                         * The id of the Link Spam Network this domain is a known member of, as in
+                         * the summary's `linkSpamNetworks`. `null` means not known to be in one,
+                         * never verified clean: membership is known only for the domains the
+                         * retained rows sampled or the Timeline recorded. A producer must send it;
+                         * a client treats it as optional, because older servers do not.
+                         */
+                        readonly linkSpamNetworkId: z.ZodNullable<z.ZodString>;
                     }, z.core.$strip>>;
                     readonly total: z.ZodNumber;
                     readonly limit: z.ZodNumber;
@@ -3448,6 +3835,7 @@ export declare const backlinksV1Registry: import("./core.js").PublicV1Registry<{
                         readonly firstSeen: z.ZodNullable<z.ZodString>;
                         readonly lostDate: z.ZodNullable<z.ZodString>;
                         readonly sessions: z.ZodNullable<z.ZodNumber>;
+                        readonly linkSpamNetworkId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                     }, z.core.$strip>>;
                     readonly total: z.ZodNumber;
                     readonly limit: z.ZodNumber;
@@ -3556,7 +3944,7 @@ export declare const backlinksV1Registry: import("./core.js").PublicV1Registry<{
         };
         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 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. A row that is a known member of a link spam network carries its id. Cached reads consume no units.';
             readonly tags: readonly ["Research"];
             readonly examples: readonly [{
                 readonly request: {
@@ -3583,6 +3971,7 @@ export declare const backlinksV1Registry: import("./core.js").PublicV1Registry<{
                                 readonly firstSeen: '2026-02-09 20:43:50 +00:00';
                                 readonly lostDate: null;
                                 readonly sessions: 143;
+                                readonly linkSpamNetworkId: null;
                             }];
                             readonly total: 1;
                             readonly limit: 100;
@@ -3645,6 +4034,14 @@ export declare const backlinksV1Registry: import("./core.js").PublicV1Registry<{
                         readonly spamScore: z.ZodNullable<z.ZodNumber>;
                         readonly firstSeen: z.ZodNullable<z.ZodString>;
                         readonly lostDate: z.ZodNullable<z.ZodString>;
+                        /**
+                         * The id of the Link Spam Network whose generated sentence this anchor is,
+                         * as in the summary's `linkSpamNetworks`. Exact, because the anchor is the
+                         * evidence. `null` means not known to be in one, never verified clean. A
+                         * producer must send it; a client treats it as optional, because older
+                         * servers do not.
+                         */
+                        readonly linkSpamNetworkId: z.ZodNullable<z.ZodString>;
                     }, z.core.$strip>>;
                     readonly total: z.ZodNumber;
                     readonly limit: z.ZodNumber;
@@ -3688,6 +4085,7 @@ export declare const backlinksV1Registry: import("./core.js").PublicV1Registry<{
                         readonly spamScore: z.ZodNullable<z.ZodNumber>;
                         readonly firstSeen: z.ZodNullable<z.ZodString>;
                         readonly lostDate: z.ZodNullable<z.ZodString>;
+                        readonly linkSpamNetworkId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                     }, z.core.$strip>>;
                     readonly total: z.ZodNumber;
                     readonly limit: z.ZodNumber;
@@ -3796,7 +4194,7 @@ export declare const backlinksV1Registry: import("./core.js").PublicV1Registry<{
         };
         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 description: 'Returns the anchor text distribution of the Site inbound links, most linked first. Use it to find over-optimised or off-brand anchors. An anchor that is the generated sentence of a link spam network carries its id. Cached reads consume no units.';
             readonly tags: readonly ["Research"];
             readonly examples: readonly [{
                 readonly request: {
@@ -3822,6 +4220,7 @@ export declare const backlinksV1Registry: import("./core.js").PublicV1Registry<{
                                 readonly spamScore: 3;
                                 readonly firstSeen: '2026-01-04 11:02:11 +00:00';
                                 readonly lostDate: null;
+                                readonly linkSpamNetworkId: null;
                             }];
                             readonly total: 1;
                             readonly limit: 100;