Technical SEO API

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

{
  "url": "https://example.com",
  "render_js": false,
  "proxy_country": "US"
}

curl -X POST https://data.semust.com/v1/technical-seo \
  -H "Content-Type: application/json" \
  -H "SEMUST-API-USER: your_username" \
  -H "SEMUST-API-PASSWORD: your_password" \
  -d '{
    "url": "https://example.com",
    "render_js": false
  }'

import requests
import json

response = requests.post(
    "https://data.semust.com/v1/technical-seo",
    headers={
        "SEMUST-API-USER": "your_username",
        "SEMUST-API-PASSWORD": "your_password",
    },
    json={
        "url": "https://example.com",
        "render_js": False,
    },
)

if response.status_code == 200:
    data = response.json()
    summary = data.get("summary", {})
    print(f"Score: {summary.get('score', 0)}/100")
    print(f"Issues: {summary.get('total_issues', 0)} total "
          f"({summary.get('critical_issues', 0)} critical, "
          f"{summary.get('warning_issues', 0)} warning, "
          f"{summary.get('notice_issues', 0)} notice)")

    # Print failed audits by category
    for category, audits in data.get("audit_results", {}).items():
        issues = {k: v for k, v in audits.items() if v and v.get("status") == "fail"}
        if issues:
            print(f"\n[{category.upper()}]")
            for name, details in issues.items():
                print(f"  - {name}: {details.get('issue', '')}")
else:
    print(f"Error [{response.status_code}]: {response.text}")

const response = await fetch("https://data.semust.com/v1/technical-seo", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "SEMUST-API-USER": "your_username",
    "SEMUST-API-PASSWORD": "your_password",
  },
  body: JSON.stringify({
    url: "https://example.com",
    render_js: false,
  }),
});

if (response.ok) {
  const data = await response.json();
  const { summary } = data;
  console.log(`Score: ${summary.score}/100`);
  console.log(`Issues: ${summary.total_issues} total`);

  // Print failed audits
  for (const [category, audits] of Object.entries(data.audit_results)) {
    for (const [name, result] of Object.entries(audits)) {
      if (result?.status === "fail") {
        console.log(`[${category}] ${name}: ${result.issue}`);
      }
    }
  }
} 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{}{
		"url":       "https://example.com",
		"render_js": false,
	}
	body, _ := json.Marshal(payload)

	req, _ := http.NewRequest("POST",
		"https://data.semust.com/v1/technical-seo",
		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)
		if summary, ok := data["summary"].(map[string]interface{}); ok {
			fmt.Printf("Score: %v/100\n", summary["score"])
			fmt.Printf("Issues: %v total\n", summary["total_issues"])
		}
	} else {
		fmt.Printf("Error %d: %s\n",
			resp.StatusCode, string(respBody))
	}
}

<?php

$payload = json_encode([
    "url"       => "https://example.com",
    "render_js" => false,
]);

$ch = curl_init("https://data.semust.com/v1/technical-seo");
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);
    $summary = $data["summary"] ?? [];
    echo "Score: " . ($summary["score"] ?? 0) . "/100\n";
    echo "Issues: " . ($summary["total_issues"] ?? 0) . " total\n";
} else {
    echo "Error [{$httpCode}]: {$response}\n";
}

{
  "success": true,
  "url": "https://example.com",
  "cost": 0.0012,
  "audit_results": {
    "meta": {
      "title": {
        "status": "fail",
        "severity": "warning",
        "issue": "long_title",
        "data": { "title": "Very Long Page Title...", "length": 66 }
      },
      "meta_description": {
        "status": "pass",
        "severity": "warning",
        "data": { "meta_description": "Page description...", "length": 93 }
      },
      "canonical_url": {
        "status": "pass",
        "severity": "warning",
        "data": { "current_url": "https://example.com", "canonical_url": "https://example.com" }
      },
      "robots_noindex": { "status": "pass", "severity": "critical", "data": {} },
      "viewport": {
        "status": "pass",
        "severity": "critical",
        "data": { "content": "width=device-width, initial-scale=1" }
      }
    },
    "headings": {
      "missing_h1": {
        "status": "pass",
        "severity": "critical",
        "data": { "h1_count": 1, "h1_text": "Welcome" }
      },
      "broken_heading_structure": {
        "status": "fail",
        "severity": "warning",
        "issue": "broken_heading_structure",
        "data": { "total_count": 12, "skipped_levels": 1 }
      }
    },
    "images": {
      "images_without_alt": { "status": "pass", "severity": "warning", "data": { "total_images": 10 } },
      "missing_image_dimensions": {
        "status": "fail",
        "severity": "warning",
        "issue": "missing_image_dimensions",
        "data": { "total_images": 10, "count": 5 }
      }
    },
    "content": {
      "low_word_count": { "status": "pass", "severity": "warning", "data": { "word_count": 684 } },
      "low_html_text_ratio": {
        "status": "fail",
        "severity": "warning",
        "issue": "low_html_text_ratio",
        "data": { "text_to_html_ratio": 8.08 }
      }
    }
  },
  "summary": {
    "total_checks": 27,
    "passed_checks": 23,
    "total_issues": 4,
    "critical_issues": 0,
    "warning_issues": 4,
    "notice_issues": 0,
    "score": 85
  }
}

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