Search Results Rankings

Historical Organic SERP Snapshots

Historical Organic SERP Snapshots. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.

MCP tool name

nexscope_seo_historical_serps

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-historical-serps-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_seo_historical_serps",
    "arguments": {
      "limit": 2,
      "dateTo": "2026-01-02",
      "keyword": "C++",
      "dateFrom": "2026-01-01"
    }
  }
}

Legacy endpoint

POST /api/skill-api/v1/mcp

Canonical detail URL

https://www.nexscope.ai/mcp-map/seo-historical-serps

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.

Examples

Example arguments

{
  "limit": 2,
  "dateTo": "2026-01-02",
  "keyword": "C++",
  "dateFrom": "2026-01-01"
}

Example structuredContent

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

Any of option 1 — requires keyword, normalizedKeyword, dateFrom, dateTo, market, language, sourceProduct, engine, returnedCount, sourceKind, projection, requestedResultsPerSnapshot, items, missing, truncated

Name	Type	Required	Description
`data.result`	`object`	required	Result value used by this API operation.
`data.result.keyword`	`string`	required	Keyword value used by this API operation.
`data.result.normalizedKeyword`	`string`	required	Normalized keyword value used by this API operation.
`data.result.dateFrom`	`string`	required	Date from value used by this API operation.
`data.result.dateTo`	`string`	required	Date to value used by this API operation.
`data.result.market`	`string`	required	Market value used by this API operation. Constant: US
`data.result.language`	`string`	required	Language value used by this API operation. Constant: en
`data.result.sourceProduct`	`string`	required	Source product value used by this API operation. Constant: dataforseo_labs
`data.result.engine`	`string`	required	Engine value used by this API operation. Constant: google
`data.result.returnedCount`	`integer`	required	Returned count value used by this API operation. Minimum: 0
`data.result.sourceKind`	`string`	required	Source kind value used by this API operation. Constant: historical_serp_database
`data.result.projection`	`string`	required	Projection value used by this API operation. Constant: organic
`data.result.requestedResultsPerSnapshot`	`integer`	required	Requested results per snapshot value used by this API operation. Minimum: 1 Maximum: 20
`data.result.items`	`array`	required	Items value used by this API operation. Minimum items: 0 Maximum items: 31
`data.result.items[]`	`object`	required	Item in data result items.
`data.result.items[].observedAt`	`integer`	required	Observed at value used by this API operation. Minimum: 0
`data.result.items[].checkUrl`	`string \| null`	required	Check url value used by this API operation.
`data.result.items[].correctedKeyword`	`string \| null`	required	Corrected keyword value used by this API operation.
`data.result.items[].correctionType`	`string \| null`	required	Correction type value used by this API operation. Allowed: did_you_mean, showing_results_for, no_results_found_for, null
`data.result.items[].observedSerpTypes`	`array`	required	Observed serp types value used by this API operation. Minimum items: 0 Maximum items: 10000
`data.result.items[].observedSerpTypes[]`	`string`	required	Item in data result items[] observedSerpTypes.
`data.result.items[].organicResults`	`array`	required	Organic results value used by this API operation. Minimum items: 0 Maximum items: 20
`data.result.items[].organicResults[]`	`object`	required	Item in data result items[] organicResults.
`data.result.items[].organicResults[].type`	`string`	required	Type value used by this API operation. Constant: organic
`data.result.items[].organicResults[].url`	`string`	required	Url value used by this API operation.
`data.result.items[].organicResults[].title`	`string \| null`	required	Title value used by this API operation.
`data.result.items[].organicResults[].description`	`string \| null`	required	Description value used by this API operation.
`data.result.items[].organicResults[].rankGroup`	`integer \| null`	required	Rank group value used by this API operation. Minimum: 1
`data.result.items[].organicResults[].rankAbsolute`	`integer \| null`	required	Rank absolute value used by this API operation. Minimum: 1
`data.result.items[].organicResults[].missing`	`array`	required	Missing value used by this API operation. Minimum items: 0
`data.result.items[].organicResults[].missing[]`	`object`	required	Item in data result items[] organicResults[] missing.
`data.result.items[].organicResults[].missing[].field`	`string`	required	Field value used by this API operation.
`data.result.items[].organicResults[].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.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.

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.taskId`	`string \| null`	optional	Task id value used by this API operation.
`data.retryable`	`boolean`	required	Retryable value used by this API operation.
`data.status`	`string`	required	Status value used by this API operation.
`data.callId`	`string \| null`	required	Call id value used by this API operation.

Historical Organic SERP Snapshots

Historical Organic SERP Snapshots

Authentication

Call this MCP tool

Arguments

Response fields

Any of option 1

One of option 1 — requires callId, status, result

Examples

Example arguments

Example structuredContent

Related MCP tools

Any of option 1 — requires keyword, normalizedKeyword, dateFrom, dateTo, market, language, sourceProduct, engine, returnedCount, sourceKind, projection, requestedResultsPerSnapshot, items, missing, truncated

Any of option 2

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

Any of option 2