Розміщення замовлень

1. Виберіть перевіркуCopy Anchor Link

GET /checkers показує, що може замовити ваш акаунт, за вашими цінами. Кожна перевірка має id, наприклад whatsapp_status_detection, і приймає телефони, email або імена користувачів. Див. Перевірки.

curl "https://api.talismanleads.io/v1/checkers" \
  -H "Authorization: Bearer tl_live_your_key_here"

2. Надішліть списокCopy Anchor Link

Передайте в запиті до 100 000 записів і 4 MB у полі entries. Для більшого списку запитайте посилання через POST /uploads, надішліть файл на це посилання методом PUT, потім використайте його upload_id. Посилання діє 2 години. Не надсилайте на нього свій API-ключ.

• Файл: .txt з одним записом у кожному рядку, до 200 MB і 10 000 000 записів.
• Вказуйте номери телефонів із кодом країни, наприклад +14155550142.
• Номери телефонів в одному файлі мають бути з однієї країни: щонайменше 90% з них. Розділіть змішаний список на окремі файли за країнами.
• Один недійсний рядок призводить до відхилення всього списку, а у відповіді показано приклади.
• Завантажений файл чекає на замовлення 24 години, після чого видаляється.
• Одночасно у вас можуть очікувати 20 файлів або 100 MB, незалежно від кількості використовуваних API-ключів, і ви можете виконувати 500 завантажень на день. Поки ви не досягли цих меж, понад них можна додати один файл будь-якого дозволеного розміру.

Запитайте посилання

curl -X POST "https://api.talismanleads.io/v1/uploads" \
  -H "Authorization: Bearer tl_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"file_name":"list.txt","size_bytes":1048576}'

Надішліть на нього файл

UPLOAD_URL="PASTE_upload_url_FROM_THE_ANSWER_ABOVE"
curl --upload-file list.txt "$UPLOAD_URL" \
  -H "Content-Type: text/plain" \
  -w "%{http_code}\n"

3. Дізнайтеся цінуCopy Anchor Link

POST /estimates рахує записи й розраховує ціну, нічого не списуючи. billed_entries може бути більшим за entries, оскільки кожен файл тарифікується щонайменше як 2 000.

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"]}'

4. Розмістіть замовленняCopy Anchor Link

POST /orders списує кошти з вашого балансу й ставить роботу в чергу. Передайте Idempotency-Key, щоб повтор не міг призвести до подвійного списання: див. Безпечні повтори. Для впевненості в ціні передайте expected_charge, і замовлення буде відхилено з кодом price_changed, якщо його вартість виявиться будь-якою іншою. Закладайте до 5 хвилин на відповідь, оскільки читання великого списку потребує часу.

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"]}'

5. Стежте за станомCopy Anchor Link

Запитуйте GET /orders/{id} з інтервалом не менше 30 секунд. Великий файл непомітно для вас ділиться на частини, але замовлення має один стан і один підсумок.

queued

Очікує на запуск.

processing

Виконується.

completed

Завершено, усі частини виконано.

partially_completed

Завершено, деякі частини не вдалися. Кошти за ці частини повертаються: `refunded` показує, скільки повернулося.

failed

Жодну частину виконати не вдалося. Списані кошти повертаються: `refunded` показує, скільки повернулося.

Можуть з’явитися нові стани, тому вважайте незнайомий стан таким, що ще виконується.

curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
  -H "Authorization: Bearer tl_live_your_key_here"

6. Отримайте результатCopy Anchor Link

GET /orders/{id}/results видає посилання для скачування кожної частини, дійсне 15 хвилин. Нове посилання можна запитати будь-коли: результати зберігаються. Файл зазвичай є zip-архівом із all.csv, електронною таблицею й текстовими списками або одним CSV. Стовпці можуть додаватися, тому читайте їх за назвою, а не за позицією. Не надсилайте на ці посилання свій API-ключ.

curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
  -H "Authorization: Bearer tl_live_your_key_here"

Списання та поверненняCopy Anchor Link

charge показує, скільки коштувало замовлення під час розміщення, а refunded показує, скільки з цієї суми повернулося. За невдалу частину кошти повертаються повністю, а за частину, яку постачальник нарахував меншою, повертається різниця, але не нижче за мінімум, за яким тарифікується ця частина. І те, і те відбувається автоматично.

За той самий список у тій самій перевірці протягом приблизно доби з новим Idempotency-Key кошти списуються знову, як за нове замовлення, і замовлення може повернути ваш попередній результат замість нової перевірки.

Замовлення з інших місцьCopy Anchor Link

Замовлення, які ви розміщуєте на сайті, теж є у списку. Замовлення через API з’являються на сайті в розділі «Мої завдання» зі значком API й нічого не надсилають у Telegram, якщо ви не попросите про це там.