Export TikTok profiles to CSV with row-level results
Keep a copy of your original input. It lets you join the exported rows to campaign notes and review errors without losing the order in which the accounts were submitted.
Prepare one URL column
Create a UTF-8 CSV with a url header and one account URL per row. A three-line example is the header url followed by https://www.tiktok.com/@tiktok twice. Additional columns cause a format error. You can also upload TXT or paste one URL per line.
| url |
|---|
| https://www.tiktok.com/@tiktok |
| https://www.tiktok.com/@tiktok |
Review unique targets and cost
Sign in to the profile workspace, upload the file and add the profiles. The cost is calculated automatically. Duplicate rows keep their input positions while sharing one collection task. Check the unique count and maximum charge. If the allowance is insufficient, reduce the list or review credit packs.
Inspect every row status
complete means the card was delivered. not_found identifies a missing account, rate_limited indicates a source restriction, and temporary_error indicates a temporary failure. A partially successful batch retains completed cards. Cancellation stops remaining work and releases its reserved cost. You can then export the results already delivered.
Join the export to your input
CSV and JSON become available after completion or cancellation. input_index is the original row number, status is its outcome, and fetched_at is the capture time. The export also contains identity fields, bio, metrics, charged and error_code. The charged column assigns each unique target’s cost once. Filter failed rows to prepare a later retry.
Export a separate video table
With Profile with videos, Video CSV contains one row per collected publication, linked to the author and source input row. JSON keeps collected posts with profile results. See the profile video guide for limits and fields.
Preserve unknown values
Keep an empty metric distinct from zero. Compare stable account IDs and capture times when looking for changes. Read the profile field guide for interpretation and the API guide for recurring imports.