Datos web

API de auditoría SEO on-page

Audita una página por petición y obtén todas las señales SEO on-page en una sola respuesta JSON: metaetiquetas, directivas canonical y robots, estructura de encabezados, número de palabras, enlaces, imágenes, Open Graph y datos estructurados, además de 38 comprobaciones ponderadas y una puntuación de 0 a 100. Añade render=true para auditar la página después de ejecutar JavaScript.

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

Endpoints Activo

GET /v1/onpage

Solicitud de ejemplo

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

Respuesta de ejemplo 200 OK

{
  "status": "ok",
  "score": 87,
  "meta": {
    "title": "Trail Running Shoes for Rocky Terrain | Example Outdoor",
    "title_length": 55,
    "canonical_self_referencing": true,
    "indexable": true
  },
  "headings": { "h1": ["Trail Running Shoes for Rocky Terrain"] },
  "content": { "word_count": 122, "text_to_html_ratio": 0.221 },
  "checks": [
...

Solicitud de ejemplo GET /v1/onpage

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

urlrender

Campos de respuesta

Respuesta de ejemplo

statusscoremetameta.titlemeta.title_lengthmeta.canonical_self_referencingmeta.indexableheadingsheadings.h1contentcontent.word_countcontent.text_to_html_ratio

Cobertura de estados

Códigos de estado HTTP

200400401402429

Endpoints

GET /v1/onpage

Créditos: 2-6Autenticació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

Sin procesar o renderizada

Audita el HTML que envía tu servidor o usa render=true para auditar la página después de ejecutar JavaScript en un navegador aislado, tal como ven las aplicaciones de una sola página los rastreadores modernos.

38 comprobaciones ponderadas

Cada comprobación devuelve aprobado, advertencia, fallo o no aplicable con una gravedad, desde títulos ausentes y canonicals contradictorios hasta contenido mixto, imágenes sin texto alt y niveles de encabezado omitidos.

Todas las señales en una sola llamada

Longitud del título y de la descripción, meta robots y X-Robots-Tag, idioma, viewport, favicon, Open Graph, Twitter cards, recuento de enlaces e imágenes y tipos de datos estructurados.

Desconocidos con honestidad

Las descargas bloqueadas, limitadas por frecuencia o fallidas devuelven status unknown con un motivo y se reembolsan, de modo que una página que no pudiste leer nunca parece una página limpia.

Solicitud de ejemplo

GET /v1/onpage?url=example.com/shoes/trail-runner&render=true bash

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

Respuesta de ejemplo

200 OK json

{
  "status": "ok",
  "score": 87,
  "meta": {
    "title": "Trail Running Shoes for Rocky Terrain | Example Outdoor",
    "title_length": 55,
    "canonical_self_referencing": true,
    "indexable": true
  },
  "headings": { "h1": ["Trail Running Shoes for Rocky Terrain"] },
  "content": { "word_count": 122, "text_to_html_ratio": 0.221 },
  "checks": [
    { "id": "mixed_content", "status": "fail", "severity": "high", "value": 1 },
    { "id": "images_alt", "status": "warn", "severity": "medium", "value": 1 }
  ],
  "issues": ["mixed_content", "heading_hierarchy", "word_count", "images_alt"]
}

Preguntas frecuentes

¿Cómo se calcula la puntuación?

Las comprobaciones de gravedad alta pesan 10 puntos, las medias 5 y las bajas 2. Un aprobado suma el peso completo, una advertencia suma la mitad y un fallo no suma nada. Las comprobaciones que no se aplican, como el texto alt de las imágenes en una página sin imágenes, se excluyen.

¿Cuándo debo usar render=true?

Úsalo en páginas creadas con frameworks de JavaScript, donde los títulos, el contenido o los enlaces solo aparecen después de ejecutar los scripts. Compara ambas versiones con la API de SEO con JavaScript para ver exactamente qué cambia.

¿Rastrea todo el sitio?

No. Cada petición audita una URL, así que controlas qué páginas se comprueban y cuánto gastas. Combínala con la API de auditoría de sitemaps para elegir las URL que auditar.

¿Cuántos créditos cuesta?

Dos créditos por una auditoría de HTML sin procesar y seis créditos con render=true. 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

Auditar una página

Empezar gratis Ver documentación Probar la herramienta gratuita