Backlink API

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

{
  "target": "example.com",
  "type": "backlinks",
  "limit": 100
}

{
  "target": "example.com",
  "type": "backlinks",
  "scope": "domain",
  "status": "live",
  "limit": 100,
  "filters": [
    ["is_dofollow", "=", true],
    "and",
    ["source_domain_rate", ">=", 40]
  ],
  "order_by": ["source_domain_rate,desc"]
}

{
  "target": "example.com",
  "type": "backlinks",
  "filters": ["source_domain", "like", "%.edu"]
}

{
  "target": "example.com",
  "type": "backlinks",
  "filters": [
    ["is_dofollow", "=", true],
    "and",
    ["source_spam_score", "<", 20]
  ]
}

{
  "target": "example.com",
  "type": "backlinks",
  "filters": [
    ["source_domain_rate", ">=", 50],
    "and",
    [
      ["link_position", "=", "content"],
      "or",
      ["anchor_text", "ilike", "%seo%"]
    ]
  ]
}

{
  "target": "example.com",
  "type": "backlinks",
  "filters": ["link_type", "in", ["text", "image"]]
}

curl -X POST https://data.semust.com/v1/backlinks \
  -H "SEMUST-API-USER: your_username" \
  -H "SEMUST-API-PASSWORD: your_password" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "example.com",
    "type": "backlinks",
    "limit": 100,
    "filters": [["is_dofollow", "=", true]],
    "order_by": ["source_domain_rate,desc"]
  }'

import requests

response = requests.post(
    "https://data.semust.com/v1/backlinks",
    headers={
        "SEMUST-API-USER": "your_username",
        "SEMUST-API-PASSWORD": "your_password",
    },
    json={
        "target": "example.com",
        "type": "backlinks",
        "limit": 100,
        "filters": [["is_dofollow", "=", True]],
        "order_by": ["source_domain_rate,desc"],
    },
    timeout=120,
)

if response.status_code != 200:
    raise SystemExit(f"Request failed: {response.status_code} {response.text}")

data = response.json()
print(f"{data['count']} of ~{data['total']} backlinks, cost ${data['cost']:.6f}")
for link in data["results"]:
    print(link["source_domain"], "->", link["anchor_text"], link["source_domain_rate"])

