Розробникам
Запускайте будь-яку перевірку зі свого сервера
API TalismanLeads робить те саме, що й сайт: ви надсилаєте список, бачите ціну, розміщуєте замовлення й отримуєте результат. Оплата йде з того самого балансу й за тими самими цінами.
Як це працює
Створіть API-ключ
Створіть API-ключ у своєму акаунті. Він показується один раз, тому зберігайте його в надійному місці.
Дізнайтеся ціну
Надішліть список у
POST /estimates, щоб побачити ціну та можливі проблеми зі списком. Нічого не списується.Розмістіть замовлення
Надішліть той самий список у
POST /ordersіз заголовкомIdempotency-Key. Списання за замовлення відбувається один раз, скільки б разів ви його не надіслали.Отримайте результат
Перевіряйте
GET /orders/{id}, доки замовлення не завершиться, потім отримайте файл черезGET /orders/{id}/results.
Швидкий старт
Замініть API-ключ на свій. Базова адреса: https://api.talismanleads.io/v1, запити й відповіді у форматі JSON.
1. Дізнайтеся, скільки це коштуватиме
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. Розмістіть замовлення
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. Перевірте стан
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
-H "Authorization: Bearer tl_live_your_key_here"4. Отримайте результат
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
-H "Authorization: Bearer tl_live_your_key_here"Варто знати
- Грошові суми завжди передаються рядком у доларах США, наприклад
"18.00". - Кожен файл тарифікується щонайменше як 2 000 записів, і в API, і на сайті.
- Список до 100 000 записів і 4 MB можна передати в запиті. Більший список, до 10 000 000 записів або 200 MB, передається через
POST /uploads. - Перевіряйте стан замовлення з інтервалом не менше 30 секунд. Час виконання замовлення залежить від його розміру та перевірки.
- Закладайте до 5 хвилин на відповідь від
POST /estimatesіPOST /orders: читання великого списку потребує часу. За коротшого тайм-ауту вам доведеться надсилати запит повторно даремно.