// get /v1/email-format
API de Formato de Email
Detecta los patrones de formato de email utilizados por cualquier dominio de empresa. Devuelve todos los patrones detectados con su distribución porcentual para que puedas predecir direcciones de empleados.
// consola de la api
- [0].format
- {first}
- [0].percentage
- 66
// 01 · solicitud
Email Format es una solicitud HTTPS
Envía los parámetros con tu clave y tu secreto. Cada SDK, la CLI y el servidor MCP hacen esta misma llamada.
/email-formatdomainobligatorio- Company domain
curl -G https://api.tomba.io/v1/email-format \
--data-urlencode "domain=piedpiper.com" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY"const params = new URLSearchParams({
domain: "piedpiper.com"
});
const res = await fetch(`https://api.tomba.io/v1/email-format?${params}`, {
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY
}
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.tomba.io/v1/email-format",
params={
"domain": "piedpiper.com",
},
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
)
data = res.json()["data"]// 02 · respuesta
Lo que recibes
JSON, igual en todos los lenguajes. Los campos que Tomba no conoce son null, nunca se adivinan.
/email-formatdata[].formatstring- Pattern such as {first}.{last}
data[].percentageinteger- Share of the company's addresses
{
"data": [
{
"format": "{first}",
"percentage": 66
},
{
"format": "{first}.{last}",
"percentage": 34
}
]
}// 03 · coste y límites
Lo que cuesta una llamada
Una llamada solo se cobra en la condición indicada abajo. Los límites de solicitudes dependen de tu plan.
// coste
1email count credit
Se cobra cuando: Every successful call, including an empty result.
Los errores, las respuestas 429 y 451, y la misma solicitud repetida dentro de tu ventana de uso no cuestan nada.
Cómo funcionan los créditos// límites de solicitudes
Solicitudes por segundo / minuto / día| Free | Basic | Growth | Pro | |
|---|---|---|---|---|
| Search, finder, similar, technology | 1 / 2 / 5 | 3 / 50 / 500 | 5 / 80 / 1,000 | 8 / 150 / 4,000 |
| Email verifier | 1 / 2 / 10 | 2 / 40 / 500 | 3 / 60 / 1,000 | 5 / 100 / 4,000 |
Desplázate en horizontal para ver todas las columnas
Pro Plus, Scale and credit packs of 50,000 or more: no limit on these endpoints. Enterprise: no per-second or per-minute limit, 100,000 requests a day. Daily limits reset at 00:00 UTC. Límites de solicitudes
// preguntas frecuentes
Preguntas sobre la Email Format API
¿Tiene más preguntas? Visite el centro de ayuda