Entwickler-Referenz
Portfolio-Audit-Rezept
DomScan-API: Überprüfen Sie gesamte Domain-Portfolios auf Gesundheit, Bewertung und Optimierungsmöglichkeiten.
Portfolio-Audit-Rezept
Überprüfen Sie gesamte Domain-Portfolios auf Gesundheit, Bewertung und Optimierungsmöglichkeiten.
POST
/v1/recipes/portfolio-audit
Anfragetext
{
"domains": [
"domain1.com",
"domain2.io",
"domain3.app"
]
}
Antwort enthält
- Zustand jeder Domain
- Bewertungsschätzungen
- Überwachung der Ablaufdaten
- SSL-Zertifikatstatus
- DNS-Konfigurationsprobleme
- Portfolioübergreifende Erkenntnisse und Empfehlungen
Antwortfelder
| Feld | Typ |
|---|---|
success |
boolean |
data |
object |
data.summary |
object |
data.summary.total_domains |
number |
data.summary.total_value_low |
number |
data.summary.total_value_high |
number |
data.summary.average_health_score |
number |
data.summary.expiring_soon |
number |
data.summary.renewal_cost_annual |
number |
data.alerts[] |
object[] |
data.alerts[] |
object |
data.alerts[].domain |
string |
data.alerts[].type |
string |
data.alerts[].severity |
string |
data.alerts[].message |
string |
data.alerts[].action |
string |
data.optimization |
object |
data.optimization.registrar_consolidation |
object |
data.optimization.registrar_consolidation.current_registrars |
number |
data.optimization.registrar_consolidation.recommendation |
string |
data.optimization.registrar_consolidation.potential_savings |
number |
data.optimization.underperforming[] |
string[] |
data.optimization.top_valuable[] |
string[] |
data.domains[] |
object[] |
data.domains[] |
object |
data.domains[].domain |
string |
data.domains[].status |
string |
data.domains[].value_estimate |
object |
data.domains[].value_estimate.low |
number |
data.domains[].value_estimate.mid |
number |
data.domains[].value_estimate.high |
number |
data.domains[].health_score |
number |
data.domains[].health_grade |
string |
data.domains[].expiry_date |
string |
data.domains[].days_until_expiry |
number |
data.domains[].renewal_price |
number |
data.domains[].issues[] |
array |
meta |
object |
meta.recipe_name |
string |
meta.credits_used |
number |
meta.credits_saved |
number |
meta.duration_ms |
number |
meta.components_called[] |
string[] |
meta.cached_components[] |
string[] |
meta.timestamp |
string |
errors[] |
array |
Beispielantwort
{
"success": true,
"data": {
"summary": {
"total_domains": 3,
"total_value_low": 3200,
"total_value_high": 12400,
"average_health_score": 78,
"expiring_soon": 1,
"renewal_cost_annual": 98.4
},
"alerts": [
{
"domain": "brandold.com",
"type": "expiration",
"severity": "high",
"message": "Expires in 12 days.",
"action": "Renew immediately"
}
],
"optimization": {
"registrar_consolidation": {
"current_registrars": 3,
"recommendation": "Move long-tail domains to a single low-cost registrar.",
"potential_savings": 48
},
"underperforming": [
"brandold.com"
],
"top_valuable": [
"brand.com"
]
},
"domains": [
{
"domain": "brand.com",
"status": "owned",
"value_estimate": {
"low": 2500,
"mid": 4600,
"high": 9000
},
"health_score": 92,
"health_grade": "A",
"expiry_date": "2027-02-01",
"days_until_expiry": 292,
"renewal_price": 12.99,
"issues": []
}
]
},
"meta": {
"recipe_name": "portfolio-audit",
"credits_used": 25,
"credits_saved": 275,
"duration_ms": 1298,
"components_called": [
"availability",
"whois",
"valuation",
"health",
"pricing"
],
"cached_components": [
"valuation"
],
"timestamp": "2026-04-15T10:31:00Z"
},
"errors": []
}
GET
/v1/recipes/portfolio-audit
Credits: 25
Abfrageparameter
| Parameter | Typ | erforderlich |
|---|---|---|
| domains | string | erforderlich |
| include_valuation |
boolean
Standard
true
|
optional |
| include_health |
boolean
Standard
true
|
optional |
| include_pricing |
boolean
Standard
true
|
optional |
| alert_expiring_days |
integer
Standard
90
|
optional |
| dry_run |
string
Zulässige Werte
true
|
optional |
Antwortfelder
| Feld | Typ |
|---|---|
success |
boolean |
data |
object |
data.summary |
object |
data.summary.total_domains |
number |
data.summary.total_value_low |
number |
data.summary.total_value_high |
number |
data.summary.average_health_score |
number |
data.summary.expiring_soon |
number |
data.summary.renewal_cost_annual |
number |
data.alerts[] |
object[] |
data.alerts[] |
object |
data.alerts[].domain |
string |
data.alerts[].type |
string |
data.alerts[].severity |
string |
data.alerts[].message |
string |
data.alerts[].action |
string |
data.optimization |
object |
data.optimization.registrar_consolidation |
object |
data.optimization.registrar_consolidation.current_registrars |
number |
data.optimization.registrar_consolidation.recommendation |
string |
data.optimization.registrar_consolidation.potential_savings |
number |
data.optimization.underperforming[] |
string[] |
data.optimization.top_valuable[] |
string[] |
data.domains[] |
object[] |
data.domains[] |
object |
data.domains[].domain |
string |
data.domains[].status |
string |
data.domains[].value_estimate |
object |
data.domains[].value_estimate.low |
number |
data.domains[].value_estimate.mid |
number |
data.domains[].value_estimate.high |
number |
data.domains[].health_score |
number |
data.domains[].health_grade |
string |
data.domains[].expiry_date |
string |
data.domains[].days_until_expiry |
number |
data.domains[].renewal_price |
number |
data.domains[].issues[] |
array |
meta |
object |
meta.recipe_name |
string |
meta.credits_used |
number |
meta.credits_saved |
number |
meta.duration_ms |
number |
meta.components_called[] |
string[] |
meta.cached_components[] |
string[] |
meta.timestamp |
string |
errors[] |
array |
Beispielanfrage
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/recipes/portfolio-audit?domains=example.com%2Cexample.net&include_valuation=true&include_health=true&include_pricing=true&alert_expiring_days=90"const response = await fetch("https://domscan.net/v1/recipes/portfolio-audit?domains=example.com%2Cexample.net&include_valuation=true&include_health=true&include_pricing=true&alert_expiring_days=90", {
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.get(
"https://domscan.net/v1/recipes/portfolio-audit?domains=example.com%2Cexample.net&include_valuation=true&include_health=true&include_pricing=true&alert_expiring_days=90",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/recipes/portfolio-audit?domains=example.com%2Cexample.net&include_valuation=true&include_health=true&include_pricing=true&alert_expiring_days=90", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/recipes/portfolio-audit?domains=example.com%2Cexample.net&include_valuation=true&include_health=true&include_pricing=true&alert_expiring_days=90")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))Beispielantwort
{
"success": true,
"data": {
"summary": {
"total_domains": 3,
"total_value_low": 3200,
"total_value_high": 12400,
"average_health_score": 78,
"expiring_soon": 1,
"renewal_cost_annual": 98.4
},
"alerts": [
{
"domain": "brandold.com",
"type": "expiration",
"severity": "high",
"message": "Expires in 12 days.",
"action": "Renew immediately"
}
],
"optimization": {
"registrar_consolidation": {
"current_registrars": 3,
"recommendation": "Move long-tail domains to a single low-cost registrar.",
"potential_savings": 48
},
"underperforming": [
"brandold.com"
],
"top_valuable": [
"brand.com"
]
},
"domains": [
{
"domain": "brand.com",
"status": "owned",
"value_estimate": {
"low": 2500,
"mid": 4600,
"high": 9000
},
"health_score": 92,
"health_grade": "A",
"expiry_date": "2027-02-01",
"days_until_expiry": 292,
"renewal_price": 12.99,
"issues": []
}
]
},
"meta": {
"recipe_name": "portfolio-audit",
"credits_used": 25,
"credits_saved": 275,
"duration_ms": 1298,
"components_called": [
"availability",
"whois",
"valuation",
"health",
"pricing"
],
"cached_components": [
"valuation"
],
"timestamp": "2026-04-15T10:31:00Z"
},
"errors": []
}
HTTP-Statuscodes
200OK400Ungültige Anfrage401Nicht autorisiert402Zahlung erforderlich429Zu viele Anfragen