Webdaten

Hreflang-Validierungs-API

Validieren Sie die hreflang-Annotationen einer Seite aus HTML und HTTP-Headern und rufen Sie dann bis zu 20 alternative Seiten ab, um zu bestätigen, dass jede zurückverweist. Erkennen Sie ungültige Codes, fehlendes x-default, fehlende Selbstreferenzen und defekte Rückverweise.

Dokumentation anzeigen Kostenloses Tool testen Alle APIs entdecken

Endpunkte Aktiv

GET /v1/hreflang

Beispielanfrage

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/hreflang?url=example.com/shoes/trail-runner"

Beispielantwort 200 OK

{
  "status": "ok",
  "entries": [
    { "hreflang": "en", "url": "https://example.com/shoes/trail-runner", "valid_code": true },
    { "hreflang": "es-ES", "url": "https://example.com/es/zapatillas/trail-runner", "valid_code": true },
    { "hreflang": "x-default", "url": "https://example.com/shoes/trail-runner", "valid_code": true }
  ],
  "self_reference"
...

Beispielanfrage GET /v1/hreflang

Hauptfunktionen 4

Häufig gestellte Fragen 4

HTTP-Statuscodes 200 / 400 / 401 / 402 / 429

Kategorie Webdaten

Endpunkte 1

Hauptfunktionen 4

Häufig gestellte Fragen 4

Wird von Mitarbeitenden dieser Unternehmen genutzt

Vertrauenssignale vor der Integration

Transparente Dokumentation, authentifizierte Anfragen und sichtbare Zuverlässigkeitsdetails erleichtern die Bewertung von DomScan vor dem Launch.

Live Dienststatus

Prüfen Sie vor der Integration den aktuellen Dienstzustand und die dokumentierten Fehlerantworten.

OpenAPI API-Artefakte

OpenAPI, Swagger, Postman, CLI, SDK und MCP-Links sind nur einen Klick entfernt.

API-Schlüssel Geschützter Zugriff

Authentifizierte Endpunkte nutzen API-Schlüssel mit klaren Credit-Kosten vor dem Aufruf.

10,000 Kostenloses Kontingent

Starte mit 10.000 monatlichen Credits und upgrade erst, wenn die Nutzung wächst.

Wobei diese API beim Bauen hilft

Nutze diese Seite als Produktionsbriefing: Endpoints, Beispiele, Antwortstruktur und Workflow-Bausteine, um DomScan in dein Produkt einzubinden.

Produkt-Workflows

Bette Domainchecks, DNS-Intelligence, Risikosignale oder Anreicherung in Onboarding, Suche und interne Tools ein.

Analysten-Automatisierung

Ersetze wiederholte manuelle Lookups durch geplante Jobs, Alerts und reproduzierbare Untersuchungsschritte.

Saubere JSON-Daten

Nutze vorhersehbare Felder, dokumentierte Statuscodes und Credit-Kosten statt Provider-Seiten zu scrapen.

KI- und Ops-Tools

Versorge Agenten, Dashboards, SOAR-Playbooks und CRMs über OpenAPI, SDK, Postman oder MCP.

Integrationsablauf

Ein einfacher Weg von der ersten Anfrage bis zur wiederholbaren Nutzung in Produktion.

Einmal authentifizieren

Sende deinen API-Schlüssel mit dem dokumentierten Header und halte Anfragen über Services hinweg konsistent.

Mit Beispielen abfragen

Starte mit den curl- und HTTP-Beispielen und übertrage die Parameter dann in deinen Anwendungscode.

Betreiben und überwachen

Nutze Statuscodes, Credit-Kosten und Antwortfelder, um Retries, Logs und Alerts zu bauen.

Developer-Kit

Wechsle von dieser Seite zu maschinenlesbaren Docs, Request-Sammlungen, SDKs oder Agenten-Tools.

OpenAPI-Schema

Generiere Clients oder prüfe jede Request- und Response-Struktur.

Postman-Collection

Importiere fertige Requests für manuelle Tests und Team-Handoff.

SDKs und CLI

Nutze gepflegte Pakete und Kommandozeilen-Workflows statt Boilerplate zu schreiben.

MCP-Integration

Stelle Domain-Intelligence für KI-Agenten und interne Assistenten bereit.

Parameter- und Antwortkarte

Prüfe Eingaben, Ausgabefelder und Statuscodes, bevor du den Endpoint in deinen Client einbindest.

Request-Parameter

Parameter

urlmax_alternates

Antwortfelder

Beispielantwort

statusentriesself_referencex_defaultissuesreturn_linksreturn_links.checkedreturn_links.confirmedreturn_links.missingreturn_links.unknown

Statusabdeckung

HTTP-Statuscodes

200400401402429

Endpunkte

GET /v1/hreflang

Credits: 3Authentifizierung: Authentifizierung erforderlich

Vertrauenssignale vor der Integration

Transparente Dokumentation, authentifizierte Anfragen und sichtbare Zuverlässigkeitsdetails erleichtern die Bewertung von DomScan vor dem Launch.

Dienststatus API-Artefakte

OpenAPI, Swagger, Postman, CLI, SDK und MCP-Links sind nur einen Klick entfernt.

API-Schlüssel Geschützter Zugriff

Authentifizierte Endpunkte nutzen API-Schlüssel mit klaren Credit-Kosten vor dem Aufruf.

Kostenloses Kontingent Kostenlos anmelden

Starte mit 10.000 monatlichen Credits und upgrade erst, wenn die Nutzung wächst.

Aktiv Beispielanfrage

Starte mit den curl- und HTTP-Beispielen und übertrage die Parameter dann in deinen Anwendungscode.

Hauptfunktionen

Code-Validierung

Sprach-, Schrift- und Regions-Subtags werden geprüft, einschließlich häufiger Fehler wie en-UK statt en-GB und Unterstriche statt Bindestriche.

Prüfung der Rückverweise

Alternative Seiten werden abgerufen, um zu bestätigen, dass sie auf die Seite zurückverweisen, und Weiterleitungen, Canonicals, die woandershin zeigen, sowie Sprachabweichungen werden markiert.

HTML und HTTP-Header

Annotationen werden aus Link-Tags und aus dem HTTP-Link-Header gelesen, und jeder Eintrag zeigt, wo er gefunden wurde.

Probleme auf Set-Ebene

Fehlende Selbstreferenz, fehlendes x-default, relative URLs und ein Code, der auf mehrere URLs zeigt, werden für das gesamte Set gemeldet.

Beispielanfrage

GET /v1/hreflang?url=example.com/shoes/trail-runner bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/hreflang?url=example.com/shoes/trail-runner"

Beispielantwort

200 OK json

{
  "status": "ok",
  "entries": [
    { "hreflang": "en", "url": "https://example.com/shoes/trail-runner", "valid_code": true },
    { "hreflang": "es-ES", "url": "https://example.com/es/zapatillas/trail-runner", "valid_code": true },
    { "hreflang": "x-default", "url": "https://example.com/shoes/trail-runner", "valid_code": true }
  ],
  "self_reference": true,
  "x_default": true,
  "issues": [],
  "return_links": { "checked": 1, "confirmed": 1, "missing": 0, "unknown": 0 }
}

Häufig gestellte Fragen

Was bedeutet missing_return_links?

Mindestens eine alternative Seite wurde gelesen und verweist nicht auf die geprüfte Seite zurück. Hreflang-Annotationen müssen gegenseitig sein, sonst ignorieren Suchmaschinen sie möglicherweise.

Was passiert, wenn eine alternative Seite nicht gelesen werden kann?

Sie wird mit einem Grund als unknown gemeldet, nie als fehlender Rückverweis, sodass blockierte oder langsame Seiten keine falschen Fehler erzeugen.

Werden hreflang-Einträge in XML-Sitemaps geprüft?

Diese API prüft das HTML der Seite und die HTTP-Header. Nutzen Sie die Sitemap-Audit-API, um zu sehen, ob Sitemaps hreflang-Erweiterungen enthalten.

Wie viele Credits kostet es?

Drei Credits pro Audit, einschließlich der Rückverweisprüfung von bis zu 20 alternativen Seiten. Ergebnisse mit status unknown werden erstattet.

HTTP-Statuscodes

Das sind die HTTP-Statuscodes, die Sie behandeln sollten, damit Sie erfolgreiche Antworten, Authentifizierungsprobleme, Credits, Ratenlimits, fehlende Daten und Upstream-Fehler unterscheiden können.

OK 200

Anfrage erfolgreich

Ungültige Anfrage 400

Ungültige Parameter

Nicht autorisiert 401

API-Schlüssel oder Sitzung fehlt oder ist ungültig.

Zahlung erforderlich 402

Nicht genügend Credits für diese Anfrage.

Zu viele Anfragen 429

Ratenlimit überschritten

Hreflang validieren

Kostenlos starten Dokumentation anzeigen Kostenloses Tool testen

Support

Hreflang-Validierungs-API

Vertrauenssignale vor der Integration

Wobei diese API beim Bauen hilft

Integrationsablauf

Developer-Kit

Parameter- und Antwortkarte

Endpunkte

Vertrauenssignale vor der Integration

Hauptfunktionen

Beispielanfrage

Beispielantwort

Häufig gestellte Fragen

Verwandte Tools und Ressourcen

HTTP-Statuscodes