Crawlzodocs
API referenceTikTok

TikTok profile (v3)

A TikTok creator's profile with a richer set of fields.

The same target as tiktok-profile, with more of the creator and post detail filled in.

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.1s.

POST
/v1/scrapers/tiktok-profile-v3

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-v3" \  -H "Content-Type: application/json" \  -d '{    "username": "tiktok"  }'
{  "request_id": "req_8f2c1d94e7b0",  "success": true,  "status": {    "code": "OK",    "message": "Scrape completed.",    "retryable": false  },  "data": {    "pagination": {      "has_more": true,      "next_cursor": "1783181969422"    },    "posts": [      {        "advertisement_status": false,        "age_restriction_status": null,        "author_avatar": "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter-q:300:300:q70.webp?dr=9605&refresh_token=754f1b6b&x-expires=1787572800&x-signature=bI1yGzhgdcelpfwAWv1ZkFlHnOY%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=1d1a97fc&idc=useast2b&sc=avatar&s=PUBLISH",        "author_id": "107955",        "author_name": "TikTok",        "author_username": "tiktok",        "caption": "why do fans keep posting 🥚 on @Alex Warren’s TikTok? find out why on the latest \"Seen on LIVE\"",        "categories": null,        "child_content": null,        "comment_count": 1266,        "commenting_status": "enabled",        "content_code": "v15044gf0000da3hmdvog65qoi65khs0",        "content_id": "7676134473112489247",        "content_language": null,        "content_link": "https://www.tiktok.com/@tiktok/video/7676134473112489247",        "content_type": "video",        "download_count": 17,        "extracted_text": null,        "file_size_bytes": 1847542,        "first_comment": null,        "hashtags": [],        "images": [],        "like_count": 4978,        "location": "US",        "media_height": null,        "media_links": {          "audio": "https://v16-ies-music.tiktokcdn-eu.com/e8f29e693a534a40448e5f7c5fcd1a19/6a942426/video/tos/alisg/tos-alisg-ve-2370c799-sg/ootIvh7aIGQDoqeIOpLyAdMITEeSF4deokCVxj/?a=583965&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=125&ft=gk-n4k2O7jHB9wpMLXZmg.CR_dGoZcAyOvqj5H6KJE&mime_type=audio_mpeg&rc=Z2k6OmVlZTxoMzZnOjc1PEBpanVrZXk5cm… (+145 chars)",          "high": "https://v77.tiktokcdn-eu.com/e773967783ca10729023a5e7f7d6610c/6a8c32e7/video/tos/alisg/tos-alisg-ve-37c799-sg/o4AQHiab2Qx7BGRBIfIA4lC6AqiQiywER17xI4/?a=1233&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=634&ft=JS-FgDCnNhHVQc6Gpq8ksdUeuXZqYlBC2MN~hWLrK&mime_type=video_mp4&rc=ZTk6NWRlZTo4MzRoZDM2OUBpM2s4bHQ5cmdrZDMzaTczNEAxLT… (+109 chars)",          "low": null,          "medium": null,          "watermarked": "https://v77.tiktokcdn-eu.com/e10e28f5174bc4424cb705716a2938e6/6a8c32e7/video/tos/alisg/tos-alisg-ve-37c799-sg/oQQRIb4fI1idKqiUAxBHa2i4n7BQAA6IxkGBEC/?a=1233&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=580&ft=JS-FgDCnNhHVQc6Gpq8ksdUeuXZqYlBC2MN~hWLrK&mime_type=video_mp4&rc=ODw2NWQ7ZTs3aDRpNjg4NkBpM2s4bHQ5cmdrZDMzaTczNEBjLz… (+109 chars)"        },        "media_width": null,        "mentions": [          "Alex"        ],        "music_information": {          "album": null,          "author": "TikTok",          "cover_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter-q:1080:1080:q70.webp?dr=9608&refresh_token=e0b45259&x-expires=1787572800&x-signature=2Y%2FbOKjq6ifQHzX6RX%2BRj%2FONevc%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=1d1a97fc&idc=useast2b&sc=avatar&s=PUBLI… (+2 chars)",          "duration_seconds": 22,          "id": "7676134386093378335",          "is_original": true,          "play_url": "https://v16-ies-music.tiktokcdn-eu.com/e8f29e693a534a40448e5f7c5fcd1a19/6a942426/video/tos/alisg/tos-alisg-ve-2370c799-sg/ootIvh7aIGQDoqeIOpLyAdMITEeSF4deokCVxj/?a=583965&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=125&ft=gk-n4k2O7jHB9wpMLXZmg.CR_dGoZcAyOvqj5H6KJE&mime_type=audio_mpeg&rc=Z2k6OmVlZTxoMzZnOjc1PEBpanVrZXk5cm… (+145 chars)",          "title": "original sound - tiktok"        },        "pinned_status": false,        "published_date": 1787239341,        "region": "US",        "save_count": 544,        "share_count": 594,        "shop_products": [],        "slideshow_status": false,        "sponsorship_status": false,        "subtitles": null,        "tagged_users": [          "Alex"        ],        "thumbnail_image": "https://p19-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/o03QBfxVCiqKI6GcOA1AiBFHEPI4AAGyCiuAoz~tplv-tiktokx-cropcenter-q:300:400:q70.jpeg?dr=9232&refresh_token=4cf435d8&x-expires=1787572800&x-signature=ZPUS6f%2B2iAdsF6EifMI7bF02nV4%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=1d1a97fc&idc=useast2b&s=PUBLISH&sc=c… (+21 chars)",        "transcript": null,        "transcript_language": null,        "video_duration_seconds": 22,        "video_link": "https://v77.tiktokcdn-eu.com/e773967783ca10729023a5e7f7d6610c/6a8c32e7/video/tos/alisg/tos-alisg-ve-37c799-sg/o4AQHiab2Qx7BGRBIfIA4lC6AqiQiywER17xI4/?a=1233&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=634&ft=JS-FgDCnNhHVQc6Gpq8ksdUeuXZqYlBC2MN~hWLrK&mime_type=video_mp4&rc=ZTk6NWRlZTo4MzRoZDM2OUBpM2s4bHQ5cmdrZDMzaTczNEAxLT… (+109 chars)",        "view_count": 256882,        "visual_effects": null      },      {        "advertisement_status": false,        "age_restriction_status": null,        "author_avatar": "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter-q:300:300:q70.webp?dr=9605&refresh_token=754f1b6b&x-expires=1787572800&x-signature=bI1yGzhgdcelpfwAWv1ZkFlHnOY%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=1d1a97fc&idc=useast2b&sc=avatar&s=PUBLISH",        "author_id": "107955",        "author_name": "TikTok",        "author_username": "tiktok",        "caption": "Real or AI? 👀🔍 @Jeremy Carrasco has a few tips to help you tell if what you’re looking at is real.",        "categories": null,        "child_content": null,        "comment_count": 691,        "commenting_status": "enabled",        "content_code": "v15044gf0000da2tg27og65sgnb21nhg",        "content_id": "7675779662903069983",        "content_language": null,        "content_link": "https://www.tiktok.com/@tiktok/video/7675779662903069983",        "content_type": "video",        "download_count": 25,        "extracted_text": null,        "file_size_bytes": 10374201,        "first_comment": null,        "hashtags": [],        "images": [],        "like_count": 4159,        "location": "US",        "media_height": null,        "media_links": {          "audio": "https://v16-ies-music.tiktokcdn-eu.com/11aedbab8762efc252d911d2d4cfbb39/6a942482/video/tos/alisg/tos-alisg-ve-2370c799-sg/o4GIHPDuFBfeCDHgwTEZECxoj8aIMqQfAV7OME/?a=583965&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=125&ft=gk-n4k2O7jHB9wpMLXZmg.CR_dGoZcAyOvqj5H6KJE&mime_type=audio_mpeg&rc=aGRoOTYzM2Q2O2dnNTZpZ0Bpanlvc3g5cn… (+145 chars)",          "high": "https://v77.tiktokcdn-eu.com/e2aa9c948440be90ac04dae51615956a/6a8c3343/video/tos/alisg/tos-alisg-ve-37c799-sg/ooTIAE5gRgxQqAsfLyGhcdme6v7DEBFIVCOE1B/?a=1233&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=706&ft=JS-FgDCnNhHVQc6Gpq8ksdUeuXZqYlBC2MN~hWLrK&mime_type=video_mp4&rc=OTVmZ2Q4O2g0aWc6OzY0N0BpanE1cXY5cjV3ZDMzaTczNEBfYl… (+109 chars)",          "low": null,          "medium": null,          "watermarked": "https://v77.tiktokcdn-eu.com/c327c148e9ecc172a06f536efbbec7e2/6a8c3343/video/tos/alisg/tos-alisg-ve-37c799-sg/oAFJjCAgiRY6Xd8oBAA7a32iIQwBaZhYPVEIE/?a=1233&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=652&ft=JS-FgDCnNhHVQc6Gpq8ksdUeuXZqYlBC2MN~hWLrK&mime_type=video_mp4&rc=ZTk4NDU1ZWc7NWdoOTg8aUBpanE1cXY5cjV3ZDMzaTczNEA2My8… (+108 chars)"        },        "media_width": null,        "mentions": [          "Jeremy"        ],        "music_information": {          "album": null,          "author": "TikTok",          "cover_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter-q:1080:1080:q70.webp?dr=9608&refresh_token=e0b45259&x-expires=1787572800&x-signature=2Y%2FbOKjq6ifQHzX6RX%2BRj%2FONevc%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=1d1a97fc&idc=useast2b&sc=avatar&s=PUBLI… (+2 chars)",          "duration_seconds": 114,          "id": "7675779651515566879",          "is_original": true,          "play_url": "https://v16-ies-music.tiktokcdn-eu.com/11aedbab8762efc252d911d2d4cfbb39/6a942482/video/tos/alisg/tos-alisg-ve-2370c799-sg/o4GIHPDuFBfeCDHgwTEZECxoj8aIMqQfAV7OME/?a=583965&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=125&ft=gk-n4k2O7jHB9wpMLXZmg.CR_dGoZcAyOvqj5H6KJE&mime_type=audio_mpeg&rc=aGRoOTYzM2Q2O2dnNTZpZ0Bpanlvc3g5cn… (+145 chars)",          "title": "original sound - tiktok"        },        "pinned_status": false,        "published_date": 1787156730,        "region": "US",        "save_count": 383,        "share_count": 325,        "shop_products": [],        "slideshow_status": false,        "sponsorship_status": false,        "subtitles": null,        "tagged_users": [          "Jeremy"        ],        "thumbnail_image": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/o41AKxFNeBrEuAiI8iUIgPiAAQCZA5PCSx2Bin~tplv-tiktokx-cropcenter-q:300:400:q70.jpeg?dr=9232&refresh_token=ba3f0f2b&x-expires=1787572800&x-signature=M5l0t1JEG2mhLOX7hQQzzLS%2BIbw%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=1d1a97fc&idc=useast2b&biz_tag=tt_vid… (+21 chars)",        "transcript": null,        "transcript_language": null,        "video_duration_seconds": 114,        "video_link": "https://v77.tiktokcdn-eu.com/e2aa9c948440be90ac04dae51615956a/6a8c3343/video/tos/alisg/tos-alisg-ve-37c799-sg/ooTIAE5gRgxQqAsfLyGhcdme6v7DEBFIVCOE1B/?a=1233&bti=M0BzOTg7QGo6OjZALnAjLTAzYCMxNDNg&&bt=706&ft=JS-FgDCnNhHVQc6Gpq8ksdUeuXZqYlBC2MN~hWLrK&mime_type=video_mp4&rc=OTVmZ2Q4O2g0aWc6OzY0N0BpanE1cXY5cjV3ZDMzaTczNEBfYl… (+109 chars)",        "view_count": 130877,        "visual_effects": null      },      "… 28 more items in the full response"    ],    "profile": {      "account_creation_date": 1425144149,      "avatar_medium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=93c57f90&x-expires=1787659200&x-signature=9FlBivXWD8UxHYDRTY91GBCe09U%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=useast8",      "avatar_thumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=216e3264&x-expires=1787659200&x-signature=BQeOgDz3AZrLspcnzAD69DXWkPk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=useast8",      "biography": "One TikTok can make a big impact",      "content_count": 1575,      "display_name": "TikTok",      "external_links": [        "linktr.ee/tiktok"      ],      "follower_count": 95354834,      "following_count": 0,      "instagram_id": null,      "is_ad_virtual": false,      "is_under_18": false,      "location": "US",      "privacy_status": "public",      "profile_id": "107955",      "profile_image": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.webp?dr=9640&refresh_token=5bc2d83c&x-expires=1787659200&x-signature=TR5YOS4M8JHUHzHDrpqcbdELr44%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=useast8",      "profile_link": "https://www.tiktok.com/@tiktok",      "sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",      "total_likes": 462865863,      "total_reactions": 462865863,      "twitter_id": null,      "username": "tiktok",      "verification_status": true,      "youtube_channel_id": null,      "youtube_channel_title": null    }  },  "error": null,  "meta": {    "client_id": "client_abc123",    "scraper": "tiktok-profile-v3",    "billable": true,    "duration_ms": 988  }}

TikTok profile (v1)

A TikTok creator's profile and posts, paged with a cursor.

TikTok regions

The region codes TikTok accepts, with their country names.