API de Lista de Vigilancia de Dominio

Q: ¿Qué endpoints están incluidos?

Esta guía cubre 5 endpoints públicos: GET /v1/watchlist , POST /v1/watchlist , DELETE /v1/watchlist , GET /v1/watchlist/expiring , GET /v1/watchlist/available .

{ "watchlist": [ { "domain": "startup.com", "added_at": "2026-04-01T10:30:00Z", "status": "registered", "expiry_date": "2027-04-01T00:00:00Z", "days_until_expiry": 352, "last_checked": "2026-04-13T12:00:00Z", "notify_email": "[email protected]", "check_count": 9 } ], "total": 1, "updated_at": " ...

Categoría Monitorización

Endpoints 5

Créditos 0-1

Autenticación Autenticación requerida

Utilizado por personas en empresas increíbles.

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

domainnotify_emaildays

Campos de respuesta

Respuesta de ejemplo

watchlisttotalupdated_at

Cobertura de estados

Códigos de estado HTTP

200201400401402429

Endpoints

GET /v1/watchlist

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

POST /v1/watchlist

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

domainnotify_email

DELETE /v1/watchlist

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

domain

GET /v1/watchlist/expiring

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

days

GET /v1/watchlist/available

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

Endpoints

GET /v1/watchlist • POST /v1/watchlist • DELETE /v1/watchlist • GET /v1/watchlist/expiring • GET /v1/watchlist/available

Parámetro

domain, notify_email, days

Códigos de estado HTTP

200, 201, 400, 401, 402, 429

Créditos / Autenticación

0-1 / Autenticación requerida

Solicitud de ejemplo

GET /v1/watchlist javascript

await fetch('https://domscan.net/v1/watchlist', {
  credentials: 'include',
  headers: {
    Accept: 'application/json',
  },
});

POST /v1/watchlist javascript

await fetch('https://domscan.net/v1/watchlist', {
  method: 'POST',
  credentials: 'include',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    domain: 'startup.com',
    notify_email: '[email protected]',
  }),
});

GET /v1/watchlist/expiring javascript

await fetch('https://domscan.net/v1/watchlist/expiring?days=30', {
  credentials: 'include',
  headers: {
    Accept: 'application/json',
  },
});

Respuesta de ejemplo

200 OK json

{
  "watchlist": [
    {
      "domain": "startup.com",
      "added_at": "2026-04-01T10:30:00Z",
      "status": "registered",
      "expiry_date": "2027-04-01T00:00:00Z",
      "days_until_expiry": 352,
      "last_checked": "2026-04-13T12:00:00Z",
      "notify_email": "[email protected]",
      "check_count": 9
    }
  ],
  "total": 1,
  "updated_at": "2026-04-13T12:00:00Z"
}

Preguntas frecuentes

¿Qué endpoints están incluidos?

Esta guía cubre 5 endpoints públicos: GET /v1/watchlist, POST /v1/watchlist, DELETE /v1/watchlist, GET /v1/watchlist/expiring, GET /v1/watchlist/available.

¿Esta API requiere autenticación?

Sí. Envía tu clave de API con la cabecera `X-API-Key` o `Authorization: Bearer` al llamar a Lista de Vigilancia de Dominio.

¿Cuántos créditos utiliza?

Las solicitudes de estas guías usan 0-1 créditos según el endpoint. En los endpoints masivos, los créditos usan la tarifa estándar por elemento.

¿Dónde puedo ver los parámetros completos y los endpoints relacionados?

Usa la documentación completa de Lista de Vigilancia de Dominio para revisar los detalles de los parámetros, las notas de autenticación y los endpoints relacionados de la misma familia de API.

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

Creado 201

Recurso creado correctamente.

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

Empieza gratis con 10.000 créditos al mes. Usa cualquier API pública y añade créditos solo cuando los necesites.

Empezar gratis Ver documentación Probar la herramienta gratuita