Profile TikTok przez API — wycena, zadanie i eksport

Rozdziel wycenę, uruchomienie i odczyt wyników na osobne żądania. Zapisz identyfikator zadania zaraz po odpowiedzi 202, aby wznowić sprawdzanie po restarcie aplikacji.

Autoryzacja i lista celów

Utwórz token w panelu i wysyłaj Authorization: Bearer sk_live_…. Potrzebne są metadata:read oraz analyze:write. Przygotuj JSON z urls i mode="profile". Zacznij od jednego lub dwóch dozwolonych celów. Trasy opisuje dokumentacja API.

Najpierw pobierz wycenę

POST /api/v1/profiles/quote zwraca free, paid, reused, maximum_charge oraz tariff_version. Wyślij te same urls, zatwierdzone maximum_charge i otrzymaną tariff_version do POST /api/v1/profile-batches. Wycena sama nie uruchamia zbierania. Zmiana bezpłatnego limitu może wymagać ponownego potwierdzenia kosztu.

Zachowaj klucz powtórzenia

Przy uruchomieniu wyślij Idempotency-Key, na przykład profile-import-2026-11-06-001. Po przerwaniu połączenia powtórz to samo żądanie z tym samym kluczem. Serwer zwróci istniejące zadanie. Inna lista lub zatwierdzona kwota wymaga nowego klucza. Konflikt klucza daje 409.

Sprawdzaj stan i eksportuj

Odczytuj GET /api/v1/profile-batches/{id} do stanu końcowego, zachowując przerwę między żądaniami. Dla rows użyj after i limit. Po zakończeniu dostępne są export?format=json i export?format=csv. POST /api/v1/profile-batches/{id}/cancel zatrzymuje pozostałą pracę i zachowuje dostarczone wiersze.

Obsługuj błędy na właściwym poziomie

401 wymaga logowania, 402 limitu lub kredytów, 409 sprawdzenia klucza albo wyceny, 422 poprawienia wejścia, 429 odczekania. W przyjętym zadaniu sprawdzaj status i error_code każdego wiersza. Opłaty odpowiadają dostarczonym kartom. W ręcznej kontroli pomoże poradnik CSV.

Czytaj dalej