開発者向け
すべてのチェッカーをご自身のサーバーから実行
TalismanLeads API では、ウェブサイトと同じことができます。リストを送信し、料金を確認し、注文して、結果を取得します。同じ残高から、同じ料金でお支払いいただきます。
ご利用の流れ
APIキーを作成
アカウントで APIキーを作成します。一度しか表示されないため、安全な場所に保管してください。
見積もり
リストを
POST /estimatesに送信すると、料金とリストの問題点を確認できます。請求は発生しません。注文する
同じリストを
Idempotency-KeyとともにPOST /ordersに送信します。何回送信しても、その注文の請求は 1 回だけです。結果を取得
完了するまで
GET /orders/{id}で確認し、その後GET /orders/{id}/resultsからファイルを取得します。
クイックスタート
キーはご自身の APIキーに置き換えてください。ベース URL は 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 秒以上の間隔で行ってください。注文にかかる時間はサイズとチェッカーによって異なります。
POST /estimatesとPOST /ordersのレスポンスには最大 5 分を見込んでください。大きなリストの読み取りには時間がかかります。タイムアウトを短くすると、無駄に再送信することになります。