const response = await fetch("https://data.semust.com/v1/backlinks", {
  method: "POST",
  headers: {
    "SEMUST-API-USER": "your_username",
    "SEMUST-API-PASSWORD": "your_password",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    target: "example.com",
    type: "backlinks",
    limit: 100,
    filters: [["is_dofollow", "=", true]],
    order_by: ["source_domain_rate,desc"],
  }),
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status}`);
}

const data = await response.json();
console.log(`${data.count} of ~${data.total} backlinks, cost $${data.cost}`);
for (const link of data.results) {
  console.log(link.source_domain, "->", link.anchor_text, link.source_domain_rate);
}

package main

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

func main() {
	body, _ := json.Marshal(map[string]any{
		"target":   "example.com",
		"type":     "backlinks",
		"limit":    100,
		"filters":  []any{[]any{"is_dofollow", "=", true}},
		"order_by": []string{"source_domain_rate,desc"},
	})

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

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	if resp.StatusCode != http.StatusOK {
		panic(fmt.Sprintf("request failed: %d", resp.StatusCode))
	}

	var data struct {
		Count   int     `json:"count"`
		Total   int64   `json:"total"`
		Cost    float64 `json:"cost"`
		Results []struct {
			SourceDomain     string  `json:"source_domain"`
			AnchorText       string  `json:"anchor_text"`
			SourceDomainRate float64 `json:"source_domain_rate"`
		} `json:"results"`
	}
	json.NewDecoder(resp.Body).Decode(&data)

	fmt.Printf("%d of ~%d backlinks, cost $%.6f\n", data.Count, data.Total, data.Cost)
	for _, l := range data.Results {
		fmt.Println(l.SourceDomain, "->", l.AnchorText, l.SourceDomainRate)
	}
}

<?php
$payload = json_encode([
    "target"   => "example.com",
    "type"     => "backlinks",
    "limit"    => 100,
    "filters"  => [["is_dofollow", "=", true]],
    "order_by" => ["source_domain_rate,desc"],
]);

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

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

if ($status !== 200) {
    exit("Request failed: $status\n");
}

$data = json_decode($response, true);
printf("%d of ~%d backlinks, cost $%.6f\n", $data["count"], $data["total"], $data["cost"]);
foreach ($data["results"] as $link) {
    echo $link["source_domain"], " -> ", $link["anchor_text"], "\n";
}

{
  "target": "example.com",
  "type": "backlinks",
  "limit": 1000
}

{
  "target": "example.com",
  "type": "backlinks",
  "limit": 1000,
  "cursor": "bl_4f2c8a91d0e34b7c9a15e8f60b2d7c43"
}

{
  "success": true,
  "cached": false,
  "cost": 0.030360,
  "type": "backlinks",
  "target": "example.com",
  "scope": "domain",
  "total": 337785,
  "count": 100,
  "limit": 100,
  "next_cursor": "bl_4f2c8a91d0e34b7c9a15e8f60b2d7c43",
  "results": [
    {
      "source_url": "https://blog.example.de/seo-tools",
      "source_domain": "blog.example.de",
      "target_url": "https://example.com/",
      "target_domain": "example.com",
      "source_tld": "de",
      "anchor_text": "example seo tools",
      "anchor_type": "branded",
      "image_url": null,
      "image_alt": null,
      "context_before": "we recommend",
      "context_after": "for link research",
      "link_type": "text",
      "link_position": "content",
      "is_dofollow": true,
      "is_ugc": false,
      "is_sponsored": false,
      "rel_attributes": [],
      "via_redirect": false,
      "identical_links_count": 1,
      "is_new": false,
      "is_live": true,
      "is_broken": false,
      "first_seen": "2024-02-12T03:09:59Z",
      "last_seen": "2026-08-16T18:51:04Z",
      "link_rate": 70,
      "source_page_rate": 81,
      "source_domain_rate": 65,
      "source_spam_score": 0,
      "target_spam_score": 0,
      "source_type": "blog",
      "source_country": "DE",
      "source_language": "de",
      "source_page_title": "The best SEO tools in 2026",
      "source_page_status_code": 200,
      "source_page_size_bytes": 28259,
      "source_page_internal_links": 31,
      "source_page_external_links": 4,
      "target_status_code": 200,
      "target_redirect_url": null
    }
  ]
}

{
  "success": true,
  "cached": false,
  "cost": 0.026440,
  "type": "summary",
  "target": "example.com",
  "scope": "domain",
  "total": 1,
  "count": 1,
  "next_cursor": null,
  "result": {
    "target": "example.com",
    "first_seen": "2019-04-11T08:22:13Z",
    "lost_at": null,
    "is_live": true,
    "semust_rate": 78,
    "total_backlinks": 337785,
    "dofollow_backlinks": 291204,
    "nofollow_backlinks": 46581,
    "broken_backlinks": 812,
    "broken_pages": 96,
    "avg_spam_score": 6,
    "referring_domains": 12840,
    "referring_domains_dofollow": 9903,
    "referring_domains_nofollow": 2937,
    "referring_root_domains": 11002,
    "referring_root_domains_nofollow": 2410,
    "referring_ips": 9781,
    "referring_subnets": 6204,
    "referring_pages": 210433,
    "referring_pages_nofollow": 40122,
    "text_links_count": 298110,
    "image_links_count": 31245,
    "redirect_links_count": 8430,
    "internal_links_count": 54221,
    "outgoing_links_count": 9877,
    "links_by_tld": { "com": 201334, "de": 30122, "org": 18400 },
    "links_by_type": { "text": 298110, "image": 31245, "redirect": 8430 },
    "links_by_attribute": { "nofollow": 46581, "noopener": 12034 },
    "links_by_position": { "content": 240188, "footer": 51203, "sidebar": 30122 },
    "links_by_country": { "US": 140233, "DE": 30122, "unknown": 4021 },
    "links_by_source_type": { "blog": 90233, "news": 41022, "other": 120544 },
    "target_ip": "93.184.216.34",
    "target_country": "US",
    "target_cms": null,
    "target_server": "nginx",
    "target_spam_score": 3,
    "organic_traffic_estimate": null,
    "organic_keywords_count": null
  }
}

{
  "success": true,
  "cached": false,
  "cost": 0.026876,
  "type": "history",
  "target": "example.com",
  "scope": "domain",
  "date_from": "2025-09-01",
  "date_to": "2026-08-29",
  "total": 12,
  "count": 12,
  "next_cursor": null,
  "results": [
    {
      "date": "2026-08-01",
      "semust_rate": 78,
      "total_backlinks": 337785,
      "dofollow_backlinks": 291204,
      "referring_domains": 12840,
      "new_backlinks": 4210,
      "lost_backlinks": 3894,
      "new_referring_domains": 312,
      "lost_referring_domains": 287
    }
  ]
}

{
  "error": "invalid filter: unknown field \"domain_rating\"",
  "code": "INVALID_FILTER"
}