Desarrolladores
Ejecuta todos los verificadores desde tu propio servidor
La API de TalismanLeads hace lo mismo que el sitio web: envías una lista, ves el precio, realizas el pedido y obtienes el resultado. Pagas con el mismo saldo y a los mismos precios.
Cómo funciona
Crea una clave de API
Crea una clave de API en tu cuenta. Solo se muestra una vez, así que guárdala en un lugar seguro.
Estima el precio
Envía tu lista a
POST /estimatespara ver el precio y cualquier problema que tenga. No se cobra nada.Realiza el pedido
Envía la misma lista a
POST /orderscon unaIdempotency-Key. El pedido se cobra una sola vez, sin importar cuántas veces lo envíes.Obtén el resultado
Consulta
GET /orders/{id}hasta que termine y luego descarga el archivo desdeGET /orders/{id}/results.
Inicio rápido
Sustituye la clave de API por la tuya. La dirección base es https://api.talismanleads.io/v1, y las solicitudes y las respuestas son JSON.
1. Ver cuánto costaría
curl -X POST "https://api.talismanleads.io/v1/estimates" \
-H "Authorization: Bearer tl_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'2. Realizar el pedido
curl -X POST "https://api.talismanleads.io/v1/orders" \
-H "Authorization: Bearer tl_live_your_key_here" \
-H "Idempotency-Key: crm-export-2026-11-05" \
-H "Content-Type: application/json" \
-d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'3. Consultar su estado
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
-H "Authorization: Bearer tl_live_your_key_here"4. Obtener el resultado
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
-H "Authorization: Bearer tl_live_your_key_here"Conviene saber
- Los importes son siempre una cadena en dólares estadounidenses, como
"18.00". - Cada archivo se factura como al menos 2.000 entradas, tanto en la API como en el sitio web.
- En la solicitud cabe una lista de hasta 100.000 entradas y 4 MB. Una mayor, de hasta 10.000.000 de entradas o 200 MB, se envía con
POST /uploads. - Consulta el estado de un pedido dejando 30 segundos o más entre consultas. Lo que tarda un pedido depende de su tamaño y del verificador.
- Espera hasta 5 minutos la respuesta de
POST /estimatesyPOST /orders: leer una lista grande lleva tiempo. Con un tiempo de espera más corto, acabarás reenviándola para nada.