Pre-lanzamiento · API en desarrollo

Una API de verificación de email que te dice por qué

Una llamada HTTPS devuelve un veredicto, un código de motivo y una explicación que puedes mostrar a tu usuario, en español o en inglés. La API aún no está abierta: aquí contamos qué está previsto, cuánto costará y qué puedes probar hoy.

Funciona hoy

  • Comprobador web gratuito
  • Formato, dominio y servidores de correo
  • Proveedores temporales

Al lanzar

  • API REST con claves
  • Comprobación de buzón (sin enviar correo)
  • Detección de catch-all
  • Lotes en JSON o CSV

Qué devuelve una llamada

Envías una dirección con tu clave secreta y recibes JSON. El ejemplo sigue la versión 1 del contrato de la API; la API aún no está abierta.

API v1 · en desarrollo, respuesta abreviada
# petición
POST /v1/verify
Authorization: Bearer sk_live_…
{ "email": "ana@example.com", "mode": "mailbox" }

# respuesta
{
  "email": "ana@example.com",
  "mode": "mailbox",
  "verdict": "valid",
  "reason_code": "mailbox_exists",
  "reason": "The mail server accepts this recipient and rejects a random one.",
  "flags": { "disposable": false, "free": false, "catch_all": false },
  "credits_charged": 1,
  "retry_at": null
}
  • mode: basic (por defecto) o mailbox. Mira los dos tipos de comprobación más abajo.
  • verdict: uno de valid, invalid, risky o unknown.
  • reason_code: un código estable sobre el que tu programa puede decidir, como mailbox_exists, mailbox_not_found, catch_all, disposable_domain o domain_not_found. Pueden añadirse códigos nuevos, así que trata uno que no conozcas según su veredicto.
  • reason: el mismo motivo con palabras sencillas, en inglés o en español si envías Accept-Language: es. Puedes mostrarlo a quien rellena tu formulario.
  • flags: si el dominio es temporal, de webmail gratuito o un servidor catch-all. catch_all vale null cuando no se ha comprobado.
  • credits_charged: 0 o 1, para que sepas cuánto ha costado cada resultado.
  • retry_at: cuándo se puede volver a comprobar un resultado temporal, o null.

La respuesta completa incluye además un identificador, los pasos ejecutados, los servidores de correo del dominio y lo que respondió el servidor. La probabilidad de rebote está en preparación y no forma parte de la versión 1 del contrato; no damos fecha. Si se añade será un campo nuevo, así que las integraciones existentes seguirán funcionando.

Dos tipos de comprobación

No todos los usos necesitan la misma profundidad. Un formulario de registro necesita la respuesta mientras la persona sigue en la página; una lista a punto de recibir una campaña necesita saber si cada buzón existe.

ComprobaciónQué revisaPrecio previsto
Comprobación de registro
mode: basic
Formato, dominio y servidores de correo, proveedores temporales y antiguos. Sin contacto con el servidor del buzón, así que suele responder en mucho menos de un segundo y nunca devuelve valid: un dominio sano da unknown con mailbox_not_checked.Gratis: 1.000 al mes. Básico: 9 € al mes por 20.000. Básico+: 29 € al mes por 150.000.
Verificación de buzón
mode: mailbox
Todo lo anterior, más una conversación con el servidor de correo del destinatario que termina antes de enviar ningún mensaje, y un control de catch-all. Puede tardar hasta 30 segundos.Gratis: 100 al mes, máximo 20 al día, sin acumular. Packs: 2.500 por 9 €, 10.000 por 29 €, 50.000 por 99 €, 100.000 por 179 €.

Precios previstos en euros, IVA no incluido; pueden cambiar antes del lanzamiento. Un crédito de buzón solo se cobra cuando el veredicto no es «unknown», los duplicados de una lista son gratis y los créditos de los packs no caducan mientras tu cuenta esté activa (mira las condiciones). Una comprobación de registro gasta una comprobación mensual cada vez que termina, salvo cuando el DNS del dominio falla temporalmente. Ver precios.

Para listas hay lotes: hasta 10.000 direcciones en JSON o un fichero CSV de hasta 100.000 filas, verificados en segundo plano, con resultados en JSON o CSV. Tu plan puede fijar un límite menor. Más en limpiar una lista de correos.

Cómo usarla en un formulario de registro

