Skip to main content

​
API key

All API requests require your API key in the x-api-key header. 
curl "https://creatorcrawl.com/api/tiktok/profile?handle=shakira" \
  -H "x-api-key: YOUR_API_KEY"
Get your API key from the CreatorCrawl dashboard.

​
Error responses

StatusDescription
400Missing or invalid parameters. Check the request query string.
401Unauthorized. Your API key is missing or invalid.
502Upstream API error. TikTok’s servers returned an error. Retry the request.

​
Credits

Some endpoints cost credits per request. Credit costs are noted in each endpoint’s description. Monitor your credit usage from the dashboard.

​
Pagination

Many endpoints support cursor-based pagination. The response includes a cursor value (e.g. cursor, max_cursor, or min_time) that you pass as a query parameter to fetch the next page of results. 
curl "https://creatorcrawl.com/api/tiktok/profile/videos?handle=shakira&max_cursor=1234567890" \
  -H "x-api-key: YOUR_API_KEY"

​
Trimmed responses

Several endpoints accept a trim parameter. Set trim=true to receive a smaller response payload with only the most commonly needed fields.