Output formats

Every endpoint returns JSON by default. Two alternate formats cover the common “I just want the file” cases:

format	Works on	Returns
json (default)	everything	The standard { data, meta?, request_id } envelope
csv	list endpoints	Flattened rows, one item per line, UTF-8
text	transcript endpoints	The plain transcript, no JSON wrapper

CSV for spreadsheets

curl "https://api.scrapersocial.com/v1/tiktok/comments?url=...&limit=50&format=csv" \
  -H "Authorization: Bearer sk_live_..." -o comments.csv

id,text,author_handle,likes,posted_at
c_9021,"This fixed it for me, thank you",dev.casey,412,2026-07-01T09:12:00Z

Nested objects are flattened with underscores (author.handle → author_handle).

Plain text for LLM prompts

curl "https://api.scrapersocial.com/v1/tiktok/transcript?url=...&format=text" \
  -H "Authorization: Bearer sk_live_..."

Returns only the spoken words — ready to paste into a prompt without JSON parsing. Credits are identical across formats.

Next: Field projection · Pagination