Keyword Data API

SEMUST-API-USER: your_username
SEMUST-API-PASSWORD: your_password

{
  "keyword": "seo tools",
  "country": "US",
  "language": "en",
  "limit": 100,
  "match_type": "broad"
}

curl -X POST https://data.semust.com/v1/keyword-data \
  -H "Content-Type: application/json" \
  -H "SEMUST-API-USER: your_username" \
  -H "SEMUST-API-PASSWORD: your_password" \
  -d '{
    "keyword": "seo tools",
    "country": "US",
    "language": "en",
    "limit": 100,
    "match_type": "broad"
  }'

import requests

response = requests.post(
    "https://data.semust.com/v1/keyword-data",
    headers={
        "SEMUST-API-USER": "your_username",
        "SEMUST-API-PASSWORD": "your_password",
    },
    json={
        "keyword": "seo tools",
        "country": "US",
        "language": "en",
        "limit": 100,
        "match_type": "broad",
    },
)

if response.status_code == 200:
    data = response.json()
    print(f"Success: {data['success']}")
    print(f"Result Count: {data['result_count']}")
    print(f"Cost: ${data['cost']:.6f}\n")

    for kw in data.get('data', []):
        print(f"Keyword: {kw['keyword']}")
        print(f"  Search Volume: {kw['search_volume']:,}")
        print(f"  CPC: ${kw['cpc']:.2f}")
        print(f"  Competition: {kw['competition']} ({kw['competition_level']})")
        print(f"  Intent: {kw['intent']}")
        if kw.get('related_keywords'):
            print(f"  Related: {', '.join(kw['related_keywords'][:3])}")
else:
    print(f"Error [{response.status_code}]: {response.text}")

const response = await fetch("https://data.semust.com/v1/keyword-data", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "SEMUST-API-USER": "your_username",
    "SEMUST-API-PASSWORD": "your_password",
  },
  body: JSON.stringify({
    keyword: "seo tools",
    country: "US",
    language: "en",
    limit: 100,
    match_type: "broad",
  }),
});

if (response.ok) {
  const data = await response.json();
  console.log(`Success: ${data.success}`);
  console.log(`Cost: $${data.cost.toFixed(6)}`);

  data.data?.forEach((kw) => {
    console.log(`\n${kw.keyword}`);
    console.log(`  Search Volume: ${kw.search_volume.toLocaleString()}`);
    console.log(`  CPC: $${kw.cpc.toFixed(2)}`);
    console.log(`  Competition: ${kw.competition} (${kw.competition_level})`);
    console.log(`  Intent: ${kw.intent}`);
    if (kw.related_keywords?.length) {
      console.log(`  Related: ${kw.related_keywords.slice(0, 3).join(", ")}`);
    }
  });
} else {
  const text = await response.text();
  console.error(`Error [${response.status}]: ${text}`);
}

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := map[string]interface{}{
		"keyword":    "seo tools",
		"country":    "US",
		"language":   "en",
		"limit":      100,
		"match_type": "broad",
	}
	body, _ := json.Marshal(payload)

	req, _ := http.NewRequest("POST",
		"https://data.semust.com/v1/keyword-data",
		bytes.NewBuffer(body))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("SEMUST-API-USER", "your_username")
	req.Header.Set("SEMUST-API-PASSWORD", "your_password")

	resp, err := (&http.Client{}).Do(req)
	if err != nil {
		fmt.Printf("Request failed: %v\n", err)
		return
	}
	defer resp.Body.Close()
	respBody, _ := io.ReadAll(resp.Body)

	if resp.StatusCode == 200 {
		var data map[string]interface{}
		json.Unmarshal(respBody, &data)
		fmt.Printf("Success: %v\n", data["success"])
		fmt.Printf("Cost: $%.6f\n", data["cost"])

		if keywordData, ok := data["data"].([]interface{}); ok {
			for _, item := range keywordData {
				kw := item.(map[string]interface{})
				fmt.Printf("\n%v\n", kw["keyword"])
				fmt.Printf("  Search Volume: %.0f\n", kw["search_volume"])
				fmt.Printf("  CPC: $%.2f\n", kw["cpc"])
				fmt.Printf("  Competition: %.0f (%v)\n", kw["competition"], kw["competition_level"])
				fmt.Printf("  Intent: %v\n", kw["intent"])
			}
		}
	} else {
		fmt.Printf("Error %d: %s\n", resp.StatusCode, string(respBody))
	}
}

<?php

$payload = json_encode([
    "keyword"    => "seo tools",
    "country"    => "US",
    "language"   => "en",
    "limit"      => 100,
    "match_type" => "broad",
]);

$ch = curl_init("https://data.semust.com/v1/keyword-data");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "SEMUST-API-USER: your_username",
    "SEMUST-API-PASSWORD: your_password",
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $data = json_decode($response, true);
    echo "Success: " . ($data["success"] ? "true" : "false") . "\n";
    echo "Cost: $" . number_format($data["cost"], 6) . "\n\n";

    foreach ($data["data"] ?? [] as $kw) {
        echo $kw["keyword"] . "\n";
        echo "  Search Volume: " . number_format($kw["search_volume"]) . "\n";
        echo "  CPC: $" . number_format($kw["cpc"], 2) . "\n";
        echo "  Competition: " . $kw["competition"] . " (" . $kw["competition_level"] . ")\n";
        echo "  Intent: " . $kw["intent"] . "\n\n";
    }
} else {
    echo "Error [{$httpCode}]: {$response}\n";
}

{
  "success": true,
  "result_count": 3,
  "cost": 0.01,
  "data": [
    {
      "keyword": "seo tools",
      "search_volume": 12100,
      "cpc": 15.75,
      "competition": 85,
      "competition_level": "high",
      "country": "us",
      "language": "en",
      "intent": "commercial",
      "related_keywords": ["best seo tools", "free seo tools"]
    },
    {
      "keyword": "best seo tools",
      "search_volume": 8100,
      "cpc": 12.50,
      "competition": 72,
      "competition_level": "high",
      "country": "us",
      "language": "en",
      "intent": "commercial",
      "related_keywords": null
    },
    {
      "keyword": "free seo tools",
      "search_volume": 5400,
      "cpc": 8.25,
      "competition": 45,
      "competition_level": "medium",
      "country": "us",
      "language": "en",
      "intent": "informational",
      "related_keywords": null
    }
  ]
}

{
  "error": "Your account does not have enough credits",
  "code": "INSUFFICIENT_CREDITS"
}