Nexscope
Start free

Ai Search Citations

seo-ai-top-brand-categories MCP Tool

ChatGPT database brand categories with provider category labels. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.

MCP tool name
nexscope_seo_ai_top_brand_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-ai-top-brand-categories-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_seo_ai_top_brand_categories",
    "arguments": {
      "target": [
        {
          "kind": "DOMAIN",
          "domain": " Example.COM "
        },
        {
          "kind": "KEYWORD",
          "keyword": " Shoes "
        }
      ]
    }
  }
}
Legacy endpoint
POST /api/skill-api/v1/mcp
Canonical detail URL
https://www.nexscope.ai/mcp-map/seo-ai-top-brand-categories

Arguments

NameTypeRequiredDescription
targetarrayrequired
Target value used by this API operation.
Minimum items: 1
Maximum items: 10
target[]anyrequired
Item in target.
marketstringoptional
Market value used by this API operation.
Constant: US
Default: US
languagestringoptional
Language value used by this API operation.
Constant: en
Default: en
platformstringoptional
Platform value used by this API operation.
Allowed: chat_gpt
Default: chat_gpt
limitintegeroptional
Limit value used by this API operation.
Default: 10
Minimum: 1
Maximum: 20

One of option 1 — requires kind, domain

NameTypeRequiredDescription
target[]objectrequired
Item in target.
target[].kindstringrequired
Kind value used by this API operation.
Constant: DOMAIN
target[].domainstringrequired
Normalized ASCII hostname at most63 characters.
Minimum length: 1
target[].searchFilterstringoptional
Search filter value used by this API operation.
Allowed: include, exclude
Default: include
target[].includeSubdomainsbooleanoptional
Include subdomains value used by this API operation.
Default: false

One of option 2 — requires kind, keyword

NameTypeRequiredDescription
target[]objectrequired
Item in target.
target[].kindstringrequired
Kind value used by this API operation.
Constant: KEYWORD
target[].keywordstringrequired
Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus.
Minimum length: 1
target[].searchFilterstringoptional
Search filter value used by this API operation.
Allowed: include, exclude
Default: include
target[].matchTypestringoptional
Match type value used by this API operation.
Allowed: word_match, partial_match
Default: word_match

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.resultanyrequired
Result 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.

Any of option 1 — requires market, language, sourceProduct, sourceKind, context, returnedCount, truncated, missing, summary, totalCount, items