Validar el email en el registro falla de dos maneras: dejando pasar basura o cerrando la puerta a personas reales. Estas reglas controlan las dos cosas con cualquier API de verificación, incluida la nuestra.

  1. Llama a la API desde tu servidor, nunca desde el navegador. Una clave de API en el código del front-end la puede copiar cualquiera que abra las herramientas de desarrollo.
  2. Rechaza solo lo que es seguro que está mal. Un veredicto invalid significa un formato roto o un dominio que no existe o no acepta correo. Muestra el motivo, para que quien se ha equivocado al teclear pueda corregirlo.
  3. Decide tu propia política para risky. Una dirección temporal puede valer para un boletín y no para una prueba gratuita. Mira el detector de email temporal.
  4. No bloquees nunca por un unknown ni por un tiempo de espera agotado. En una comprobación de registro, unknown con mailbox_not_checked es la respuesta normal para una dirección buena. Y si la API va lenta o no responde, deja pasar el registro y comprueba después. Perder un cliente real cuesta más que una dirección mala.
  5. Mantén el correo de confirmación donde necesites probar la titularidad. La verificación te dice que una dirección puede recibir correo, no quién la está tecleando.

Lo que la API no hará

  • Enviar correo a las direcciones que compruebas. Ni un mensaje de prueba ni un «ping».
  • Crear perfiles de personas ni enriquecer tus contactos con datos de otras fuentes.
  • Ocultar quién pregunta. Las comprobaciones de buzón salen de un servidor identificado, con una página pública (en inglés) que explica qué hace en un servidor de correo y cómo contactarnos.
  • Prometer certeza donde no la hay. Algunos servidores aceptan cualquier dirección y otros se niegan a responder; en esos casos recibes risky o unknown con el motivo, y en la verificación de buzón los unknown son gratis.

Úsalo desde tu agente de IA

Un agente de IA podrá usar SalchiMail de dos formas, las dos con la misma clave y los mismos créditos que la API. Ninguna está abierta todavía: llegan con la API.

  • Un servidor MCP remoto (Streamable HTTP) para Claude Code, Cursor, VS Code y cualquier otro cliente que admita un servidor remoto con cabecera. Se autentica con tu clave de API como token Bearer.
  • Una skill en el formato abierto Agent Skills. Funciona solo con curl, así que no necesita servidor MCP.
Servidor MCP · en preparación

Claude Code

claude mcp add --transport http salchimail https://mcp.salchimail.com/mcp \
  --header "Authorization: Bearer $SALCHIMAIL_API_KEY"

Cursor, VS Code y otros clientes

{
  "mcpServers": {
    "salchimail": {
      "type": "http",
      "url": "https://mcp.salchimail.com/mcp",
      "headers": { "Authorization": "Bearer ${SALCHIMAIL_API_KEY}" }
    }
  }
}

Los nombres de las claves cambian según el cliente (mcpServers o servers; http, streamable-http o streamableHttp), así que consulta la documentación del tuyo.

El servidor tiene ocho herramientas. Seis necesitan tu clave: verify_email comprueba una dirección; create_batch, get_batch, get_batch_results y cancel_batch gestionan listas de hasta 10.000 direcciones; y get_usage muestra créditos y límites. get_plans y get_purchase_link funcionan sin clave. Una comprobación cuesta lo mismo que por la API, y las demás herramientas son gratis.

Si le preguntas «¿existe el buzón ana@example.com?», el agente llama a verify_email con mode: "mailbox", recibe el veredicto valid con el código de motivo mailbox_exists y te responde con palabras claras. El pago se hace siempre en tu navegador: el agente te da un enlace y nunca maneja datos de tarjeta.

Documentación: próximamente

La referencia de la API (docs.salchimail.com) y el servidor MCP (mcp.salchimail.com) están previstos y aún no están publicados. Hasta entonces, esta página es la descripción pública de la API. El motor de verificación se publicará como código abierto con licencia AGPL-3.0 al lanzar, para que cualquiera pueda auditar qué ocurre con cada dirección.

Preguntas frecuentes

Preguntas sobre la API

¿Puedo usar la API hoy?

Todavía no. La API está en desarrollo y abre con el lanzamiento; quien esté en la lista de espera entra antes de la apertura pública. Hoy puedes usar el comprobador web gratuito de la página de inicio, que revisa formato, dominio y proveedores temporales.

¿Habrá plan gratuito?

Sí. El plan gratuito previsto incluye 1.000 comprobaciones de registro y 100 verificaciones de buzón al mes (máximo 20 al día), sin acumular. Hay límites antiabuso: una cuenta gratuita por persona.

¿Cobráis los resultados «unknown»?

En la verificación de buzón, no: si el servidor de correo no da una respuesta útil, el resultado dice por qué y no cuesta nada. La comprobación de registro es distinta. Nunca contacta con el servidor del buzón, así que «unknown, buzón sin comprobar» es su respuesta normal para un dominio sano, y gasta una de tus comprobaciones mensuales.

¿Dónde se tratarán los datos?

Al lanzar actuaremos como encargado del tratamiento, con datos alojados en la UE y contrato de encargado (DPA) para cada cliente.

Consigue tu clave de API entre los primeros

Las plazas fundadoras están abiertas. Reservar una lleva 20 segundos y no cuesta nada.

Reservar plaza fundadora