TikTok-Profilaufträge über die API ausführen

Trennen Sie Kostenberechnung, Start und Ergebnisabruf. Speichern Sie die Auftrags-ID sofort nach einer 202-Antwort, damit Ihre Anwendung die Statusprüfung nach einem Neustart fortsetzen kann.

Authentifizieren und Ziele vorbereiten

Erstellen Sie einen Token im Konto und senden Sie Authorization: Bearer sk_live_…. Benötigt werden metadata:read und analyze:write. Das JSON enthält urls und mode="profile". Beginnen Sie mit ein oder zwei zulässigen Zielen. Die Routen stehen in der API-Referenz.

Zuerst Kosten berechnen

POST /api/v1/profiles/quote liefert free, paid, reused, maximum_charge und tariff_version. Senden Sie dieselben urls, die genehmigte maximum_charge und die erhaltene tariff_version an POST /api/v1/profile-batches. Die Berechnung startet keine Erfassung. Ein verändertes kostenloses Kontingent kann eine neue Kostenbestätigung erfordern.

Einen Wiederholungsschlüssel speichern

Senden Sie beim Start Idempotency-Key, beispielsweise profile-import-2026-11-06-001. Wiederholen Sie nach einem Netzwerkausfall denselben Inhalt mit demselben Schlüssel. Der Server liefert den vorhandenen Auftrag. Eine andere Liste oder genehmigte Summe benötigt einen neuen Schlüssel. Ein Schlüsselkonflikt ergibt 409.

Status prüfen und exportieren

Lesen Sie GET /api/v1/profile-batches/{id} mit einer Pause zwischen Anfragen bis zum Endzustand. Für rows verwenden Sie after und limit. Nach Abschluss stehen export?format=json und export?format=csv bereit. POST /api/v1/profile-batches/{id}/cancel beendet verbleibende Arbeit und erhält bereits bereitgestellte Zeilen.

Fehler gezielt behandeln

401 verlangt Authentifizierung, 402 Kontingent oder Credits, 409 die Prüfung von Schlüssel oder Kostenberechnung, 422 korrigierte Eingaben und 429 eine Wartezeit. Prüfen Sie bei angenommenen Aufträgen status und error_code jeder Zeile. Abgerechnet werden erfolgreich bereitgestellte Karten. Die CSV-Anleitung hilft bei der manuellen Prüfung.

Weiterlesen