API de Scrape: Recuperar páginas web con precios de crédito fijos

Categoría Inteligencia de dominios y web

Endpoints 4

Características principales 6

Preguntas frecuentes 8

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

urlmodeoutputurlsjob_idlimitoffset

Campos de respuesta

Respuesta de ejemplo

datadata.urldata.final_urldata.statusdata.outcomedata.content_typedata.contentdata.bytesdata.truncateddata.redirect_countdata.attempt_countdata.duration_ms

Cobertura de estados

Códigos de estado HTTP

200202400401402403409429503

Endpoints

POST /v1/scrape

Créditos: 1-20/itemAutenticación: Autenticación requerida

urlmodeoutput

POST /v1/scrape/jobs

Créditos: 1-20/itemAutenticación: Autenticación requerida

modeoutputurls

GET /v1/scrape/jobs/:job_id

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

job_id

GET /v1/scrape/jobs/:job_id/results

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

job_idlimitoffset

Elige el esfuerzo de recuperación para cada URL

Los créditos se basan en el modo que solicitas, no en el estado HTTP o contenido devuelto por el sitio web de destino.

Estándar

1 crédito por URL

Un intento de recuperación estándar para páginas simples.

Resiliente

2 créditos por URL

Un intento estándar con un reintentos cuando el resultado cumple con las condiciones de reintento documentadas.

Renderizado

10 créditos por URL

Un intento renderizado por navegador para páginas que requieren ejecución de JavaScript.

Renderizado resiliente

20 créditos por URL

Un intento renderizado por navegador con un reintentos cuando el resultado cumple con las condiciones de reintento documentadas.

Los modos resilientes cuestan la cantidad indicada incluso cuando el primer intento tiene éxito. Incluyen un reintentos elegible, no reintentos ilimitados ni una garantía de que el sitio web de destino devolverá el contenido que esperas.

La facturación refleja el trabajo solicitado

Una operación exitosa de API significa que DomScan realizó el modo de recuperación seleccionado y devolvió la respuesta del destino resultante.

El resultado puede ser un redireccionamiento, un error HTTP, una respuesta bloqueada, una página de desafío, una página vacía o contenido que no cumple con tus necesidades. Estos resultados del sitio de destino son cobrables y no son elegibles para un reembolso de crédito.

Un reembolso está disponible solo cuando DomScan verifica que su propia plataforma no realizó el modo de recuperación seleccionado.

El renderizado de navegador no garantiza que una página se cargue exitosamente, y los modos resilientes no garantizan que el reintentos produzca un resultado diferente.

Límites de uso específicos del Scrape

Estos límites se aplican específicamente a la API de Scrape. También pueden aplicarse otras salvaguardas de cuenta y plataforma.

Capacidad	Cuentas gratuitas	Cuentas de pago
Modos disponibles	Solo estándar	Los cuatro modos
Tasa de solicitud	5 solicitudes por minuto	60 solicitudes por minuto
Solicitudes concurrentes estándar o resilientes	1 solicitud estándar	5 solicitudes
Solicitudes renderizadas concurrentes	No disponible	2 solicitudes
Asignación diaria	100 solicitudes	Basado en créditos disponibles y límites de tasa
Asignación mensual	500 solicitudes	Basado en créditos disponibles y límites de tasa
Contenido máximo devuelto	256 KiB por solicitud	512 KiB por solicitud
Lotes asincronos	No disponible	Disponible

Cuando una respuesta excede el límite de contenido aplicable, la API devuelve la porción permitida y marca la respuesta como truncada.

Procesa hasta 100 URLs de forma asincrónica

Las cuentas de pago pueden enviar un trabajo asincrónico que contiene hasta 100 URLs.

Hasta 5 trabajos de lotes nuevos por minuto

Hasta 3 trabajos activos por cuenta

Hasta 300 elementos de URL en cola por cuenta

Hasta 100 URLs en un trabajo

Resultados completados disponibles durante 24 horas

Metadatos del trabajo retenidos durante 7 días

Cada URL se factura de forma independiente usando su modo seleccionado.

Descarga o copia los resultados completados dentro de 24 horas. Después de ese período, el contenido de la respuesta se elimina aunque los metadatos limitados del trabajo permanecen disponibles durante 7 días.

Alcance claro, sin opciones de actualización ocultas

Sin resolución de CAPTCHA

El renderizado de navegador puede ejecutar JavaScript de página, pero la API de Scrape no resuelve CAPTCHAs ni omite requisitos de inicio de sesión, muros de pago, controles de acceso u otras restricciones. Un CAPTCHA o página de desafío devueltos por el destino es un resultado del sitio de destino y no es reembolsable.

Sin selección de proxy premium

Tú eliges el modo de recuperación y nivel de esfuerzo. No hay parámetro de proxy premium, proveedor, grupo o selección de país.

Uso aceptable

Usa la API de Scrape solo para contenido que tengas permiso legal para acceder y procesar. Eres responsable de cumplir con las leyes aplicables, términos del sitio de destino, obligaciones de privacidad y permisos requeridos.

