API de Inbox Placement.

Crea una prueba vía REST, envía tu correo a cada buzón devuelto con el id de la prueba dentro y consulta en JSON la carpeta y la pestaña en que acabó en cada uno.

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

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

# elige los ids que quieras y pásalos en la siguiente petición
curl -X POST https://api.unspam.email/ext/v2/inbox-placement \
  -H "Authorization: Bearer $UNSPAM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "mailboxes": [3, 7] }'

# devuelve el id del test y los buzones semilla a los que enviar
{
  "id": "7Hq2xLpV0aKd",
  "mailboxes": [
    { "id": 3, "name": "Gmail", "address": "..." },
    { "id": 7, "name": "Outlook", "address": "..." }
  ]
}

# envía a cada dirección con el id de la prueba en el asunto o el cuerpo y luego lee el resultado
curl https://api.unspam.email/ext/v2/inbox-placement/7Hq2xLpV0aKd \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# respuesta (200)
{
  "status": "success",
  "results": [
    {
      "mailbox": { "id": 3, "name": "Gmail", ... },
      "status": "success",
      "tab": "Promotions",
      "sender": "news@yourdomain.com",
      "sender_ip": "192.0.2.1",
      "blacklists": 0
    }
  ],
  "report_url": "https://unspam.email/inbox-test/7Hq2xLpV0aKd"
}
Endpoints
20
Resultados
Por buzón
Autenticación
Token bearer
Límite de peticiones
100 por minuto

Por qué los equipos eligen Unspam para monitorizar el Inbox Placement.

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, pestaña o spam, buzón a buzón.

El array results[] trae una entrada por buzón con el status de entrega, el tab donde cayó el correo, el sender y la sender_ip que vio el receptor y un recuento de listas negras públicas en blacklists.

Programa, consulta, alerta.

Los endpoints /scheduled-tests ejecutan pruebas de Inbox Placement con la programación que definas, con ajustes de alerta y resultados por ejecución. Conecta el JSON a Datadog, PagerDuty, Slack o lo que ya avise a tu equipo. Consulta las pruebas automáticas.

Analiza la evolución del Inbox Placement en el tiempo.

GET /inbox-placement?page=N&per_page=15 devuelve las pruebas que creaste con la API, con id, estado, marcas de tiempo y el report_url alojado. Vuelve a leer cualquiera por id para seguir la deriva por buzón semana a semana sin montar almacenamiento propio.

Qué devuelve cada prueba de Inbox Placement.

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.

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

Cada results[].tab indica dónde cayó el correo en ese buzón: Inbox, Spam o una pestaña de Gmail como Promotions, Social, Updates o Forums. Se queda en null hasta que llega el mensaje. Las puntuaciones agregadas ocultan dónde se está dañando de verdad la reputación; esto responde a la pregunta directamente.

El campo status indica la entrega: success cuando el buzón tiene el mensaje, pending mientras lo esperamos y failed si nunca llegó.

  • Gmail Promotions
  • Outlook Inbox
  • Yahoo Mail Spam
  • Zoho Inbox
  • AOL null

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.

  • status success
  • tab Inbox
  • sender send@yourdomain.com
  • sender_ip 192.0.2.1
  • blacklists 0

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: 3
  • Outlook id: 7
  • AOL id: 23

Cómo funciona la API en cuatro pasos.

La llegada a la 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 Inbox Placement

    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 el asunto o el cuerpo 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 results[] con el status, el tab, la sender_ip y el recuento de blacklists de cada buzón. Sondea hasta que el status de la propia prueba deje de ser pending: termina en success o failed.

Los endpoints que hay detrás.

20 endpoints, con el mismo token que el resto de la API. El documento OpenAPI recoge cada parámetro y código de respuesta.

Documento OpenAPI
Inbox Placement 4 llamadas
  • GET /inbox-placement
  • POST /inbox-placement
  • GET /inbox-placement/mailboxes
  • GET /inbox-placement/{id}
Automatic Testing: Senders 6 llamadas
  • GET /scheduled-test-senders
  • POST /scheduled-test-senders
  • GET /scheduled-test-senders/{id}
  • PUT /scheduled-test-senders/{id}
  • DELETE /scheduled-test-senders/{id}
  • POST /scheduled-test-senders/{id}/test-connection
Automatic Testing: Tests 10 llamadas
  • GET /scheduled-tests
  • POST /scheduled-tests
  • GET /scheduled-tests/{id}
  • PUT /scheduled-tests/{id}
  • PATCH /scheduled-tests/{id}
  • DELETE /scheduled-tests/{id}
  • POST /scheduled-tests/{id}/dispatch-now
  • PUT /scheduled-tests/{id}/email
  • GET /scheduled-tests/{id}/runs
  • GET /scheduled-tests/{id}/runs/{runId}

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 está incluido en el plan personalizado, que contratas en línea: elige el volumen mensual de cada prueba en la página de precios, desde un mínimo de $5, y las tarifas bajan a medida que creces. Puedes integrarlo en tu propio producto y revenderlo con tu propia marca. Para cualquier otra cosa, abre un ticket de soporte.
¿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 un límite más alto, abre un ticket de soporte 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 asunto o el cuerpo para que podamos asociarlo. Después, GET /ext/v2/inbox-placement/{id} devuelve los veredictos por buzón, y el status de la prueba termina en success o failed.
¿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.
¿El Inbox Placement 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 Inbox Placement desde un pipeline de CI?
Haz POST desde tu paso de build (curl, Node, Python o cualquier cliente HTTP). Lee la respuesta, envía tu correo y sondea GET /inbox-placement/{id} con back-off exponencial hasta que status sea success o failed.
¿Puedo integrarlo en mi propio producto y revenderlo?
Sí, con el plan personalizado. Cada prueba de Inbox Placement llega en JSON con la carpeta en la que cada buzón dejó tu correo, así que puedes mostrarla en tu propia interfaz y revenderla a tus clientes con tu propia marca.
¿Puedo ver el mismo correo en clientes reales?
Sí. POST /ext/v2/client-previews con email_source en inbox-placement y el id de la prueba como source_id renderiza el mensaje que enviaste en clientes y dispositivos reales. El resultado de la prueba lleva entonces su client_preview_id. Consulta la API de vistas previas de correo.

Lleva las pruebas de Inbox Placement a tu stack.

El acceso a la API está incluido en el plan personalizado, que se contrata en línea desde un mínimo de $5 al mes. Intégralo en tu propio producto y revéndelo con tu propia marca.