Webbdata

API för hreflang-validering

Validera hreflang-annotationerna på en sida från HTML och HTTP-rubriker och hämta sedan upp till 20 alternativa sidor för att bekräfta att var och en länkar tillbaka. Hitta ogiltiga koder, saknad x-default, saknade självreferenser och trasiga returlänkar.

Category Webbdata
Slutpunkter 1
Nyckelfunktioner 4
Vanliga frågor 4

Används av människor på dessa företag

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse

Förtroendesignaler före integration

Transparent dokumentation, autentiserade anrop och synliga tillförlitlighetsdetaljer gör DomScan lättare att utvärdera före lansering.

I drift Tjänstestatus

Kontrollera tjänstens aktuella status och dokumenterade felsvar innan du integrerar.

OpenAPI API-material

OpenAPI, Swagger, Postman, CLI, SDK och MCP-länkar finns ett klick bort.

API-nycklar Skyddad åtkomst

Autentiserade endpoints använder API-nycklar med tydliga kreditkostnader före anrop.

10,000 Gratis kvot

Börja med 10 000 krediter per månad och uppgradera först när användningen växer.

Vad detta API hjälper dig att leverera

Använd sidan som en produktionsbrief: endpoints, exempel, responsform och workflow-delar som krävs för att koppla DomScan till din produkt.

Produktworkflows

Bädda in domänkontroller, DNS-intelligence, risksignaler eller berikning i onboarding, sök och interna verktyg.

Analystautomatisering

Ersätt upprepade manuella lookups med schemalagda jobb, alerts och reproducerbara utredningssteg.

Ren JSON-data

Använd förutsägbara fält, dokumenterade statuskoder och kreditkostnader istället för att skrapa leverantörssidor.

AI- och ops-verktyg

Mata agenter, dashboards, SOAR-playbooks och CRM:er via OpenAPI, SDK, Postman eller MCP.

Integrationsworkflow

En enkel väg från första request till repeterbar produktion.

1
Autentisera en gång

Skicka din API-nyckel med dokumenterad header och håll requests konsekventa mellan tjänster.

2
Fråga med exempel

Börja med curl- och HTTP-exempel och mappa sedan parametrarna till din applikationskod.

3
Drifta och övervaka

Använd statuskoder, kreditkostnader och responsfält för retries, loggar och alerts.

Utvecklarkit

Gå från sidan till maskinläsbara docs, request-samlingar, SDK:er eller agentverktyg.

Parameter- och responskarta

Granska inputs, outputfält och statuskoder innan endpointen kopplas in i din klient.

Requestparametrar

Parameter

urlmax_alternates
Responsfält

Exempelsvar

statusentriesself_referencex_defaultissuesreturn_linksreturn_links.checkedreturn_links.confirmedreturn_links.missingreturn_links.unknown
Statustäckning

HTTP-statuskoder

200400401402429

Slutpunkter

GET /v1/hreflang
Krediter: 3Autentisering: Autentisering krävs

Förtroendesignaler före integration

Transparent dokumentation, autentiserade anrop och synliga tillförlitlighetsdetaljer gör DomScan lättare att utvärdera före lansering.

Tjänstestatus API-material

OpenAPI, Swagger, Postman, CLI, SDK och MCP-länkar finns ett klick bort.

API-nycklar Skyddad åtkomst

Autentiserade endpoints använder API-nycklar med tydliga kreditkostnader före anrop.

Gratis kvot Registrera dig gratis

Börja med 10 000 krediter per månad och uppgradera först när användningen växer.

Aktiv Exempelbegäran

Börja med curl- och HTTP-exempel och mappa sedan parametrarna till din applikationskod.

Nyckelfunktioner

Kodvalidering

Språk-, skript- och regionundertaggar kontrolleras, inklusive vanliga misstag som en-UK i stället för en-GB och understreck i stället för bindestreck.

Kontroll av returlänkar

Alternativa sidor hämtas för att bekräfta att de länkar tillbaka till sidan, och omdirigeringar, canonical-länkar som pekar någon annanstans och språkavvikelser flaggas.

HTML och HTTP-rubriker

Annotationer läses från länktaggar och från HTTP Link-rubriken, och varje post visar var den hittades.

Problem på mängdnivå

Saknad självreferens, saknad x-default, relativa URL:er och en kod som pekar på flera URL:er rapporteras för hela mängden.

Exempelbegäran

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"

Exempelsvar

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

Vanliga frågor

Vad betyder missing_return_links?

Minst en alternativ sida lästes och länkar inte tillbaka till den granskade sidan. Hreflang-annotationer måste vara ömsesidiga, annars kan sökmotorer ignorera dem.

Vad händer om en alternativ sida inte kan läsas?

Den rapporteras som okänd med en orsak, aldrig som en saknad returlänk, så att blockerade eller långsamma sidor inte skapar falska fel.

Kontrolleras hreflang-poster i XML-sitemaps?

Detta API kontrollerar sidans HTML och HTTP-rubriker. Använd API:et för sitemap-granskning för att se om sitemaps har hreflang-tillägg.

Hur många krediter kostar det?

Tre krediter per granskning, inklusive kontroller av returlänkar på upp till 20 alternativa sidor. Resultat som slutar med status unknown återbetalas.

Relaterade verktyg och resurser

HTTP-statuskoder

Det här är de HTTP-statuskoder som du bör hantera, så att du kan skilja mellan lyckade svar, autentiseringsproblem, krediter, hastighetsgränser, saknade data och fel hos externa tjänster.

OK 200

Begäran lyckades

Felaktig begäran 400

Ogiltiga parametrar

Obehörig 401

API-nyckel eller session saknas eller är ogiltig.

Betalning krävs 402

Det finns inte tillräckligt med krediter för att köra denna begäran.

För många begäranden 429

Hastighetsgränsen överskriden