Nexscope
Start free

Search & Trend Intelligence

Keyword Categories MCP Tool

Keyword Categories with explicit missing evidence and bounded keyword inputs. Uses one fixed DataForSEO task. Schema C1-1.0. Idempotent calls preserve original input order. Free owner-only retrieval: GET /api/skill-api/v1/skills/seo-keyword-categories/calls/{callId} or nexscope_seo_call_result. Results retained seven days. Missing values are not zero. No execution or publication is implied.

MCP tool name
nexscope_seo_keyword_categories
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-keyword-categories-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_seo_keyword_categories",
    "arguments": {}
  }
}
Legacy endpoint
POST /api/skill-api/v1/mcp
Canonical detail URL
https://www.nexscope.ai/mcp-map/seo-keyword-categories

Arguments

No arguments are defined for this tool.

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredDescription
dataanyrequired
Data value used by this API operation.
codeintegerrequired
0 means accepted or successful; nonzero is a platform error.
msgstring | nullrequired
Msg value used by this API operation.
tsstringrequired
Epoch milliseconds.
timestringrequired
Server local time: yyyy-MM-dd HH:mm:ss.
coststringrequired
Elapsed milliseconds, never credits; -1 outside web requests.
traceIdstring | nullrequired
Trace id value used by this API operation.

Any of option 1

NameTypeRequiredDescription
dataanyrequired
Data value used by this API operation.

One of option 1 — requires callId, status, result

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.callIdstringrequired
Call id value used by this API operation.
data.schemaVersionstringoptional
Schema version value used by this API operation.
data.statusstringrequired
Status value used by this API operation.
data.sourcestringoptional
Source value used by this API operation.
data.requestedAtstring | integer | nulloptional
Requested at value used by this API operation.
data.completedAtstring | integer | nulloptional
Completed at value used by this API operation.
data.coverageobject | nulloptional
Coverage value used by this API operation.
data.usageobject | nulloptional
Usage value used by this API operation.
data.usage.billingStatusstring | nulloptional
Billing status value used by this API operation.
data.usage.chargedCreditsstring | integer | nulloptional
Charged credits value used by this API operation.
data.resultanyrequired
Result value used by this API operation.

Any of option 1 — requires language, taxonomy, items

NameTypeRequiredDescription
data.resultobjectrequired
Result value used by this API operation.
data.result.languagestringrequired
Language value used by this API operation.
Constant: en
data.result.taxonomystringrequired
Taxonomy value used by this API operation.
Constant: google_product_service
data.result.itemsarrayrequired
Items value used by this API operation.
Minimum items: 1
Maximum items: 20
data.result.items[]objectrequired
Item in data result items.
data.result.items[].inputIndexintegerrequired
Input index value used by this API operation.
Minimum: 0
Maximum: 19
data.result.items[].inputKeywordstringrequired
Input keyword value used by this API operation.
data.result.items[].normalizedKeywordstringrequired
Normalized keyword value used by this API operation.
data.result.items[].statusstringrequired
Status value used by this API operation.
Allowed: AVAILABLE, NO_COVERAGE
data.result.items[].categoryIdsarrayrequired
Category ids value used by this API operation.
data.result.items[].categoryIds[]integerrequired
Item in data result items[] categoryIds.
Minimum: 1
Maximum: 2147483647
data.result.items[].missingarrayrequired
Missing value used by this API operation.
data.result.items[].missing[]objectrequired
Item in data result items[] missing.
data.result.items[].missing[].fieldstringrequired
Field value used by this API operation.
Minimum length: 1
data.result.items[].missing[].reasonstringrequired
Reason value used by this API operation.
Allowed: UPSTREAM_FIELD_MISSING, UPSTREAM_KEYWORD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_KEYWORD

Any of option 2

NameTypeRequiredDescription
data.resultnullrequired
Result value used by this API operation.

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

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.reasonstringrequired
Reason value used by this API operation.
data.callIdstring | nullrequired
Call id value used by this API operation.
data.statusstringrequired
Status value used by this API operation.
data.retryablebooleanrequired
Retryable value used by this API operation.
data.taskIdstring | nulloptional
Task id value used by this API operation.

Any of option 2

NameTypeRequiredDescription
datanullrequired
Data value used by this API operation.

Examples

Example arguments

{}

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
}