Профілі TikTok через API — від розрахунку до експорту
Розділіть розрахунок, запуск і читання результатів на окремі запити. Одразу збережіть ідентифікатор партії з відповіді 202, щоб продовжити перевірку після перезапуску вашої програми.
Авторизація та список цілей
Створіть токен у кабінеті та передавайте Authorization: Bearer sk_live_…. Потрібні metadata:read і analyze:write. Підготуйте JSON зі списком urls та mode="profile". Почніть з однієї-двох дозволених цілей. Маршрути описані в довіднику API.
Спочатку отримайте розрахунок
POST /api/v1/profiles/quote повертає free, paid, reused, maximum_charge і tariff_version. Передайте ті самі urls, погоджений maximum_charge та отриману tariff_version у POST /api/v1/profile-batches. Розрахунок сам по собі не запускає збирання. Зміна безкоштовного залишку може вимагати нового підтвердження вартості.
Збережіть ключ повтору
Під час запуску передайте Idempotency-Key, наприклад profile-import-2026-11-06-001. Після мережевого обриву повторіть те саме тіло й ключ. Сервер поверне наявну партію. Для іншого списку чи погодженої вартості потрібен новий ключ. Конфлікт ключа повертає 409.
Перевіряйте стан та експортуйте
Читайте GET /api/v1/profile-batches/{id} до кінцевого стану з паузою між запитами. Для rows використовуйте after та limit. Після завершення доступні export?format=json і export?format=csv. POST /api/v1/profile-batches/{id}/cancel скасовує решту роботи та зберігає видані рядки.
Розрізняйте рівні помилок
401 потребує авторизації, 402 — ліміту чи кредитів, 409 — перевірки ключа або розрахунку, 422 — виправлення вводу, 429 — очікування. У прийнятій партії перевіряйте status та error_code кожного рядка. Списання відповідає отриманим карткам. Для ручної перевірки використовуйте посібник CSV.