Historical AI Mentions API

SEO API documentation for REST and MCP, generated from the implemented API contract.

API selector

AI Visibility

API overview

Monthly absolute mentions from the provider historical database. 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.

Try this API

Endpoint

/api/skill-api/v1/skills/seo-ai-mention-history/run

MCP method

nexscope_seo_ai_mention_history

Authentication

All run endpoints require a user API key. Send it as a bearer token in the Authorization header.

Authorization: Bearer nk_xxxxxxxxxxxxxxxxx

Missing or invalid API keys return an authentication error. Manage keys from .

POST/api/skill-api/v1/skills/seo-ai-mention-history/run

Run an API

Send a JSON request body using the parameters described below.

Slug	`seo-ai-mention-history`
Headers	`Authorization: Bearer nk_...` `Content-Type: application/json`
Request body	API-specific JSON object.
Response body	Complete HTTP envelope, including code and data.

Status codes

Code	Description
200	API executed successfully. Body is the direct response payload.
400	Request JSON or required API parameters are invalid.
401	API key is missing, invalid, or cannot be matched to a user.
5xx	API execution or upstream service failed.

Example request

curl -X POST https://api.nexscope.ai/api/skill-api/v1/skills/seo-ai-mention-history/run \
  -H "Authorization: Bearer nk_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{   "fromMonth": "2026-01",   "language": "en",   "market": "US",   "platform": "google",   "target": [     {       "domain": "example",       "includeSubdomains": false,       "kind": "DOMAIN",       "searchFilter": "include"     }   ],   "toMonth": "2026-01" }'

All categories/ AI Visibility

POST/api/skill-api/v1/skills/seo-ai-mention-history/run

Run this API

Send a JSON request to execute this API and receive the documented response payload.

Open tester

Endpoint

Method	`POST`
Path	`/api/skill-api/v1/skills/seo-ai-mention-history/run`
Auth	`Bearer API key`
Content-Type	`application/json`

Request body

Name	Type	Required	Description
`fromMonth`	`string`	required	From month value used by this API operation. Pattern: ^[0-9]{4}-[0-9]{2}$
`language`	`string`	optional	Language value used by this API operation. Constant: en Default: en
`market`	`string`	optional	Market value used by this API operation. Constant: US Default: US
`platform`	`string`	optional	Platform value used by this API operation. Allowed: google, chat_gpt Default: google
`target`	`array`	required	Target value used by this API operation. Minimum items: 1 Maximum items: 10
`target[]`	`any`	required	Item in target.
`toMonth`	`string`	required	To month value used by this API operation. Pattern: ^[0-9]{4}-[0-9]{2}$

One of option 1 — requires kind, domain

Name	Type	Required	Description
`target[]`	`object`	required	Item in target.
`target[].domain`	`string`	required	Normalized ASCII hostname at most63 characters. Minimum length: 1
`target[].includeSubdomains`	`boolean`	optional	Include subdomains value used by this API operation. Default: false
`target[].kind`	`string`	required	Kind value used by this API operation. Constant: DOMAIN
`target[].searchFilter`	`string`	optional	Search filter value used by this API operation. Allowed: include, exclude Default: include

One of option 2 — requires kind, keyword

Name	Type	Required	Description
`target[]`	`object`	required	Item in target.
`target[].keyword`	`string`	required	Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus. Minimum length: 1
`target[].kind`	`string`	required	Kind value used by this API operation. Constant: KEYWORD
`target[].matchType`	`string`	optional	Match type value used by this API operation. Allowed: word_match, partial_match Default: word_match
`target[].searchFilter`	`string`	optional	Search filter value used by this API operation. Allowed: include, exclude Default: include

Request example

{
  "fromMonth": "2026-01",
  "language": "en",
  "market": "US",
  "platform": "google",
  "target": [
    {
      "domain": "example",
      "includeSubdomains": false,
      "kind": "DOMAIN",
      "searchFilter": "include"
    }
  ],
  "toMonth": "2026-01"
}

Response body

