API referenceTikTok
TikTok profile (v1)
A TikTok creator's profile and posts, paged with a cursor.
The creator's header record and a page of their posts, in the standardised shape.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 2.7s.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/tiktok-profile" \ -H "Content-Type: application/json" \ -d '{ "username": "henripalms" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "bio": { "avatarLarger": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/1374f0888dc8f1ef646260e185e04fda~tplv-tiktokx-cropcenter:1080:1080.webp?dr=9640&refresh_token=9d2b4a24&x-expires=1787659200&x-signature=HfEqHeq%2FCcor0c7R4AAZ%2Fk6xZy8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=useast8", "avatarMedium": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/1374f0888dc8f1ef646260e185e04fda~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=7ff2d07c&x-expires=1787659200&x-signature=e7iMcQOrIcAg4kSG%2B8bOL%2Bq4yoE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=useast8", "avatarThumb": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/1374f0888dc8f1ef646260e185e04fda~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=051508cf&x-expires=1787659200&x-signature=Efny0zZ6K%2F7iplBh9pDUXdWirKI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=useast8", "bioLink": "https://linktr.ee/henripalms", "createTime": 1497763418, "diggCount": 0, "followerCount": 485778, "followingCount": 138, "heart": 68197734, "heartCount": 68197734, "id": "240718742035337217", "ins_id": "", "isADVirtual": false, "isUnderAge18": false, "nickname": "Hcake🧁", "privateAccount": false, "secUid": "MS4wLjABAAAAidNwaKY3p5YXkaiwyzkO7nsqwcHjHR_jUlrsyqxzCxrsugNTqcLNtmk_hbPhOFyI", "signature": "The H🧁\n📧 Contact - quan@stride-social.com\n📧 Personal - henripalms11@gmail.com\n🔗 YOUTUBE & INSTAGRAM & TWITCH IN THE LINK🔗", "twitter_id": "", "uniqueId": "henripalms", "verified": false, "videoCount": 2122, "youtube_channel_id": "", "youtube_channel_title": "" }, "data": [ { "additional": { "ai_dynamic_cover_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast2a-p-0037-euttp/oIFxoQBBiI1QiSIBzzfAI8uvTwOXYrCrAiBgYI~tplv-tiktokx-origin.image?dr=10395&refresh_token=51d7581e&x-expires=1787572800&x-signature=6mtCS5%2Bzi9aU15HmvOrt3VNmYLc%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast2b&s=PUBLISH", "creator_id": "240718742035337217", "creator_nickname": "Hcake🧁", "download_count": 0, "file_size_bytes": 4085922, "is_ad": false, "is_shop_video": false, "is_top": false, "item_comment_settings": 0, "music_author": "Hcake🧁", "music_cover_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/1374f0888dc8f1ef646260e185e04fda~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=8ac97d25&x-expires=1787572800&x-signature=vd412RH%2Bvf7TiVMvR4TNBlUe4dQ%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast2b", "music_duration_seconds": 26, "music_id": "7675647986688477984", "music_is_original": true, "music_play_url": "https://sf16-music.tiktokcdn-eu.com/obj/ies-music-euttp/7676126732528716576.mp3", "music_title": "original sound - henripalms", "music_url": "https://sf16-music.tiktokcdn-eu.com/obj/ies-music-euttp/7676126732528716576.mp3", "origin_cover_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast2a-p-0037-euttp/ocYCxigBoOKArBIif71IBBAwI8FxTQIwruRKWz~tplv-tiktokx-360p.webp?dr=10375&refresh_token=73390489&x-expires=1787572800&x-signature=kmkwizKP6zobhXP%2FozZsvkgkXBU%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast2b&s=PUBLISH&ftpl=1", "region": "GB", "video_aweme_id": "v26044gc0000da2m1nfog65gucdcgeg0", "video_duration_seconds": 26, "watermarked_file_size_bytes": 4222226 }, "main": { "caption": "#Uzbekistan #Kazakhstan #Travel #UK #Viral ", "comment_count": 43, "creator_handle": "henripalms", "hashtags": [ "Uzbekistan", "Kazakhstan", "… 3 more items in the full response" ], "like_count": 1305, "post_id": "7675647987304942880", "post_url": "https://www.tiktok.com/@henripalms/video/7675647987304942880", "profile_picture_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/1374f0888dc8f1ef646260e185e04fda~tplv-tiktokx-cropcenter:300:300.jpeg?dr=10397&refresh_token=8be84412&x-expires=1787572800&x-signature=ptKkjuJf3DuC%2F4LM6%2FzqkAtn4nM%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast2b", "save_count": 42, "share_count": 13, "thumbnail_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast2a-p-0037-euttp/ogTIIgiZkxzunOMFBDBAIBQwI81oYAyCArirfO~tplv-tiktokx-cropcenter:300:400.jpeg?dr=10399&refresh_token=e87c0444&x-expires=1787572800&x-signature=hVYuIOCWDXz294AUh26fegLWqWg%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast2b&s=PUBLISH", "upload_timestamp": 1787126066, "video_url": "https://v16m.tiktokcdn-eu.com/65950e5a134c8354622d7e94fefdb1da/6a8c32eb/video/tos/useast2a/tos-useast2a-ve-0068c001-euttp/o0QIQfhQ5WywDmqAjFWdE2EHKDhofNAdRgBD0m/?a=1233&bti=OTg7QGozQHM6OjZALTAzYCMucCMxNDNg&&bt=1197&ft=JS-FgDCnNW7VQc6Gpq8ksdUeuXZqYl.jJLN~hWLrK&mime_type=video_mp4&rc=ZmU1Z2g8aDo8Ojc0aWZkZkBpM2hmZmo5cnFwZ… (+122 chars)", "video_urls_by_quality": { "high": "https://v16m.tiktokcdn-eu.com/65950e5a134c8354622d7e94fefdb1da/6a8c32eb/video/tos/useast2a/tos-useast2a-ve-0068c001-euttp/o0QIQfhQ5WywDmqAjFWdE2EHKDhofNAdRgBD0m/?a=1233&bti=OTg7QGozQHM6OjZALTAzYCMucCMxNDNg&&bt=1197&ft=JS-FgDCnNW7VQc6Gpq8ksdUeuXZqYl.jJLN~hWLrK&mime_type=video_mp4&rc=ZmU1Z2g8aDo8Ojc0aWZkZkBpM2hmZmo5cnFwZ… (+122 chars)", "low": null, "medium": null, "watermarked": "https://v16m.tiktokcdn-eu.com/3372b9804697fbbd546e474e468ab329/6a8c32eb/video/tos/useast2a/tos-useast2a-ve-0068-euttp/oAxYUQEg1uBvxOrFAwiioBBuCQAIuYBEI8fIzr/?a=1233&bti=OTg7QGozQHM6OjZALTAzYCMucCMxNDNg&&bt=1236&ft=JS-FgDCnNW7VQc6Gpq8ksdUeuXZqYl.jJLN~hWLrK&mime_type=video_mp4&rc=OTdkODk7ZDY3ZjxnOzY6aEBpM2hmZmo5cnFwZDMzZ… (+118 chars)" }, "view_count": 27373 } }, { "additional": { "ai_dynamic_cover_url": "https://p19-common-sign.tiktokcdn-eu.com/tos-useast2a-p-0037-euttp/oMXAGeeLIIxMQ6m7iDVgLDSDQYj5AmKgEG7r7f~tplv-tiktokx-origin.image?dr=10395&refresh_token=37934bc0&x-expires=1787572800&x-signature=AskWA4qm5P3CR8Xl%2B1qLro6f5r8%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast2b&s=PUBLISH", "creator_id": "240718742035337217", "creator_nickname": "Hcake🧁", "download_count": 2, "file_size_bytes": 20017892, "is_ad": false, "is_shop_video": false, "is_top": false, "item_comment_settings": 0, "music_author": "Hcake🧁", "music_cover_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/1374f0888dc8f1ef646260e185e04fda~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=8ac97d25&x-expires=1787572800&x-signature=vd412RH%2Bvf7TiVMvR4TNBlUe4dQ%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast2b", "music_duration_seconds": 71, "music_id": "7674641546457336609", "music_is_original": true, "music_play_url": "https://sf16-music.tiktokcdn-eu.com/obj/ies-music-euttp/7674641551993129760.mp3", "music_title": "original sound - henripalms", "music_url": "https://sf16-music.tiktokcdn-eu.com/obj/ies-music-euttp/7674641551993129760.mp3", "origin_cover_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast2a-p-0037-euttp/oUdEwfcBlQVRDjpIBdfEAlBmzDgFIS4JqdrRSy~tplv-tiktokx-360p.webp?dr=10375&refresh_token=42fcc599&x-expires=1787572800&x-signature=1RgdHROL42O5O%2F9SBKn1ju1WItI%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast2b&s=PUBLISH&ftpl=1", "region": "GB", "video_aweme_id": "v26044gc0000da0slpfog65v8ibmato0", "video_duration_seconds": 71, "watermarked_file_size_bytes": 20535343 }, "main": { "caption": "Cool #uk #relateable #cornwall #Vlog #solareclipse ", "comment_count": 29, "creator_handle": "henripalms", "hashtags": [ "uk", "relateable", "… 3 more items in the full response" ], "like_count": 1616, "post_id": "7674641531617168673", "post_url": "https://www.tiktok.com/@henripalms/video/7674641531617168673", "profile_picture_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/1374f0888dc8f1ef646260e185e04fda~tplv-tiktokx-cropcenter:300:300.jpeg?dr=10397&refresh_token=8be84412&x-expires=1787572800&x-signature=ptKkjuJf3DuC%2F4LM6%2FzqkAtn4nM%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast2b", "save_count": 153, "share_count": 49, "thumbnail_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast2a-p-0037-euttp/oopwfADgwzGDdFRdqRdlrFmEQIlBBJhIqbfcEl~tplv-tiktokx-cropcenter:300:400.jpeg?dr=10399&refresh_token=24be968d&x-expires=1787572800&x-signature=pZgqnxNMoxAD9WrhhdFINx1%2Fi8Y%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast2b&s=PUBLISH", "upload_timestamp": 1786891732, "video_url": "https://v16m.tiktokcdn-eu.com/6c327c9d6b70b8653851303e5dbac75d/6a8c3318/video/tos/useast2a/tos-useast2a-ve-0068-euttp/osGiDfeXg775VLmI5meDALMgIAIGmQSgjKkLtZ/?a=1233&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=2187&ft=JS-FgDCnNW7VQc6Gpq8ksdUeuXZqYl.jJLN~hWLrK&mime_type=video_mp4&rc=Zjk1aTxnaTs1Ojc4ZWkzPEBpM3dwbHk5cnN2ZDMzZ… (+118 chars)", "video_urls_by_quality": { "high": "https://v16m.tiktokcdn-eu.com/6c327c9d6b70b8653851303e5dbac75d/6a8c3318/video/tos/useast2a/tos-useast2a-ve-0068-euttp/osGiDfeXg775VLmI5meDALMgIAIGmQSgjKkLtZ/?a=1233&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=2187&ft=JS-FgDCnNW7VQc6Gpq8ksdUeuXZqYl.jJLN~hWLrK&mime_type=video_mp4&rc=Zjk1aTxnaTs1Ojc4ZWkzPEBpM3dwbHk5cnN2ZDMzZ… (+118 chars)", "low": null, "medium": null, "watermarked": "https://v16m.tiktokcdn-eu.com/f86b284068fa1472998eec2506277972/6a8c3318/video/tos/useast2a/tos-useast2a-ve-0068-euttp/owkDlrqEBJdD9BdzQlmgcfE7FEARaQgfXwlRTI/?a=1233&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=2243&ft=JS-FgDCnNW7VQc6Gpq8ksdUeuXZqYl.jJLN~hWLrK&mime_type=video_mp4&rc=PDhnNGQzZGQ1NDU1aTYzPEBpM3dwbHk5cnN2ZDMzZ… (+118 chars)" }, "view_count": 24214 } }, "… 31 more items in the full response" ], "hasMore": true, "nextCursor": "1785765830691" }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "tiktok-profile", "billable": true, "duration_ms": 1668 }}