backlinks_bulk_spam_score
Assess spam scores for up to 1000 domains, subdomains, or pages using a proprietary metric on a 0-100 scale to evaluate their credibility and spam potential.
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`. It makes a POST request to DataForSEO's `/v3/backlinks/bulk_spam_score/live` endpoint with the provided targets and processes 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); } }
- Defines the input schema for the tool using Zod. The only parameter is `targets`, an array of up to 1000 domains, subdomains, or full 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:38-38 (registration)Instantiates the `BacklinksBulkSpamScoreTool` within the `getTools()` method of `BacklinksApiModule`. This tool is then registered in the tools record using its `getName()` which returns 'backlinks_bulk_spam_score_tool'.new BacklinksBulkSpamScoreTool(this.dataForSEOClient),
- The `getName()` method returns the tool's identifier 'backlinks_bulk_spam_score_tool', used during registration to map the tool to its name.getName(): string { return 'backlinks_bulk_spam_score_tool'; }
- src/core/modules/backlinks/backlinks-api.module.ts:11-11 (registration)Import statement for the `BacklinksBulkSpamScoreTool` class in the backlinks API module.import { BacklinksBulkSpamScoreTool } from './tools/backlinks-bulk-spam-score.tool.js';