SEO APIs and MCP Tools for Search Intelligence

cURL

curl -X POST https://api.nexscope.ai/api/skill-api/v1/skills/seo-keyword-metrics/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "keywords": [
    "example"
  ],
  "language": "en",
  "market": "US"
}'

JavaScript

await fetch('https://api.nexscope.ai/api/skill-api/v1/skills/seo-keyword-metrics/run', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "keywords": [
    "example"
  ],
  "language": "en",
  "market": "US"
})
});

Python

import requests

response = requests.post(
    'https://api.nexscope.ai/api/skill-api/v1/skills/seo-keyword-metrics/run',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
  "keywords": [
    "example"
  ],
  "language": "en",
  "market": "US"
},
)

Example response from Keyword Search Volume & Metrics API

{
  "code": 0,
  "cost": "-1",
  "data": {
    "callId": "synthetic-call",
    "completedAt": null,
    "coverage": {
      "missing": [
        {
          "field": "synthetic",
          "reason": "UPSTREAM_FIELD_MISSING"
        }
      ],
      "status": "PARTIAL"
    },
    "requestedAt": 123,
    "result": {
      "items": [
        {
          "competition": 9007199254740992,
          "competitionLevel": "synthetic",
          "cpcUsd": "synthetic",
          "dataUpdatedAt": 9007199254740992,
          "inputIndex": 1,
          "inputKeyword": "synthetic",
          "keywordDifficulty": 9007199254740992,
          "missing": [
            {
              "field": "synthetic",
              "reason": "synthetic"
            }
          ],
          "monthlySearches": [
            {
              "month": 1,
              "searchVolume": 9007199254740992,
              "year": 1
            }
          ],
          "normalizedKeyword": "synthetic",
          "searchVolume": 9007199254740992,
          "status": "synthetic"
        }
      ],
      "language": "synthetic",
      "market": "synthetic"
    },
    "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"
}

Common errors