API de Metadatos de URL para Vistas Previas e Inteligencia Web

API de Inteligencia de URL Unificada

Envía una URL pública y recibe en una sola respuesta metadatos normalizados de la página, activos de vista previa, pruebas de redirección, tipos de datos estructurados, cabeceras de seguridad y señales públicas de identidad.

{ "requested_url": "https://example.com/", "final_url": "https://example.com/", "status": 200, "title": "Example Domain", "canonical_url": "https://example.com/", "open_graph": {}, "structured_data": { "types": [], "items": 0, "parse_errors": 0 }, "meta": { "cached": false, "fetch_transport": "worker" } }

Categoría Inteligencia web

Endpoints 2

Características principales 6

Preguntas frecuentes 5

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

url

Campos de respuesta

Respuesta de ejemplo

requested_urlfinal_urlstatustitlecanonical_urlopen_graphstructured_datastructured_data.typesstructured_data.itemsstructured_data.parse_errorsmetameta.cached

Cobertura de estados

Códigos de estado HTTP

200400401402429500502503504

Endpoints

GET /v1/url-intelligence

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

POST /v1/url-intelligence/bulk

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

Metadatos de Página Normalizados

Extrae el título, la descripción, el idioma, el tipo de contenido, la URL final y la URL canónica.

Campos para Vistas Previas de Enlaces

Crea tarjetas de vista previa con imágenes normalizadas, favicons, etiquetas Open Graph y Twitter Cards.

Resumen de Datos Estructurados

Identifica tipos de JSON-LD e informa de bloques mal formados sin devolver datos de página sin límites.

Señales de Robots y Seguridad

Lee directivas de indexación y un conjunto permitido de cabeceras de seguridad públicas.

Contactos y Perfiles Públicos

Extrae enlaces declarados de correo electrónico, teléfono, redes sociales, desarrolladores y creadores.

Metadatos Masivos de URL

Inspecciona hasta 10 URL por solicitud, con concurrencia limitada y errores por elemento.

Solicitud de ejemplo

GET /v1/url-intelligence?url=https://example.com bash

curl -G -H "X-API-Key: $DOMSCAN_API_KEY" --data-urlencode "url=https://example.com" https://domscan.net/v1/url-intelligence

POST /v1/url-intelligence/bulk bash

curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"urls":["https://example.com","https://github.com/about"]}' https://domscan.net/v1/url-intelligence/bulk

Respuesta de ejemplo

200 OK json

{
  "requested_url": "https://example.com/",
  "final_url": "https://example.com/",
  "status": 200,
  "title": "Example Domain",
  "canonical_url": "https://example.com/",
  "open_graph": {},
  "structured_data": { "types": [], "items": 0, "parse_errors": 0 },
  "meta": { "cached": false, "fetch_transport": "worker" }
}

Preguntas frecuentes

¿Cuál es la diferencia entre una API de metadatos de URL y una API de Open Graph?

Una API de Open Graph se centra en etiquetas sociales. DomScan también devuelve señales de URL canónica, redirecciones, robots, datos estructurados, seguridad, contacto e identidad.

¿Qué ocurre cuando faltan las etiquetas Open Graph?

Los campos de Open Graph quedan vacíos, mientras que se siguen devolviendo el título estándar, la descripción, los iconos, los datos estructurados y otras señales disponibles.

¿La API ejecuta JavaScript?

No. La versión inicial inspecciona respuestas HTML públicas de tamaño limitado y no atribuye metadatos que solo aparecen después de ejecutar JavaScript en el cliente.

¿La API sigue las redirecciones de forma segura?

Sí. El número de redirecciones está limitado y se comprueba cada destino para impedir el acceso a objetivos de redes privadas o internas.

¿Puedo inspeccionar varias URL a la vez?

Sí. El endpoint masivo acepta hasta 10 URL públicas y conserva su orden de entrada.

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

Error del servidor 500

Error interno

Puerta de enlace incorrecta 502

Error del servicio RDAP de origen

Servicio no disponible 503

El servicio ascendente no está disponible o está limitando temporalmente.

Tiempo de espera de la puerta de enlace agotado 504

La consulta al servicio de origen agotó el tiempo de espera.

Crea con Inteligencia de URL

Ver documentación completa de la API APIs