backlinks_bulk_backlinks
Get total backlink counts for up to 1000 domains, subdomains, or webpages. Analyze referring links with all attributes including nofollow, noreferrer, ugc, and sponsored tags from live backlink data.
Instructions
This endpoint will provide you with the number of backlinks pointing to domains, subdomains, and pages specified in the targets array. The returned numbers correspond to all live backlinks, that is, total number of referring links with all attributes (e.g., nofollow, noreferrer, ugc, sponsored etc) that were found during the latest check. Note that if you indicate a domain as a target, you will get results for the root domain (domain with all of its subdomains), e.g. dataforseo.com and app.dataforseo.com
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| targets | Yes | domains, subdomains or webpages to get rank for required field you can set up to 1000 domains, subdomains or webpages the domain or subdomain should be specified without https:// and www. the page should be specified with absolute URL (including http:// or https://) example: "targets": [ "forbes.com", "cnn.com", "bbc.com", "yelp.com", "https://www.apple.com/iphone/", "https://ahrefs.com/blog/", "ibm.com", "https://variety.com/", "https://stackoverflow.com/", "www.trustpilot.com" ] |
Implementation Reference
- The core handler function that performs the API request to DataForSEO's /v3/backlinks/bulk_backlinks/live endpoint using the provided targets array.
async handle(params: any): Promise<any> { try { const response = await this.client.makeRequest('/v3/backlinks/bulk_backlinks/live', 'POST', [{ targets: params.targets }]); return this.validateAndFormatResponse(response); } catch (error) { return this.formatErrorResponse(error); } } - Zod schema defining the input parameters: 'targets' as an array of strings (domains, subdomains, or full URLs). Includes detailed description and example.
return { targets: z.array(z.string()).describe(`domains, subdomains or webpages to get rank for required field you can set up to 1000 domains, subdomains or webpages the domain or subdomain should be specified without https:// and www. the page should be specified with absolute URL (including http:// or https://) example: "targets": [ "forbes.com", "cnn.com", "bbc.com", "yelp.com", "https://www.apple.com/iphone/", "https://ahrefs.com/blog/", "ibm.com", "https://variety.com/", "https://stackoverflow.com/", "www.trustpilot.com" ]`) }; } - src/core/modules/backlinks/backlinks-api.module.ts:35-35 (registration)Instantiation of the BacklinksBulkBacklinksTool within the BacklinksApiModule's getTools() method, which registers it by name via tool.getName().
new BacklinksBulkBacklinksTool(this.dataForSEOClient), - src/core/modules/backlinks/backlinks-api.module.ts:7-7 (registration)Import of the BacklinksBulkBacklinksTool class necessary for its registration in the module.
import { BacklinksBulkBacklinksTool } from './tools/backlinks-bulk-backlinks.tool.js'; - The getName() method that returns the exact tool name 'backlinks_bulk_backlinks' used for registration.
getName(): string { return 'backlinks_bulk_backlinks'; }