NameTypeRequiredDescription
data.resultobjectrequired
Result value used by this API operation.
data.result.marketstringrequired
Market value used by this API operation.
Constant: US
data.result.languagestringrequired
Language value used by this API operation.
Constant: en
data.result.sourceProductstringrequired
Source product value used by this API operation.
Constant: ai_optimization
data.result.sourceKindstringrequired
Source kind value used by this API operation.
Constant: llm_mentions_database
data.result.contextobjectrequired
Context value used by this API operation.
data.result.context.inputTargetsarrayrequired
Input targets value used by this API operation.
Minimum items: 1
Maximum items: 10
data.result.context.inputTargets[]anyrequired
Item in data result context inputTargets.
data.result.context.normalizedTargetsarrayrequired
Normalized targets value used by this API operation.
Minimum items: 1
Maximum items: 10
data.result.context.normalizedTargets[]anyrequired
Item in data result context normalizedTargets.
data.result.context.platformstringrequired
Platform value used by this API operation.
Allowed: chat_gpt
Default: chat_gpt
data.result.context.domainSearchScopestringrequired
Domain search scope value used by this API operation.
Constant: sources
data.result.context.keywordSearchScopestringrequired
Keyword search scope value used by this API operation.
Constant: answer
data.result.context.unsupportedDimensionsarrayrequired
Unsupported dimensions value used by this API operation.
Minimum items: 0
Maximum items: 3
data.result.context.unsupportedDimensions[]stringrequired
Item in data result context unsupportedDimensions.
Allowed: searchResultDomains, brands, brandCategories
data.result.context.orderingstringrequired
Ordering value used by this API operation.
Constant: provider_default
data.result.context.taxonomystringrequired
Taxonomy value used by this API operation.
Constant: provider_brand_entities
data.result.returnedCountintegerrequired
Returned count value used by this API operation.
Minimum: 0
data.result.truncatedbooleanrequired
Truncated value used by this API operation.
data.result.missingarrayrequired
Missing value used by this API operation.
Minimum items: 0
data.result.missing[]objectrequired
Item in data result missing.
data.result.missing[].fieldstringrequired
Field value used by this API operation.
data.result.missing[].reasonstringrequired
Reason value used by this API operation.
Allowed: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM, UPSTREAM_ITEM_MISSING
data.result.summaryobjectrequired
Summary value used by this API operation.
data.result.summary.totalobjectrequired
Total value used by this API operation.
data.result.summary.total.mentionsinteger | nullrequired
Mentions value used by this API operation.
Minimum: 0
data.result.summary.total.aiSearchVolumeinteger | nullrequired
Ai search volume value used by this API operation.
Minimum: 0
data.result.summary.sourceDomainsarray | nullrequired
Source domains value used by this API operation.
Minimum items: 0
Maximum items: 10
data.result.summary.sourceDomains[]objectrequired
Item in data result summary sourceDomains.
data.result.summary.sourceDomains[].domainstringrequired
Domain value used by this API operation.
data.result.summary.sourceDomains[].countsobjectrequired
Counts value used by this API operation.
data.result.summary.sourceDomains[].counts.mentionsinteger | nullrequired
Mentions value used by this API operation.
Minimum: 0
data.result.summary.sourceDomains[].counts.aiSearchVolumeinteger | nullrequired
Ai search volume value used by this API operation.
Minimum: 0
data.result.summary.searchResultDomainsarray | nullrequired
Search result domains value used by this API operation.
Minimum items: 0
Maximum items: 10
data.result.summary.searchResultDomains[]objectrequired
Item in data result summary searchResultDomains.
data.result.summary.searchResultDomains[].domainstringrequired
Domain value used by this API operation.
data.result.summary.searchResultDomains[].countsobjectrequired
Counts value used by this API operation.
data.result.summary.searchResultDomains[].counts.mentionsinteger | nullrequired
Mentions value used by this API operation.
Minimum: 0
data.result.summary.searchResultDomains[].counts.aiSearchVolumeinteger | nullrequired
Ai search volume value used by this API operation.
Minimum: 0
data.result.summary.brandsarray | nullrequired
Brands value used by this API operation.
Minimum items: 0
Maximum items: 10
data.result.summary.brands[]objectrequired
Item in data result summary brands.
data.result.summary.brands[].valuestringrequired
Value value used by this API operation.
data.result.summary.brands[].countsobjectrequired
Counts value used by this API operation.
data.result.summary.brands[].counts.mentionsinteger | nullrequired
Mentions value used by this API operation.
Minimum: 0
data.result.summary.brands[].counts.aiSearchVolumeinteger | nullrequired
Ai search volume value used by this API operation.
Minimum: 0
data.result.summary.brandCategoriesarray | nullrequired
Brand categories value used by this API operation.
Minimum items: 0
Maximum items: 10
data.result.summary.brandCategories[]objectrequired
Item in data result summary brandCategories.
data.result.summary.brandCategories[].valuestringrequired
Value value used by this API operation.
data.result.summary.brandCategories[].countsobjectrequired
Counts value used by this API operation.
data.result.summary.brandCategories[].counts.mentionsinteger | nullrequired
Mentions value used by this API operation.
Minimum: 0
data.result.summary.brandCategories[].counts.aiSearchVolumeinteger | nullrequired
Ai search volume value used by this API operation.
Minimum: 0
data.result.totalCountinteger | nullrequired
Total count value used by this API operation.
Minimum: 0
data.result.itemsarrayrequired
Items value used by this API operation.
Minimum items: 0
Maximum items: 20
data.result.items[]objectrequired
Item in data result items.
data.result.items[].brandCategorystringrequired
Brand category value used by this API operation.
data.result.items[].metricsobjectrequired
Metrics value used by this API operation.
data.result.items[].metrics.totalobjectrequired
Total value used by this API operation.
data.result.items[].metrics.total.mentionsinteger | nullrequired
Mentions value used by this API operation.
Minimum: 0
data.result.items[].metrics.total.aiSearchVolumeinteger | nullrequired
Ai search volume value used by this API operation.
Minimum: 0
data.result.items[].metrics.sourceDomainsarray | nullrequired
Source domains value used by this API operation.
Minimum items: 0
Maximum items: 10
data.result.items[].metrics.sourceDomains[]objectrequired
Item in data result items[] metrics sourceDomains.
data.result.items[].metrics.sourceDomains[].domainstringrequired
Domain value used by this API operation.
data.result.items[].metrics.sourceDomains[].countsobjectrequired
Counts value used by this API operation.
data.result.items[].metrics.sourceDomains[].counts.mentionsinteger | nullrequired
Mentions value used by this API operation.
Minimum: 0
data.result.items[].metrics.sourceDomains[].counts.aiSearchVolumeinteger | nullrequired
Ai search volume value used by this API operation.
Minimum: 0
data.result.items[].metrics.searchResultDomainsarray | nullrequired
Search result domains value used by this API operation.
Minimum items: 0
Maximum items: 10
data.result.items[].metrics.searchResultDomains[]objectrequired
Item in data result items[] metrics searchResultDomains.
data.result.items[].metrics.searchResultDomains[].domainstringrequired
Domain value used by this API operation.
data.result.items[].metrics.searchResultDomains[].countsobjectrequired
Counts value used by this API operation.
data.result.items[].metrics.searchResultDomains[].counts.mentionsinteger | nullrequired
Mentions value used by this API operation.
Minimum: 0
data.result.items[].metrics.searchResultDomains[].counts.aiSearchVolumeinteger | nullrequired
Ai search volume value used by this API operation.
Minimum: 0
data.result.items[].metrics.brandsarray | nullrequired
Brands value used by this API operation.
Minimum items: 0
Maximum items: 10
data.result.items[].metrics.brands[]objectrequired
Item in data result items[] metrics brands.
data.result.items[].metrics.brands[].valuestringrequired
Value value used by this API operation.
data.result.items[].metrics.brands[].countsobjectrequired
Counts value used by this API operation.
data.result.items[].metrics.brands[].counts.mentionsinteger | nullrequired
Mentions value used by this API operation.
Minimum: 0
data.result.items[].metrics.brands[].counts.aiSearchVolumeinteger | nullrequired
Ai search volume value used by this API operation.
Minimum: 0
data.result.items[].metrics.brandCategoriesarray | nullrequired
Brand categories value used by this API operation.
Minimum items: 0
Maximum items: 10
data.result.items[].metrics.brandCategories[]objectrequired
Item in data result items[] metrics brandCategories.
data.result.items[].metrics.brandCategories[].valuestringrequired
Value value used by this API operation.
data.result.items[].metrics.brandCategories[].countsobjectrequired
Counts value used by this API operation.
data.result.items[].metrics.brandCategories[].counts.mentionsinteger | nullrequired
Mentions value used by this API operation.
Minimum: 0
data.result.items[].metrics.brandCategories[].counts.aiSearchVolumeinteger | nullrequired
Ai search volume value used by this API operation.
Minimum: 0
data.result.items[].missingarrayrequired
Missing value used by this API operation.
Minimum items: 0
data.result.items[].missing[]objectrequired
Item in data result items[] missing.
data.result.items[].missing[].fieldstringrequired
Field value used by this API operation.
data.result.items[].missing[].reasonstringrequired
Reason value used by this API operation.
Allowed: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM, UPSTREAM_ITEM_MISSING

