Webdata

Hreflang-validatie-API

Valideer de hreflang-annotaties van een pagina uit HTML en HTTP-headers en haal vervolgens maximaal 20 alternatieve pagina's op om te bevestigen dat elk ervan terugverwijst. Vind ongeldige codes, ontbrekende x-default, ontbrekende zelfverwijzingen en kapotte terugverwijzingen.

Documentatie bekijken Gratis tool proberen Ontdek alle API's

Endpoints Actief

GET /v1/hreflang

Voorbeeldverzoek

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

Voorbeeldantwoord 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"
...

Voorbeeldverzoek GET /v1/hreflang

Belangrijkste functies 4

Veelgestelde vragen 4

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

Categorie Webdata

Endpoints 1

Belangrijkste functies 4

Veelgestelde vragen 4

Gebruikt door mensen bij deze bedrijven

Vertrouwenssignalen voordat je integreert

Transparante documentatie, geauthenticeerde requests en zichtbare betrouwbaarheidsdetails maken DomScan makkelijker te beoordelen voor livegang.

Actief Servicestatus

Controleer vóór de integratie de live servicestatus en de gedocumenteerde foutreacties.

OpenAPI API-artifacts

OpenAPI, Swagger, Postman, CLI, SDK en MCP-links zijn één klik verwijderd.

API-sleutels Beschermde toegang

Geauthenticeerde endpoints gebruiken API-sleutels met duidelijke creditkosten voordat je ze aanroept.

10,000 Gratis tegoed

Begin met 10.000 maandelijkse credits en upgrade pas wanneer het gebruik groeit.

Wat deze API je helpt bouwen

Gebruik deze pagina als productiebriefing: endpoints, voorbeelden, responsstructuur en workflow-onderdelen om DomScan in je product te koppelen.

Productworkflows

Integreer domeinchecks, DNS-intelligence, risicosignalen of verrijking in onboarding, zoeken en interne tools.

Analistautomatisering

Vervang herhaalde handmatige lookups door geplande taken, alerts en reproduceerbare onderzoeksstappen.

Schone JSON-data

Gebruik voorspelbare velden, gedocumenteerde statuscodes en kredietkosten in plaats van providerpagina’s te scrapen.

AI- en ops-tools

Voed agents, dashboards, SOAR-playbooks en CRMs via OpenAPI, SDK, Postman of MCP.

Integratieworkflow

Een eenvoudig pad van de eerste request naar herhaalbaar productiegebruik.

Eenmalig authenticeren

Stuur je API-sleutel met de gedocumenteerde header en houd requests consistent tussen services.

Query met voorbeelden

Start met de curl- en HTTP-voorbeelden en map daarna de parameters naar je applicatiecode.

Opereren en monitoren

Gebruik statuscodes, kredietkosten en responsvelden om retries, logs en alerts te bouwen.

Developerkit

Ga vanaf deze pagina naar machineleesbare docs, requestcollecties, SDKs of agenttools.

OpenAPI-schema

Genereer clients of inspecteer elke request- en responsvorm.

Postman-collectie

Importeer kant-en-klare requests voor handmatig testen en overdracht aan het team.

SDKs en CLI

Gebruik onderhouden pakketten en commandline-workflows in plaats van boilerplate te schrijven.

MCP-integratie

Stel domeinintelligence beschikbaar aan AI-agents en interne assistentworkflows.

Parameter- en responskaart

Bekijk inputs, outputvelden en statuscodes voordat je het endpoint in je client aansluit.

Requestparameters

Parameter

urlmax_alternates

Responsvelden

Voorbeeldantwoord

statusentriesself_referencex_defaultissuesreturn_linksreturn_links.checkedreturn_links.confirmedreturn_links.missingreturn_links.unknown

Statusdekking

HTTP-statuscodes

200400401402429

Endpoints

GET /v1/hreflang

Tegoeden: 3Authenticatie: Authenticatie vereist

Vertrouwenssignalen voordat je integreert

Transparante documentatie, geauthenticeerde requests en zichtbare betrouwbaarheidsdetails maken DomScan makkelijker te beoordelen voor livegang.

Servicestatus API-artifacts

OpenAPI, Swagger, Postman, CLI, SDK en MCP-links zijn één klik verwijderd.

API-sleutels Beschermde toegang

Geauthenticeerde endpoints gebruiken API-sleutels met duidelijke creditkosten voordat je ze aanroept.

Gratis tegoed Gratis registreren

Begin met 10.000 maandelijkse credits en upgrade pas wanneer het gebruik groeit.

Actief Voorbeeldverzoek

Start met de curl- en HTTP-voorbeelden en map daarna de parameters naar je applicatiecode.

Belangrijkste functies

Codevalidatie

Taal-, script- en regiosubtags worden gecontroleerd, inclusief veelgemaakte fouten zoals en-UK in plaats van en-GB en underscores in plaats van koppeltekens.

Controles op terugverwijzingen

Alternatieve pagina's worden opgehaald om te bevestigen dat ze naar de pagina terugverwijzen, en omleidingen, canonicals die elders naartoe wijzen en taalverschillen worden gemarkeerd.

HTML en HTTP-headers

Annotaties worden gelezen uit link-tags en uit de HTTP Link-header, en elke vermelding toont waar die is gevonden.

Problemen op setniveau

Ontbrekende zelfverwijzing, ontbrekende x-default, relatieve URL's en een code die naar meerdere URL's wijst, worden voor de hele set gemeld.

Voorbeeldverzoek

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"

Voorbeeldantwoord

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 }
}

Veelgestelde vragen

Wat betekent missing_return_links?

Minstens één alternatieve pagina is gelezen en verwijst niet terug naar de gecontroleerde pagina. Hreflang-annotaties moeten wederkerig zijn, anders negeren zoekmachines ze mogelijk.

Wat als een alternatieve pagina niet gelezen kan worden?

Die wordt gemeld als onbekend met een reden, nooit als ontbrekende terugverwijzing, zodat geblokkeerde of trage pagina's geen valse fouten veroorzaken.

Worden hreflang-vermeldingen in de XML-sitemap gecontroleerd?

Deze API controleert de HTML en HTTP-headers van de pagina. Gebruik de sitemap-audit-API om te zien of sitemaps hreflang-extensies bevatten.

Hoeveel credits kost het?

Drie credits per audit, inclusief controles op terugverwijzingen van maximaal 20 alternatieve pagina's. Resultaten die eindigen met status unknown worden terugbetaald.

Gerelateerde hulpprogramma's en bronnen

HTTP-statuscodes

Dit zijn de HTTP-statuscodes die je moet afhandelen, zodat je succesvolle responses, authenticatieproblemen, credits, ratelimieten, ontbrekende gegevens en upstreamfouten kunt onderscheiden.

OK 200

Aanvraag geslaagd

Ongeldig verzoek 400

Ongeldige parameters

Niet geautoriseerd 401

Ontbrekende dan wel ongeldige API-sleutel of sessie.

Betaling vereist 402

Niet genoeg credits om deze aanvraag uit te voeren.

Te veel verzoeken 429

Snelheidslimiet overschreden

Valideer hreflang

Gratis starten Documentatie bekijken Gratis tool proberen