Backlinks Authority

seo-backlink-history MCP Tool

Bounded calendar history values from the DataForSEO backlink index. Independently callable bulk interface sharing source facts with backlink overview. No new independent authority fact is claimed. Unknown costs remain unapproved. No pagination or extra lookup.

MCP tool name

nexscope_seo_backlink_history

Legacy MCP endpoint

/api/skill-api/v1/mcp

JSON-RPC method

tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "seo-backlink-history-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_seo_backlink_history",
    "arguments": {
      "toMonth": "2026-03",
      "fromMonth": "2026-03",
      "target": "example.com"
    }
  }
}

Legacy endpoint

POST /api/skill-api/v1/mcp

Canonical detail URL

https://www.nexscope.ai/mcp-map/seo-backlink-history

Arguments

No arguments are defined for this tool.

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`data`	`any`	required	Data value used by this API operation.
`code`	`integer`	required	0 means accepted or successful; nonzero is a platform error.
`msg`	`string \| null`	required	Msg value used by this API operation.
`ts`	`string`	required	Epoch milliseconds.
`time`	`string`	required	Server local time: yyyy-MM-dd HH:mm:ss.
`cost`	`string`	required	Elapsed milliseconds, never credits; -1 outside web requests.
`traceId`	`string \| null`	required	Trace id value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data`	`any`	required	Data value used by this API operation.

One of option 1 — requires callId, status, result

Name	Type	Required	Description
`data`	`object`	required	Data value used by this API operation.
`data.result`	`any`	required	Result value used by this API operation.
`data.callId`	`string`	required	Call id value used by this API operation.
`data.schemaVersion`	`string`	optional	Schema version value used by this API operation.
`data.status`	`string`	required	Status value used by this API operation.
`data.source`	`string`	optional	Source value used by this API operation.
`data.requestedAt`	`string \| integer \| null`	optional	Requested at value used by this API operation.
`data.completedAt`	`string \| integer \| null`	optional	Completed at value used by this API operation.
`data.coverage`	`object \| null`	optional	Coverage value used by this API operation.
`data.usage`	`object \| null`	optional	Usage value used by this API operation.
`data.usage.billingStatus`	`string \| null`	optional	Billing status value used by this API operation.
`data.usage.chargedCredits`	`string \| integer \| null`	optional	Charged credits value used by this API operation.

Any of option 1 — requires sourceProduct, sourceKind, inputTarget, normalizedTarget, returnedCount, items, missing, truncated, fromMonth, toMonth

Name	Type	Required	Description
`data.result`	`object`	required	Result value used by this API operation.
`data.result.sourceProduct`	`string`	required	Source product value used by this API operation. Constant: backlinks
`data.result.sourceKind`	`string`	required	Source kind value used by this API operation. Constant: dataforseo_backlink_index
`data.result.inputTarget`	`string`	required	Input target value used by this API operation.
`data.result.normalizedTarget`	`string`	required	Normalized target value used by this API operation.
`data.result.returnedCount`	`integer`	required	Returned count value used by this API operation. Minimum: 0
`data.result.items`	`array`	required	Items value used by this API operation. Minimum items: 0 Maximum items: 12
`data.result.items[]`	`object`	required	Item in data result items.
`data.result.items[].snapshotAt`	`integer`	required	Snapshot at value used by this API operation. Minimum: 0
`data.result.items[].month`	`string`	required	Month value used by this API operation. Pattern: ^[0-9]{4}-[0-9]{2}$
`data.result.items[].rank`	`integer \| null`	required	Rank value used by this API operation. Minimum: 0 Maximum: 1000
`data.result.items[].backlinks`	`integer \| null`	required	Backlinks value used by this API operation. Minimum: 0
`data.result.items[].crawledPages`	`integer \| null`	required	Crawled pages value used by this API operation. Minimum: 0
`data.result.items[].internalLinks`	`integer \| null`	required	Internal links value used by this API operation. Minimum: 0
`data.result.items[].externalLinks`	`integer \| null`	required	External links value used by this API operation. Minimum: 0
`data.result.items[].composition`	`object`	required	Composition value used by this API operation.
`data.result.items[].composition.brokenBacklinks`	`integer \| null`	required	Broken backlinks value used by this API operation. Minimum: 0
`data.result.items[].composition.brokenPages`	`integer \| null`	required	Broken pages value used by this API operation. Minimum: 0
`data.result.items[].composition.referringDomains`	`integer \| null`	required	Referring domains value used by this API operation. Minimum: 0
`data.result.items[].composition.referringMainDomains`	`integer \| null`	required	Referring main domains value used by this API operation. Minimum: 0
`data.result.items[].composition.referringPages`	`integer \| null`	required	Referring pages value used by this API operation. Minimum: 0
`data.result.items[].composition.referringIps`	`integer \| null`	required	Referring ips value used by this API operation. Minimum: 0
`data.result.items[].composition.referringSubnets`	`integer \| null`	required	Referring subnets value used by this API operation. Minimum: 0
`data.result.items[].composition.referringPagesNofollow`	`integer \| null`	required	Referring pages nofollow value used by this API operation. Minimum: 0
`data.result.items[].composition.linkTypes`	`object`	required	Link types value used by this API operation.
`data.result.items[].composition.linkTypes.anchor`	`integer \| null`	required	Anchor value used by this API operation. Minimum: 0
`data.result.items[].composition.linkTypes.image`	`integer \| null`	required	Image value used by this API operation. Minimum: 0
`data.result.items[].composition.linkTypes.link`	`integer \| null`	required	Link value used by this API operation. Minimum: 0
`data.result.items[].composition.linkTypes.meta`	`integer \| null`	required	Meta value used by this API operation. Minimum: 0
`data.result.items[].composition.linkTypes.canonical`	`integer \| null`	required	Canonical value used by this API operation. Minimum: 0
`data.result.items[].composition.linkTypes.alternate`	`integer \| null`	required	Alternate value used by this API operation. Minimum: 0
`data.result.items[].composition.linkTypes.redirect`	`integer \| null`	required	Redirect value used by this API operation. Minimum: 0
`data.result.items[].missing`	`array`	required	Missing value used by this API operation. Minimum items: 0
`data.result.items[].missing[]`	`object`	required	Item in data result items[] missing.
`data.result.items[].missing[].field`	`string`	required	Field value used by this API operation.
`data.result.items[].missing[].reason`	`string`	required	Reason value used by this API operation. Allowed: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM, UPSTREAM_ITEM_MISSING
`data.result.missing`	`array`	required	Missing value used by this API operation. Minimum items: 0
`data.result.missing[]`	`object`	required	Item in data result missing.
`data.result.missing[].field`	`string`	required	Field value used by this API operation.
`data.result.missing[].reason`	`string`	required	Reason value used by this API operation. Allowed: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM, UPSTREAM_ITEM_MISSING
`data.result.truncated`	`boolean`	required	Truncated value used by this API operation.
`data.result.fromMonth`	`string`	required	From month value used by this API operation.
`data.result.toMonth`	`string`	required	To month value used by this API operation.

Any of option 2

Name	Type	Required	Description
`data.result`	`null`	required	Result value used by this API operation.

One of option 2 — requires callId, status, reason, retryable

Name	Type	Required	Description
`data`	`object`	required	Data value used by this API operation.
`data.reason`	`string`	required	Reason value used by this API operation.
`data.callId`	`string \| null`	required	Call id value used by this API operation.
`data.status`	`string`	required	Status value used by this API operation.
`data.retryable`	`boolean`	required	Retryable value used by this API operation.
`data.taskId`	`string \| null`	optional	Task id value used by this API operation.

Any of option 2

Name	Type	Required	Description
`data`	`null`	required	Data value used by this API operation.

Examples

Example arguments

{
  "toMonth": "2026-03",
  "fromMonth": "2026-03",
  "target": "example.com"
}

Example structuredContent

{
  "data": {
    "status": "PROCESSING",
    "retryable": false,
    "reason": "IN_PROGRESS",
    "callId": "00000000-0000-4000-8000-000000000001"
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}

seo-backlink-history MCP Tool

Authentication

Call this MCP tool

Arguments

Response fields

Any of option 1

One of option 1 — requires callId, status, result

Any of option 1 — requires sourceProduct, sourceKind, inputTarget, normalizedTarget, returnedCount, items, missing, truncated, fromMonth, toMonth

Any of option 2

One of option 2 — requires callId, status, reason, retryable

Any of option 2

Examples

Example arguments

Example structuredContent

Related MCP tools