Name	Type	Required	Description
`code`	`integer`	required	0 is a successful envelope; inspect data.status separately. Allowed: 0, 42008, 42009
`cost`	`string`	required	Elapsed processing milliseconds; not price. -1 for non-web context.
`data`	`object`	required	Data value used by this API operation.
`data.callId`	`string \| null`	optional	Call id value used by this API operation.
`data.completedAt`	`integer \| null`	optional	Completed at value used by this API operation.
`data.coverage`	`object`	optional	Coverage value used by this API operation.
`data.coverage.missing`	`array`	optional	Missing value used by this API operation.
`data.coverage.missing[]`	`object`	required	Item in data coverage missing.
`data.coverage.missing[].field`	`string`	optional	Field value used by this API operation.
`data.coverage.missing[].reason`	`string`	optional	Reason value used by this API operation.
`data.coverage.status`	`string`	optional	Status value used by this API operation.
`data.requestedAt`	`integer \| null`	optional	Requested at value used by this API operation.
`data.result`	`object \| null`	required	Result value used by this API operation.
`data.result.context`	`object`	required	Context value used by this API operation.
`data.result.context.domainSearchScope`	`string`	required	Domain search scope value used by this API operation. Constant: sources
`data.result.context.fromMonth`	`string`	required	From month value used by this API operation. Pattern: ^[0-9]{4}-[0-9]{2}$
`data.result.context.inputTargets`	`array`	required	Input targets value used by this API operation. Minimum items: 1 Maximum items: 10
`data.result.context.inputTargets[]`	`any`	required	Item in data result context inputTargets.
`data.result.context.keywordSearchScope`	`string`	required	Keyword search scope value used by this API operation. Constant: answer
`data.result.context.measure`	`string`	required	Measure value used by this API operation. Constant: monthly_absolute_mentions
`data.result.context.normalizedTargets`	`array`	required	Normalized targets value used by this API operation. Minimum items: 1 Maximum items: 10
`data.result.context.normalizedTargets[]`	`any`	required	Item in data result context normalizedTargets.
`data.result.context.partialCalendarMonth`	`boolean`	required	Partial calendar month value used by this API operation.
`data.result.context.platform`	`string`	required	Platform value used by this API operation. Allowed: google, chat_gpt
`data.result.context.resolvedDateTo`	`string`	required	Resolved date to value used by this API operation. Format: date
`data.result.context.toMonth`	`string`	required	To month value used by this API operation. Pattern: ^[0-9]{4}-[0-9]{2}$
`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[].metrics`	`object`	required	Metrics value used by this API operation.
`data.result.items[].metrics.aiSearchVolume`	`integer \| null`	required	Ai search volume value used by this API operation. Minimum: 0
`data.result.items[].metrics.mentions`	`integer \| null`	required	Mentions 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.items[].month`	`integer`	required	Month value used by this API operation. Minimum: 1 Maximum: 12
`data.result.items[].year`	`integer`	required	Year value used by this API operation. Minimum: 1
`data.result.language`	`string`	required	Language value used by this API operation. Constant: en
`data.result.market`	`string`	required	Market value used by this API operation. Constant: US
`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.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: llm_mentions_database
`data.result.sourceProduct`	`string`	required	Source product value used by this API operation. Constant: ai_optimization
`data.result.truncated`	`boolean`	required	Truncated value used by this API operation.
`data.schemaVersion`	`string \| null`	optional	Schema version value used by this API operation.
`data.source`	`string \| null`	optional	Source value used by this API operation.
`data.status`	`string`	optional	Status value used by this API operation. Allowed: SUCCESS, PARTIAL, EMPTY, PROCESSING, UNKNOWN, FAILED
`data.usage`	`object`	optional	Usage value used by this API operation.
`data.usage.billingStatus`	`string`	optional	Billing status value used by this API operation.
`data.usage.chargedCredits`	`integer \| null`	optional	Charged credits value used by this API operation.
`data.usage.providerCostStatus`	`string`	optional	Provider cost status value used by this API operation.
`data.usage.providerCostUsd`	`string \| null`	optional	Provider cost usd value used by this API operation.
`data.usage.providerRequests`	`integer`	optional	Provider requests value used by this API operation.
`msg`	`string \| null`	required	Msg value used by this API operation.
`time`	`string`	required	yyyy-MM-dd HH:mm:ss
`traceId`	`string \| null`	required	Trace id value used by this API operation.
`ts`	`string`	required	Epoch milliseconds; global long serializer.

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

Name	Type	Required	Description
`data.result.context.inputTargets[]`	`object`	required	Item in data result context inputTargets.
`data.result.context.inputTargets[].domain`	`string`	required	Normalized ASCII hostname at most63 characters. Minimum length: 1
`data.result.context.inputTargets[].includeSubdomains`	`boolean`	required	Include subdomains value used by this API operation. Default: false
`data.result.context.inputTargets[].kind`	`string`	required	Kind value used by this API operation. Constant: DOMAIN
`data.result.context.inputTargets[].searchFilter`	`string`	required	Search filter value used by this API operation. Allowed: include, exclude Default: include

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

Name	Type	Required	Description
`data.result.context.inputTargets[]`	`object`	required	Item in data result context inputTargets.
`data.result.context.inputTargets[].keyword`	`string`	required	Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus. Minimum length: 1
`data.result.context.inputTargets[].kind`	`string`	required	Kind value used by this API operation. Constant: KEYWORD
`data.result.context.inputTargets[].matchType`	`string`	required	Match type value used by this API operation. Allowed: word_match, partial_match Default: word_match
`data.result.context.inputTargets[].searchFilter`	`string`	required	Search filter value used by this API operation. Allowed: include, exclude Default: include

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

