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.