API de ubicación en bandeja de entrada.

Enumera los buzones que quieres probar, crea una prueba de ubicación, envía tu correo a cada dirección devuelta y luego lee la ubicación en carpeta por buzón (bandeja de entrada / promociones / spam) con análisis forense del remitente y exposición a listas negras en formato JSON.

GET + POST /ext/v2/inbox-placement
curl https://api.unspam.email/ext/v2/inbox-placement/mailboxes \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# response (200)
[
  { "id": 3,  "name": "Gmail",    "address": "..." },
  { "id": 7,  "name": "Outlook",  "address": "..." },
  ...
]

# pick the IDs you want to test,
# pass them in the next request.
curl -X POST https://api.unspam.email/ext/v2/inbox-placement \
  -H "Authorization: Bearer $UNSPAM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "mailboxes": [3] }'

# response (201)
{
  "id": "abc123",
  "mailboxes": [
    { "id": 3, "name": "Gmail", "address": "..." }
  ]
}

# send your email to each address,
# with the test id somewhere in the body.
curl https://api.unspam.email/ext/v2/inbox-placement/abc123 \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# response (200)
{
  "id": "abc123",
  "status": "completed",
  "results": [
    {
      "mailbox": { "name": "Gmail", ... },
      "status":     "delivered",
      "tab":        "inbox",
      "sender_ip":  "192.0.2.1",
      "blacklists": 0
    }
  ],
  "report_url": "https://unspam.email/inbox-test/abc123"
}

Cuatro tipos de petición. Una sola clave de API.

Una sola clave cubre los cuatro endpoints. POST /inbox-placement envía tu mensaje a la lista de semillas y devuelve los resultados por carpeta y buzón; la misma clave también puntúa el contenido, obtiene previsualizaciones en clientes y genera mapas de calor.

Pruebas antispam

POST /spam-checkPuntuación, análisis forense del remitente y desglose por comprobación. Creado para plataformas de envío y equipos de CRM.

Ubicación en bandeja de entrada

POST /inbox-placementEnvía a nuestra lista de semillas y obtén la carpeta de cada buzón (bandeja de entrada / promociones / spam) más la exposición en listas negras.

Vistas previas en clientes

GET /spam-check/{id}/client-previewsTu correo renderizado en más de 50 clientes y dispositivos reales, en modo claro y oscuro. Consulta la API de vista previa de correo.

Mapas de calor de correo

GET /spam-check/{id}/heatmapMapas de calor de foco y atención generados con IA en los tres tamaños de dispositivo.

Por qué los equipos eligen Unspam para monitorizar la ubicación.

Prueba todos los buzones o elige un subconjunto.

Pasa {"mailboxes": [3, 7, 23]} para limitar una prueba a proveedores concretos. Deja el cuerpo vacío para sembrar en todos los buzones habilitados. Los IDs de buzón se obtienen con GET /inbox-placement/mailboxes.

Bandeja de entrada / Promociones / Spam por proveedor.

El array results[] incluye una entrada por buzón con el status de entrega, la pestaña de destino tab, el sender y el sender_ip que vio el receptor, y un recuento de apariciones en listas negras públicas.

Programa, consulta, alerta.

Integra pruebas de ubicación programadas en tu stack de monitorización. Conecta la respuesta JSON a Datadog, PagerDuty, Slack o lo que ya avise a tu equipo.

Analiza la evolución de la ubicación en el tiempo.

Las pruebas anteriores quedan guardadas. GET /inbox-placement?page=N&per_page=15 devuelve la lista paginada con id, status, marcas de tiempo y el report_url alojado. Sigue la deriva por buzón semana a semana sin tener que montar tu propio almacenamiento.

Qué devuelve cada prueba de ubicación en bandeja de entrada.

Un veredicto de carpeta por buzón, análisis forense del remitente y exposición a listas negras: los datos que tu stack de monitorización necesita para actuar.

01

Un veredicto de carpeta por buzón, no una puntuación.

Cada campo results[].tab indica dónde aterrizó el correo en ese proveedor concreto: "inbox", "promotions", "spam" o "missing". Las puntuaciones agregadas ocultan dónde se está dañando realmente la reputación. Esto responde a la pregunta directamente.

El campo status indica la entrega: "delivered", "pending" o "missing" si el buzón de la lista de semillas nunca llegó a recibir el mensaje.

  • Gmail bandeja de entrada
  • Outlook promociones
  • Yahoo Mail spam
  • Zoho bandeja de entrada
  • AOL bandeja de entrada
02

Análisis forense del remitente y del SMTP en la misma respuesta.

Cada entrada de resultado incluye sender, sender_ip y blacklists (el número de listas negras públicas que el motor detectó en la IP de envío en el momento de la entrega). Ves lo que vio el receptor, no solo lo que muestran tus propios registros.

