backlinks_bulk_spam_score
Analyze bulk domains, subdomains, and pages to determine their spam score using DataForSEO's proprietary metric, helping identify potentially harmful backlink sources.
Instructions
This endpoint will provide you with spam scores of the domains, subdomains, and pages you specified in the targets array. Spam Score is DataForSEO’s proprietary metric that indicates how “spammy” your target is on a scale from 0 to 100
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 `handle` method implements the core logic of the `backlinks_bulk_spam_score` tool, making a POST request to DataForSEO's `/v3/backlinks/bulk_spam_score/live` endpoint with the `targets` parameter and handling the response.
async handle(params: any): Promise<any> { try { const response = await this.client.makeRequest('/v3/backlinks/bulk_spam_score/live', 'POST', [{ targets: params.targets }]); return this.validateAndFormatResponse(response); } catch (error) { return this.formatErrorResponse(error); } } - Zod schema defining the input parameters for the tool: an array of strings for `targets` (domains, subdomains, or URLs).
getParams(): z.ZodRawShape { 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:11-11 (registration)Import statement for the BacklinksBulkSpamScoreTool class.
import { BacklinksBulkSpamScoreTool } from './tools/backlinks-bulk-spam-score.tool.js'; - src/core/modules/backlinks/backlinks-api.module.ts:38-38 (registration)Instantiation of the BacklinksBulkSpamScoreTool instance added to the tools list in BacklinksApiModule's `getTools()` method, which registers the tool with name from `getName()`.
new BacklinksBulkSpamScoreTool(this.dataForSEOClient), - The `getName()` method returns the exact tool name 'backlinks_bulk_spam_score' used for registration.
getName(): string { return 'backlinks_bulk_spam_score'; }