backlinks_referring_networks
Analyze referring networks and IP addresses linking to a target domain or webpage to identify backlink patterns and potential link farms.
Instructions
This endpoint will provide you with a detailed overview of referring domains pointing to the target you specify
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target | Yes | domain, subdomain or webpage to get backlinks for required field a domain or a subdomain should be specified without https:// and www. a page should be specified with absolute URL (including http:// or https://) | |
| network_address_type | No | indicates the type of network to get data for optional field possible values: ip, subnet default value: ip | ip |
| limit | No | the maximum number of returned networks | |
| offset | No | offset in the results array of returned networks optional field default value: 0 if you specify the 10 value, the first ten domains in the results array will be omitted and the data will be provided for the successive pages | |
| filters | No | array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and, or between the conditions the following operators are supported: regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match you can use the % operator with like and not_like to match any string of zero or more characters example: ["referring_pages",">","1"] [["referring_pages",">","2"], "and", ["backlinks",">","10"]] [["first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["network_address","like","194.1.%"],"or",["referring_ips",">","10"]]] | |
| order_by | No | results sorting rules optional field you can use the same values as in the filters array to sort the results possible sorting types: asc – results will be sorted in the ascending order desc – results will be sorted in the descending order you should use a comma to set up a sorting type example: ["backlinks,desc"] note that you can set no more than three sorting rules in a single request you should use a comma to separate several sorting rules example: ["backlinks,desc","rank,asc"] |
Implementation Reference
- The handle method implements the core tool logic: formats input parameters, makes a POST request to DataForSEO's '/v3/backlinks/referring_networks/live' endpoint, validates/formats the response or handles errors.async handle(params: any): Promise<any> { try { const response = await this.client.makeRequest('/v3/backlinks/referring_networks/live', 'POST', [{ target: params.target, limit: params.limit, offset: params.offset, filters: this.formatFilters(params.filters), order_by: this.formatOrderBy(params.order_by), network_address_type: params.network_address_type }]); return this.validateAndFormatResponse(response); } catch (error) { return this.formatErrorResponse(error); } }
- Defines the Zod schema for input parameters: target (required), network_address_type, limit, offset, filters, order_by with detailed descriptions and constraints.getParams(): z.ZodRawShape { return { target: z.string().describe(`domain, subdomain or webpage to get backlinks for required field a domain or a subdomain should be specified without https:// and www. a page should be specified with absolute URL (including http:// or https://)`), network_address_type: z.string().optional().default('ip').describe(`indicates the type of network to get data for optional field possible values: ip, subnet default value: ip`), limit: z.number().min(1).max(1000).default(10).optional().describe("the maximum number of returned networks"), offset: z.number().min(0).optional().describe( `offset in the results array of returned networks optional field default value: 0 if you specify the 10 value, the first ten domains in the results array will be omitted and the data will be provided for the successive pages` ), filters: z.array( z.union([ z.array(z.union([z.string(), z.number(), z.boolean()])).length(3), z.enum(["and", "or"]) ]) ).max(8).optional().describe( `array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and, or between the conditions the following operators are supported: regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match you can use the % operator with like and not_like to match any string of zero or more characters example: ["referring_pages",">","1"] [["referring_pages",">","2"], "and", ["backlinks",">","10"]] [["first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["network_address","like","194.1.%"],"or",["referring_ips",">","10"]]]` ), order_by: z.array(z.string()).optional().describe( `results sorting rules optional field you can use the same values as in the filters array to sort the results possible sorting types: asc – results will be sorted in the ascending order desc – results will be sorted in the descending order you should use a comma to set up a sorting type example: ["backlinks,desc"] note that you can set no more than three sorting rules in a single request you should use a comma to separate several sorting rules example: ["backlinks,desc","rank,asc"]` ), }; }
- src/core/modules/backlinks/backlinks-api.module.ts:45-45 (registration)Instantiates BacklinksReferringNetworksTool in the getTools() method of BacklinksApiModule. The tool is then registered in the returned object using its getName() as key, with description, params, and wrapped handle function.new BacklinksReferringNetworksTool(this.dataForSEOClient),
- Maps the tool name 'backlinks_referring_networks' to the API response path 'referring_networks' in TOOL_TO_FILTER_MAP, used by BacklinksFiltersTool to provide filter information for this endpoint.'backlinks_referring_networks': 'referring_networks',