Name	Type	Required	Description
`data.result.context.normalizedTargets[]`	`object`	required	Item in data result context normalizedTargets.
`data.result.context.normalizedTargets[].domain`	`string`	required	Normalized ASCII hostname at most63 characters. Minimum length: 1
`data.result.context.normalizedTargets[].includeSubdomains`	`boolean`	required	Include subdomains value used by this API operation. Default: false
`data.result.context.normalizedTargets[].kind`	`string`	required	Kind value used by this API operation. Constant: DOMAIN
`data.result.context.normalizedTargets[].searchFilter`	`string`	required	Search filter value used by this API operation. Allowed: include, exclude Default: include

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

Name	Type	Required	Description
`data.result.context.normalizedTargets[]`	`object`	required	Item in data result context normalizedTargets.
`data.result.context.normalizedTargets[].keyword`	`string`	required	Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus. Minimum length: 1
`data.result.context.normalizedTargets[].kind`	`string`	required	Kind value used by this API operation. Constant: KEYWORD
`data.result.context.normalizedTargets[].matchType`	`string`	required	Match type value used by this API operation. Allowed: word_match, partial_match Default: word_match
`data.result.context.normalizedTargets[].searchFilter`	`string`	required	Search filter value used by this API operation. Allowed: include, exclude Default: include

Response example

Example response envelope from the documented SEO API contract.

{
  "code": 0,
  "cost": "-1",
  "data": {
    "callId": "synthetic-call",
    "completedAt": null,
    "coverage": {
      "missing": [
        {
          "field": "synthetic",
          "reason": "UPSTREAM_FIELD_MISSING"
        }
      ],
      "status": "PARTIAL"
    },
    "requestedAt": 123,
    "result": {
      "context": {
        "domainSearchScope": "synthetic",
        "fromMonth": "synthetic",
        "inputTargets": [],
        "keywordSearchScope": "synthetic",
        "measure": "synthetic",
        "normalizedTargets": [],
        "partialCalendarMonth": false,
        "platform": "synthetic",
        "resolvedDateTo": "synthetic",
        "toMonth": "synthetic"
      },
      "items": [
        {
          "metrics": {
            "aiSearchVolume": 9007199254740992,
            "mentions": 9007199254740992
          },
          "missing": [
            {
              "field": "synthetic",
              "reason": "synthetic"
            }
          ],
          "month": 1,
          "year": 1
        }
      ],
      "language": "synthetic",
      "market": "synthetic",
      "missing": [
        {
          "field": "synthetic",
          "reason": "synthetic"
        }
      ],
      "returnedCount": 1,
      "sourceKind": "synthetic",
      "sourceProduct": "synthetic",
      "truncated": false
    },
    "schemaVersion": "synthetic",
    "source": "synthetic",
    "status": "PARTIAL",
    "usage": {
      "billingStatus": "UNAPPROVED",
      "chargedCredits": 0,
      "providerCostStatus": "UNAPPROVED",
      "providerCostUsd": null,
      "providerRequests": 0
    }
  },
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "9007199254740993"
}

Responses

Code	Description
200	API executed successfully. Body is the direct response payload.
400	Request JSON or required API parameters are invalid.
401	API key is missing, invalid, or cannot be matched to a user.
5xx	API execution or upstream service failed.

Data source, freshness, and limitations

Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.

MCP

Use the MCP endpoint when an agent needs to discover and call API tools with JSON-RPC.

GET /api/skill-api/v1/mcp

POST /api/skill-api/v1/mcp
Authorization: Bearer nk_xxxxxxxxxxxxxxxxx
Content-Type: application/json

Call a tool

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_seo_ai_mention_history",
    "arguments": {
      "fromMonth": "2026-01",
      "language": "en",
      "market": "US",
      "platform": "google",
      "target": [
        {
          "domain": "example",
          "includeSubdomains": false,
          "kind": "DOMAIN",
          "searchFilter": "include"
        }
      ],
      "toMonth": "2026-01"
    }
  }
}

Online test

Execute the current API with your API key and JSON payload.

Try it

Send a real request with the same contract shown in the reference.

Endpoint

/api/skill-api/v1/skills/seo-ai-mention-history/run

MCP method

nexscope_seo_ai_mention_history

API key*

JSON payload*

cURL

curl -X POST \
  https://api.nexscope.ai/api/skill-api/v1/skills/seo-ai-mention-history/run \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "fromMonth": "2026-01", "language": "en", "market": "US", "platform": "google", "target": [ { "domain": "example", "includeSubdomains": false, "kind": "DOMAIN", "searchFilter": "include" } ], "toMonth": "2026-01" }'

Response

No response yet. Run the request to see the response here.