Datos web

API de validación de hreflang

Valida las anotaciones hreflang de una página a partir del HTML y de las cabeceras HTTP, y después descarga hasta 20 páginas alternativas para confirmar que cada una enlaza de vuelta. Detecta códigos no válidos, x-default ausente, autorreferencias ausentes y enlaces de retorno rotos.

Ver documentación Probar la herramienta gratuita Explorar todas las API

Endpoints Activo

GET /v1/hreflang

Solicitud de ejemplo

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

Respuesta de ejemplo 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"
...

Solicitud de ejemplo GET /v1/hreflang

Características principales 4

Preguntas frecuentes 4

Códigos de estado HTTP 200 / 400 / 401 / 402 / 429

Categoría Datos web

Endpoints 1

Características principales 4

Preguntas frecuentes 4

Utilizado por personas en estas empresas

Señales de confianza antes de integrar

Documentación transparente, solicitudes autenticadas y detalles visibles de fiabilidad facilitan evaluar DomScan antes de publicar.

En directo Estado del servicio

Consulta el estado del servicio en directo y las respuestas de error documentadas antes de integrar la API.

OpenAPI Artefactos de API

OpenAPI, Swagger, Postman, CLI, SDK y enlaces MCP están a un clic.

Claves API Acceso protegido

Los endpoints autenticados usan claves API con costes de créditos claros antes de llamarlos.

10,000 Créditos gratuitos

Empieza con 10.000 créditos mensuales y actualiza solo cuando crezca el uso.

Qué te ayuda a lanzar esta API

Usa esta página como un resumen de producción: endpoints, ejemplos, forma de respuesta y piezas de flujo necesarias para integrar DomScan en tu producto.

Flujos de producto

Integra comprobaciones de dominios, inteligencia DNS, señales de riesgo o enriquecimiento en onboarding, búsqueda y herramientas internas.

Automatización de analistas

Sustituye consultas manuales repetidas por tareas programadas, alertas y pasos de investigación reproducibles.

Datos JSON limpios

Usa campos previsibles, códigos de estado documentados y costes de créditos en lugar de raspar páginas de proveedores.

IA y operaciones

Alimenta agentes, paneles, playbooks SOAR y CRMs mediante OpenAPI, SDK, Postman o MCP.

Flujo de integración

Un camino simple desde la primera solicitud hasta un uso repetible en producción.

Autentica una vez

Envía tu clave API con la cabecera documentada y mantén solicitudes coherentes entre servicios.

Consulta con ejemplos

Empieza con las muestras curl y HTTP, y luego mapea los parámetros en el código de tu aplicación.

Opera y monitoriza

Usa códigos de estado, costes de créditos y campos de respuesta para crear reintentos, logs y alertas.

Kit para desarrolladores

Salta desde esta página a documentación legible por máquinas, colecciones de solicitudes, SDKs o herramientas para agentes.

Esquema OpenAPI

Genera clientes o inspecciona cada forma de solicitud y respuesta.

Colección Postman

Importa solicitudes listas para pruebas manuales y traspaso al equipo.

SDKs y CLI

Usa paquetes mantenidos y flujos de línea de comandos en vez de escribir boilerplate.

Integración MCP

Expón inteligencia de dominios a agentes de IA y asistentes internos.

Mapa de parámetros y respuesta

Revisa entradas, campos de salida y códigos de estado antes de conectar el endpoint a tu cliente.

Parámetros de solicitud

Parámetro

urlmax_alternates

Campos de respuesta

Respuesta de ejemplo

statusentriesself_referencex_defaultissuesreturn_linksreturn_links.checkedreturn_links.confirmedreturn_links.missingreturn_links.unknown

Cobertura de estados

Códigos de estado HTTP

200400401402429

Endpoints

GET /v1/hreflang

Créditos: 3Autenticación: Autenticación requerida

Señales de confianza antes de integrar

Documentación transparente, solicitudes autenticadas y detalles visibles de fiabilidad facilitan evaluar DomScan antes de publicar.

Estado del servicio Artefactos de API

OpenAPI, Swagger, Postman, CLI, SDK y enlaces MCP están a un clic.

Claves API Acceso protegido

Los endpoints autenticados usan claves API con costes de créditos claros antes de llamarlos.

Créditos gratuitos Regístrate gratis

Empieza con 10.000 créditos mensuales y actualiza solo cuando crezca el uso.

Activo Solicitud de ejemplo

Empieza con las muestras curl y HTTP, y luego mapea los parámetros en el código de tu aplicación.

Características principales

Validación de códigos

Se comprueban los subetiquetas de idioma, escritura y región, incluidos errores habituales como en-UK en lugar de en-GB y guiones bajos en lugar de guiones.

Comprobación de enlaces de retorno

Se descargan las páginas alternativas para confirmar que enlazan de vuelta a la página, y se señalan las redirecciones, los canonicals que apuntan a otra parte y las discrepancias de idioma.

HTML y cabeceras HTTP

Las anotaciones se leen de las etiquetas link y de la cabecera HTTP Link, y cada entrada muestra dónde se encontró.

Problemas a nivel de conjunto

La autorreferencia ausente, x-default ausente, las URL relativas y un mismo código que apunta a varias URL se notifican para todo el conjunto.

Solicitud de ejemplo

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"

Respuesta de ejemplo

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

Preguntas frecuentes

¿Qué significa missing_return_links?

Se leyó al menos una página alternativa y no enlaza de vuelta a la página auditada. Las anotaciones hreflang deben ser recíprocas o los buscadores pueden ignorarlas.

¿Qué ocurre si una página alternativa no se puede leer?

Se notifica como desconocida con un motivo, nunca como enlace de retorno ausente, para que las páginas bloqueadas o lentas no generen falsos errores.

¿Se comprueban las entradas hreflang de los sitemaps XML?

Esta API comprueba el HTML de la página y las cabeceras HTTP. Usa la API de auditoría de sitemaps para ver si los sitemaps incluyen extensiones hreflang.

¿Cuántos créditos cuesta?

Tres créditos por auditoría, incluida la comprobación de enlaces de retorno de hasta 20 páginas alternativas. Los resultados que terminan en status unknown se reembolsan.

Herramientas y recursos relacionados

Códigos de estado HTTP

Documentamos los códigos de estado HTTP que debes gestionar para distinguir respuestas correctas, problemas de autenticación o créditos, límites de frecuencia, datos inexistentes y fallos del servicio de origen.

OK 200

Solicitud correcta

Solicitud incorrecta 400

Parámetros no válidos

No autorizado 401

Clave de API o sesión ausente o no válida.

Pago requerido 402

No tienes créditos suficientes para ejecutar esta solicitud.

Demasiadas solicitudes 429

Límite de frecuencia superado

Validar hreflang

Empezar gratis Ver documentación Probar la herramienta gratuita