One of option 1 — requires kind, domain, searchFilter, includeSubdomains

NameTypeRequiredDescription
data.result.context.inputTargets[]objectrequired
Item in data result context inputTargets.
data.result.context.inputTargets[].kindstringrequired
Kind value used by this API operation.
Constant: DOMAIN
data.result.context.inputTargets[].domainstringrequired
Normalized ASCII hostname at most63 characters.
Minimum length: 1
data.result.context.inputTargets[].searchFilterstringrequired
Search filter value used by this API operation.
Allowed: include, exclude
Default: include
data.result.context.inputTargets[].includeSubdomainsbooleanrequired
Include subdomains value used by this API operation.
Default: false

One of option 2 — requires kind, keyword, searchFilter, matchType

NameTypeRequiredDescription
data.result.context.inputTargets[]objectrequired
Item in data result context inputTargets.
data.result.context.inputTargets[].kindstringrequired
Kind value used by this API operation.
Constant: KEYWORD
data.result.context.inputTargets[].keywordstringrequired
Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus.
Minimum length: 1
data.result.context.inputTargets[].searchFilterstringrequired
Search filter value used by this API operation.
Allowed: include, exclude
Default: include
data.result.context.inputTargets[].matchTypestringrequired
Match type value used by this API operation.
Allowed: word_match, partial_match
Default: word_match

One of option 1 — requires kind, domain, searchFilter, includeSubdomains

NameTypeRequiredDescription
data.result.context.normalizedTargets[]objectrequired
Item in data result context normalizedTargets.
data.result.context.normalizedTargets[].kindstringrequired
Kind value used by this API operation.
Constant: DOMAIN
data.result.context.normalizedTargets[].domainstringrequired
Normalized ASCII hostname at most63 characters.
Minimum length: 1
data.result.context.normalizedTargets[].searchFilterstringrequired
Search filter value used by this API operation.
Allowed: include, exclude
Default: include
data.result.context.normalizedTargets[].includeSubdomainsbooleanrequired
Include subdomains value used by this API operation.
Default: false

One of option 2 — requires kind, keyword, searchFilter, matchType

NameTypeRequiredDescription
data.result.context.normalizedTargets[]objectrequired
Item in data result context normalizedTargets.
data.result.context.normalizedTargets[].kindstringrequired
Kind value used by this API operation.
Constant: KEYWORD
data.result.context.normalizedTargets[].keywordstringrequired
Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus.
Minimum length: 1
data.result.context.normalizedTargets[].searchFilterstringrequired
Search filter value used by this API operation.
Allowed: include, exclude
Default: include
data.result.context.normalizedTargets[].matchTypestringrequired
Match type value used by this API operation.
Allowed: word_match, partial_match
Default: word_match

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

{
  "target": [
    {
      "kind": "DOMAIN",
      "domain": " Example.COM "
    },
    {
      "kind": "KEYWORD",
      "keyword": " Shoes "
    }
  ]
}

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
}