Saltar al contenido

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

  1. 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.

  2. Estima el precio

    Envía tu lista a POST /estimates para ver el precio y cualquier problema que tenga. No se cobra nada.

  3. Realiza el pedido

    Envía la misma lista a POST /orders con una Idempotency-Key. El pedido se cobra una sola vez, sin importar cuántas veces lo envíes.

  4. Obtén el resultado

    Consulta GET /orders/{id} hasta que termine y luego descarga el archivo desde GET /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 /estimates y POST /orders: leer una lista grande lleva tiempo. Con un tiempo de espera más corto, acabarás reenviándola para nada.

En esta página