Domain Research API

SEMUST-API-USER: your_username
SEMUST-API-PASSWORD: your_password
Content-Type: application/json

{
  "type": "keywords",
  "domain": "example.com.tr",
  "limit": 100
}

{
  "type": "keywords",
  "domain": "example.com.tr",
  "limit": 50,
  "min_volume": 100,
  "max_position": 10,
  "intent": "commercial",
  "contains": "avukat",
  "sort": "volume"
}

{
  "success": true,
  "default_country": "TR",
  "markets": [
    { "country": "TR", "name": "Turkiye", "languages": ["tr"] },
    { "country": "US", "name": "United States", "languages": ["en", "es"] }
  ]
}

curl -X POST https://data.semust.com/v1/domain-research \
  -H "SEMUST-API-USER: your_username" \
  -H "SEMUST-API-PASSWORD: your_password" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "keywords",
    "domain": "example.com.tr",
    "limit": 100
  }'

import requests

response = requests.post(
    "https://data.semust.com/v1/domain-research",
    headers={
        "SEMUST-API-USER": "your_username",
        "SEMUST-API-PASSWORD": "your_password",
    },
    json={"type": "keywords", "domain": "example.com.tr", "limit": 100},
    timeout=120,
)

data = response.json()
if response.status_code != 200:
    # Every error carries a stable `code`; `retryable` says whether trying again can help.
    raise SystemExit(f"{data['code']}: {data['error']} {data.get('hint', '')}")

print(f"{data['count']} of {data['total']} keywords, cost ${data['cost']:.6f}")
for row in data["items"]:
    print(row["position"], row["keyword"], row["volume"], row["traffic"])

const response = await fetch("https://data.semust.com/v1/domain-research", {
  method: "POST",
  headers: {
    "SEMUST-API-USER": "your_username",
    "SEMUST-API-PASSWORD": "your_password",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ type: "keywords", domain: "example.com.tr", limit: 100 }),
});

const data = await response.json();
if (!response.ok) {
  throw new Error(`${data.code}: ${data.error}`);
}
console.log(`${data.count} of ${data.total} keywords, cost $${data.cost}`);

{
  "success": true,
  "type": "overview",
  "domain": "semust.com",
  "country": "TR",
  "language": "tr",
  "data": {
    "organic": {
      "keywords": 136,
      "traffic": 1233,
      "traffic_value_usd": 1541.15,
      "top3": 6,
      "top10": 36,
      "top20": 89,
      "top100": 136,
      "new": 86,
      "lost": 29,
      "improved": 25,
      "declined": 23
    },
    "paid": { "keywords": 0, "traffic": 0, "traffic_value_usd": 0 }
  },
  "cost": 0.013332,
  "cached": false,
  "request_id": "3f1c2a9e-5b7d-4c1e-9a2f-8d6e4b0c7a11"
}

{
  "success": true,
  "type": "keywords",
  "domain": "semust.com",
  "country": "TR",
  "language": "tr",
  "total": 136,
  "count": 3,
  "page": 1,
  "limit": 3,
  "sort": "traffic",
  "direction": "desc",
  "items": [
    {
      "keyword": "google search console",
      "volume": 60500,
      "cpc": 1.57,
      "difficulty": 85,
      "intent": "navigational",
      "position": 19,
      "url": "https://semust.com/blog/google-search-console-nedir",
      "traffic": 373
    },
    {
      "keyword": "semust",
      "volume": 390,
      "cpc": 0.31,
      "difficulty": 4,
      "intent": "informational",
      "position": 1,
      "url": "https://semust.com/",
      "traffic": 154
    },
    {
      "keyword": "18 arama motoru isimleri",
      "volume": 320,
      "cpc": null,
      "difficulty": 0,
      "intent": "informational",
      "position": 4,
      "url": "https://semust.com/blog/en-iyi-arama-motorlari",
      "traffic": 19
    }
  ],
  "cost": 0.013596,
  "cached": false,
  "request_id": "9b0e7c4d-2a1f-4e3b-8c5d-6f7a8b9c0d1e"
}

{
  "success": true,
  "type": "competitors",
  "domain": "semust.com",
  "country": "TR",
  "language": "tr",
  "total": 2630,
  "count": 2,
  "page": 1,
  "limit": 2,
  "sort": "common_keywords",
  "direction": "desc",
  "items": [
    {
      "domain": "eksisozluk.com",
      "common_keywords": 69,
      "avg_position": 10.2,
      "keywords": 795972,
      "traffic": 33062395
    },
    {
      "domain": "webtekno.com",
      "common_keywords": 59,
      "avg_position": 19.9,
      "keywords": 59032,
      "traffic": 977179
    }
  ],
  "cost": 0.013464,
  "cached": false,
  "request_id": "c2d4e6f8-1a3b-4c5d-8e9f-0a1b2c3d4e5f"
}

{
  "success": true,
  "type": "top_pages",
  "domain": "semust.com",
  "country": "TR",
  "language": "tr",
  "total": 40,
  "count": 2,
  "page": 1,
  "limit": 2,
  "sort": "traffic",
  "direction": "desc",
  "items": [
    {
      "url": "https://semust.com/blog/google-search-console-nedir",
      "keywords": 9,
      "traffic": 594,
      "top3": 0,
      "top10": 3
    },
    {
      "url": "https://semust.com/blog/yapay-zeka-fotograf-promptlari",
      "keywords": 26,
      "traffic": 218,
      "top3": 2,
      "top10": 17
    }
  ],
  "cost": 0.013464,
  "cached": false,
  "request_id": "5e6f7a8b-9c0d-4e1f-a2b3-c4d5e6f7a8b9"
}

{
  "error": "Unknown parameter 'limt'",
  "code": "UNKNOWN_PARAMETER",
  "field": "limt",
  "hint": "Did you mean 'limit'?",
  "retryable": false
}

{
  "error": "'min_volume' cannot be used with type=overview",
  "code": "PARAMETER_NOT_ALLOWED",
  "field": "min_volume",
  "hint": "Accepted by type: keywords",
  "retryable": false
}

{
  "error": "'limit' 1 ile 1000 arasında bir tam sayı olmalıdır",
  "code": "INVALID_PARAMETER",
  "field": "limit",
  "retryable": false
}

{
  "error": "Your balance is not enough for this request",
  "code": "INSUFFICIENT_CREDITS",
  "hint": "Lower limit, or add funds",
  "retryable": false,
  "required": 0.1452,
  "balance": 0.05
}

{
  "error": "The service is busy, please retry shortly",
  "code": "SERVICE_BUSY",
  "hint": "You were not charged",
  "retryable": true,
  "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}