Aufträge erteilen

1. Prüfung wählenCopy Anchor Link

GET /checkers listet auf, was Ihr Konto beauftragen kann, zu Ihren Preisen. Jede Prüfung hat eine id, zum Beispiel whatsapp_status_detection, und nimmt Telefonnummern, E-Mails oder Benutzernamen an. Siehe Prüfungen.

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

2. Liste sendenCopy Anchor Link

Geben Sie bis zu 100.000 Einträge und 4 MB in der Anfrage als entries an. Für eine größere Liste fordern Sie über POST /uploads einen Link an, senden die Datei mit PUT an diesen Link und verwenden dann ihre upload_id. Der Link gilt 2 Stunden. Senden Sie Ihren API-Schlüssel nicht an ihn.

• Eine Datei ist eine .txt mit einem Eintrag pro Zeile, bis zu 200 MB und 10.000.000 Einträge.
• Schreiben Sie Telefonnummern mit Ländervorwahl, zum Beispiel +14155550142.
• Telefonnummern in einer Datei sollten aus einem Land stammen: mindestens 90 % davon. Teilen Sie eine gemischte Liste in eine Datei pro Land auf.
• Eine einzige ungültige Zeile führt zur Ablehnung der ganzen Liste, und die Antwort zeigt Beispiele.
• Eine hochgeladene Datei wartet 24 Stunden auf einen Auftrag und wird dann entfernt.
• Sie können gleichzeitig 20 Dateien oder 100 MB wartend haben, egal wie viele API-Schlüssel Sie verwenden, und 500 Uploads pro Tag durchführen. Eine Datei jeder erlaubten Größe kann zusätzlich hinzukommen, solange Sie unter diesen Werten liegen.

Link anfordern

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

Datei an den Link senden

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. Preis ansehenCopy Anchor Link

POST /estimates zählt die Einträge und ermittelt den Preis, ohne etwas zu berechnen. billed_entries kann größer sein als entries, da jede Datei mit mindestens 2.000 abgerechnet wird.

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. Auftrag erteilenCopy Anchor Link

POST /orders belastet Ihr Guthaben und stellt die Arbeit in die Warteschlange. Senden Sie einen Idempotency-Key, damit eine Wiederholung Ihnen nicht doppelt berechnet werden kann: siehe Sichere Wiederholungen. Um beim Preis sicherzugehen, senden Sie expected_charge; der Auftrag wird dann mit price_changed abgelehnt, falls er etwas anderes kostet. Planen Sie bis zu 5 Minuten für die Antwort ein, da eine große Liste Zeit zum Einlesen braucht.

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. Status verfolgenCopy Anchor Link

Fragen Sie GET /orders/{id} in Abständen von mindestens 30 Sekunden ab. Eine große Datei wird im Hintergrund in Teile aufgeteilt, ein Auftrag hat aber einen Status und eine Gesamtsumme.

queued

Wartet auf den Start.

processing

Läuft.

completed

Abgeschlossen, alle Teile sind fertig.

partially_completed

Abgeschlossen, einige Teile sind fehlgeschlagen. Diese Teile werden erstattet: `refunded` zeigt, was zurückgeflossen ist.

failed

Kein Teil konnte ausgeführt werden. Der berechnete Betrag wird erstattet: `refunded` zeigt, was zurückgeflossen ist.

Es können weitere Status hinzukommen. Behandeln Sie einen Status, den Sie nicht kennen, daher als noch laufend.

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

6. Ergebnis abrufenCopy Anchor Link

GET /orders/{id}/results liefert für jeden Teil einen Download-Link, der 15 Minuten gilt. Sie können jederzeit erneut einen neuen Link anfordern: Ergebnisse bleiben erhalten. Eine Datei ist meist ein Zip mit all.csv, einer Tabelle und Textlisten oder eine einzelne CSV. Spalten können hinzukommen, lesen Sie sie also nach Name statt nach Position. Senden Sie Ihren API-Schlüssel nicht an diese Links.

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

Belastungen und ErstattungenCopy Anchor Link

charge ist, was der Auftrag beim Erteilen gekostet hat, und refunded ist, wie viel davon zurückgeflossen ist. Ein fehlgeschlagener Teil wird vollständig erstattet, und bei einem Teil, den der Anbieter zu niedrig gezählt hat, wird die Differenz erstattet, bis hinab zum Mindestbetrag, mit dem der Teil abgerechnet wird. Beides geschieht automatisch.

Dieselbe Liste mit derselben Prüfung innerhalb von etwa einem Tag wird unter einem neuen Idempotency-Key erneut als neuer Auftrag berechnet und kann Ihr früheres Ergebnis statt einer neuen Prüfung liefern.

Aufträge von anderswoCopy Anchor Link

Aufträge, die Sie auf der Website erteilen, werden ebenfalls aufgelistet. API-Aufträge erscheinen auf der Website unter Meine Aufgaben mit einem API-Abzeichen und senden nichts an Telegram, sofern Sie das dort nicht anfordern.