No uses la API para omitir autenticación, muros de pago, CAPTCHAs o controles de acceso, ni para ataques de credenciales, abuso de cuentas, acoso, vigilancia ilegal o recopilación ilegal de datos personales. DomScan puede rechazar solicitudes o suspender el acceso cuando el uso amenaza a personas, servicios o la plataforma.

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

Elige el esfuerzo de recuperación para cada URL

Los créditos se basan en el modo que solicitas, no en el estado HTTP o contenido devuelto por el sitio web de destino.

La facturación refleja el trabajo solicitado

Una operación exitosa de API significa que DomScan realizó el modo de recuperación seleccionado y devolvió la respuesta del destino resultante.

Procesa hasta 100 URLs de forma asincrónica

Las cuentas de pago pueden enviar un trabajo asincrónico que contiene hasta 100 URLs.

Límites de uso específicos del Scrape

Estos límites se aplican específicamente a la API de Scrape. También pueden aplicarse otras salvaguardas de cuenta y plataforma.

Sin resolución de CAPTCHA

Uso aceptable

Solicitud de ejemplo

Solicitud estándar bash

curl -X POST "https://domscan.net/v1/scrape" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/","mode":"standard","output":"markdown"}'

Solicitud renderizada por navegador bash

curl -X POST "https://domscan.net/v1/scrape" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/app","mode":"rendered","output":"html"}'

Solicitud de lote asincrónico bash

curl -X POST "https://domscan.net/v1/scrape/jobs" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Idempotency-Key: docs-batch-1" \
  -H "Content-Type: application/json" \
  -d '{"mode":"standard","output":"text","urls":["https://example.com/page-1","https://example.com/page-2"]}'

Respuesta de ejemplo

Respuesta estándar exitosa json

{
  "data": {
    "url": "https://example.com/",
    "final_url": "https://example.com/",
    "status": 200,
    "outcome": "success",
    "content_type": "text/html",
    "content": "<!doctype html>...",
    "bytes": 1256,
    "truncated": false,
    "redirect_count": 0,
    "attempt_count": 1,
    "duration_ms": 428,
    "fetched_at": "2026-08-20T10:30:00.000Z",
    "headers": { "cache-control": "max-age=604800" },
    "rendered": false
  },
  "billing": {
    "credits_charged": 1,
    "credits_refunded": 0,
    "policy": "effort_based"
  }
}

Preguntas frecuentes

¿Cuántos créditos cuesta una URL?

Una URL cuesta 1, 2, 10 o 20 créditos dependiendo del modo seleccionado. Los elementos del lote utilizan la misma fijación de precios por URL.

¿Se me cobra si el destino devuelve un error o página de bloqueo?

Sí. Las respuestas de destino como redireccionamientos, errores HTTP, bloqueos, páginas de desafío, páginas vacías o contenido inesperado son cobrables porque DomScan aún realizó el trabajo de recuperación solicitado.

¿Cuándo se reembolsa una solicitud?

Un reembolso está disponible solo cuando DomScan verifica que su propia plataforma no realizó el modo de recuperación seleccionado. El comportamiento del sitio de destino no es un fallo de plataforma.

¿El modo resiliente sigue reintentando hasta que la página funciona?

No. El modo resiliente incluye un reintentos cuando el primer resultado cumple con las condiciones de reintento documentadas.

¿El renderizado de navegador resuelve CAPTCHAs?

No. Ejecuta JavaScript de página pero no resuelve CAPTCHAs ni omite restricciones de acceso.

¿Puedo seleccionar un proxy premium o país?

No. La API no expone niveles de proxy, proveedores, grupos o orientación de país. Solo seleccionas el modo de recuperación.

¿Pueden enviar trabajos de lote las cuentas gratuitas?

No. Los lotes asincronos están disponibles solo para cuentas de pago. Las cuentas gratuitas pueden usar modo estándar dentro de los límites gratuitos publicados.

¿Cuánto tiempo se almacenan los resultados del lote?

El contenido de respuesta completado está disponible durante 24 horas. Los metadatos limitados del trabajo permanecen disponibles durante 7 días.

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

Aceptado 202

Fallo de caché de subdominios en modo solo caché aceptado para actualización en segundo plano. No se cobran créditos; reintenta tras el intervalo Retry-After.

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.

Prohibido 403

Autenticado, pero sin permiso para usar esta operación o modo.

HTTP 409 409

Demasiadas solicitudes 429

Límite de frecuencia superado

Servicio no disponible 503

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

Obtén una clave de API

Empezar gratis Ver documentación

Soporte

API de Recupera páginas web con precios predecibles por URL

Señales de confianza antes de integrar

Qué te ayuda a lanzar esta API

Flujo de integración

Kit para desarrolladores

Mapa de parámetros y respuesta

Endpoints

Elige el esfuerzo de recuperación para cada URL

Estándar

Resiliente

Renderizado

Renderizado resiliente

La facturación refleja el trabajo solicitado

Límites de uso específicos del Scrape

Procesa hasta 100 URLs de forma asincrónica

Alcance claro, sin opciones de actualización ocultas

Sin resolución de CAPTCHA

Sin selección de proxy premium

Uso aceptable

Señales de confianza antes de integrar

Características principales

Solicitud de ejemplo

Respuesta de ejemplo

Preguntas frecuentes

Herramientas y Recursos Relacionados

Códigos de estado HTTP