Envíalos directamente a tu panel de reputación o úsalos para limitar una IP problemática antes de que afecte a la siguiente campaña.

ENTREGADO
status
delivered
tab
inbox
sender
send@yourdomain.com
sender_ip
192.0.2.1
blacklists
0
03

Filtra por los proveedores que usan tus clientes.

GET /ext/v2/inbox-placement/mailboxes devuelve todos los buzones habilitados con su id, name y la address activa. Elige los IDs que coincidan con tu audiencia y pásalos al endpoint de creación.

No necesitas sembrar todos los proveedores si tu SaaS B2B envía sobre todo a Outlook corporativo. Ajusta bien el alcance y ahorra cuota.

  • Gmail id: 1
  • Gmail Workspace id: 3
  • Outlook id: 7
  • Yahoo Mail id: 12
  • Zoho id: 18
  • AOL id: 23

Cómo funciona la API en cuatro pasos.

La ubicación en bandeja de entrada es asíncrona: lista los buzones, crea una prueba, envía tu correo a cada dirección devuelta y luego lee los veredictos por proveedor.

  1. 01

    Listar los buzones disponibles

    GET /ext/v2/inbox-placement/mailboxes devuelve el conjunto completo de buzones habilitados con IDs estables. Útil una vez en la configuración y luego de forma periódica a medida que se activan nuevos proveedores.

  2. 02

    Crea una prueba de ubicación

    POST /ext/v2/inbox-placement con un filtro opcional mailboxes. La respuesta 201 devuelve el id de la prueba y la lista de addresses de buzones a los que debes entregar.

  3. 03

    Envía tu correo a cada dirección

    Entrega desde tu plataforma a cada dirección devuelta. Incluye el id de la prueba en algún lugar del cuerpo del correo para que nuestro motor pueda asociar el mensaje a la prueba.

  4. 04

    Consulta los veredictos por buzón

    GET /ext/v2/inbox-placement/{id} devuelve el array results[] con el tab, el status, la sender_ip y el recuento de blacklists de cada buzón en cuanto status === "completed".

Preguntas frecuentes sobre la API.

Mecánica de los buzones, sondeo, límites de peticiones y qué significa el veredicto de cada proveedor.

¿Cómo consigo acceso a la API?
El acceso a la API se incluye en nuestro plan White Label, que es totalmente personalizado: los límites de pruebas de ubicación en bandeja de entrada, comprobaciones de spam, capturas de pantalla y mapas de calor se ajustan a tu cuenta. Habla con ventas indicando el volumen que esperas y definiremos una solución a tu medida.
¿Cuáles son los límites de peticiones?
El límite público es de 100 peticiones por minuto por IP o por cuenta autenticada. Eso cubre la mayoría del tráfico en producción. Si necesitas mayor capacidad de ráfaga o un canal dedicado, abre el chat e indícanos el rendimiento que esperas.
¿Cómo funciona el flujo de crear y luego enviar?
Tres llamadas. POST /ext/v2/inbox-placement devuelve un id de prueba y una lista de direcciones de buzón. Tu plataforma entrega el correo real a cada una (con el id de la prueba en el cuerpo para que podamos emparejarlo). Después, GET /ext/v2/inbox-placement/{id} devuelve los veredictos por buzón en cuanto status === "completed".
¿Qué buzones están disponibles?
Probamos con los proveedores de correo personales y de empresa más populares. Para consultar la lista siempre actualizada (incluidos los IDs que puedes pasar para acotar una prueba), llama a GET /ext/v2/inbox-placement/mailboxes.
¿La ubicación es determinista?
No. Los filtros de los proveedores se basan en muestras y dependen de la reputación del remitente, la interacción de los destinatarios y los pesos actuales de los filtros. Trata el resultado como una señal orientativa sólida, no como una garantía de que los envíos futuros aterrizarán en la misma carpeta.
¿Qué me indica el recuento de listas negras?
El campo blacklists de cada resultado es el número de listas negras públicas en las que nuestro motor detectó la IP de envío en el momento de la entrega. Lo esperable es cero; cualquier valor superior es un problema de reputación que debes investigar a través de tu remitente o ESP.
¿Puedo listar pruebas anteriores?
Sí. GET /ext/v2/inbox-placement?page=1&per_page=15 devuelve una lista paginada de las pruebas creadas mediante la API, con id, estado, marcas de tiempo y la report_url de cada una.
¿Cómo lanzo pruebas de ubicación desde un pipeline de CI?
Haz un POST desde tu paso de build (curl, Node, Python o cualquier cliente HTTP). Lee la respuesta, envía tu correo y luego consulta GET /inbox-placement/{id} con reintentos de back-off exponencial hasta que status sea "completed".

Lleva las pruebas de ubicación a tu stack.

El acceso a la API está incluido en el plan White Label. Los precios están en la página pública, los límites personalizados se hablan por chat.

Ver precios