API referenceTikTok
TikTok user search
Keyword search over creators, with follower-band and verified filters.
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 1.6s.
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-user-search-v4" \ -H "Content-Type: application/json" \ -d '{ "keywords": "cooking", "cursor": "0", "count": 30 }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "cursor": "30", "has_more": true, "keywords": "cooking", "users": [ { "avatar_larger": { "height": null, "uri": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7310587793867014186~tplv-tiktokx-cropcenter-q:1080:1080:q70.webp?dr=8837&idc=useast5&ps=87d6e48a&refresh_token=50dd563b&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=tN4iojuYgRACtAUS0boL90O4uuM%3D", "url_list": [ "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7310587793867014186~tplv-tiktokx-cropcenter-q:1080:1080:q70.webp?dr=8837&idc=useast5&ps=87d6e48a&refresh_token=50dd563b&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=tN4iojuYgRACtAUS0boL90O4uuM%3D" ], "url_prefix": null, "width": null }, "avatar_medium": { "height": null, "uri": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7310587793867014186~tplv-tiktokx-cropcenter-q:720:720:q70.webp?dr=8836&idc=useast5&ps=87d6e48a&refresh_token=eda2b769&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=gcBRC8M7eUiX4M3p4%2B9MpcWe5zQ%3D", "url_list": [ "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7310587793867014186~tplv-tiktokx-cropcenter-q:720:720:q70.webp?dr=8836&idc=useast5&ps=87d6e48a&refresh_token=eda2b769&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=gcBRC8M7eUiX4M3p4%2B9MpcWe5zQ%3D" ], "url_prefix": null, "width": null }, "avatar_thumb": { "height": null, "uri": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7310587793867014186~tplv-tiktokx-cropcenter-q:100:100:q70.webp?biz_tag=musically_user.user_cover&dr=8835&idc=useast5&ps=87d6e48a&refresh_token=6928a777&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=1g8u2TBlcMs3Y… (+17 chars)", "url_list": [ "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7310587793867014186~tplv-tiktokx-cropcenter-q:100:100:q70.webp?biz_tag=musically_user.user_cover&dr=8835&idc=useast5&ps=87d6e48a&refresh_token=6928a777&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=1g8u2TBlcMs3Y… (+17 chars)" ], "url_prefix": null, "width": null }, "aweme_count": 507, "favoriting_count": 2874, "follower_count": 22212708, "following_count": 61, "nickname": "Lynja", "region": "US", "sec_uid": "MS4wLjABAAAAEuh22qcjCA4J9HIIBYyqYqu2sMIs57Y-iQZhMeCAg_TWmWYAEAwTLI7zm8Q6z41d", "signature": "Cookingwithlynja@gmail.com\n\n👇Lynja’s Salts & Sugar👇", "total_favorited": 361248960, "uid": "6834290048143049733", "unique_id": "cookingwithlynja", "verified": true }, { "avatar_larger": { "height": null, "uri": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7352667004160966699~tplv-tiktokx-cropcenter-q:1080:1080:q70.webp?dr=8837&idc=useast5&ps=87d6e48a&refresh_token=631c935e&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=pOjglHycr3GPsDzmBoWrFcrGvnE%3D", "url_list": [ "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7352667004160966699~tplv-tiktokx-cropcenter-q:1080:1080:q70.webp?dr=8837&idc=useast5&ps=87d6e48a&refresh_token=631c935e&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=pOjglHycr3GPsDzmBoWrFcrGvnE%3D" ], "url_prefix": null, "width": null }, "avatar_medium": { "height": null, "uri": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7352667004160966699~tplv-tiktokx-cropcenter-q:720:720:q70.webp?dr=8836&idc=useast5&ps=87d6e48a&refresh_token=53bee475&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=T5J0vrL2gfTwytKz55iGlgZvNag%3D", "url_list": [ "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7352667004160966699~tplv-tiktokx-cropcenter-q:720:720:q70.webp?dr=8836&idc=useast5&ps=87d6e48a&refresh_token=53bee475&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=T5J0vrL2gfTwytKz55iGlgZvNag%3D" ], "url_prefix": null, "width": null }, "avatar_thumb": { "height": null, "uri": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7352667004160966699~tplv-tiktokx-cropcenter-q:100:100:q70.webp?biz_tag=musically_user.user_cover&dr=8835&idc=useast5&ps=87d6e48a&refresh_token=d3a9fdaf&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=7YQotxQJWkQpt… (+17 chars)", "url_list": [ "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7352667004160966699~tplv-tiktokx-cropcenter-q:100:100:q70.webp?biz_tag=musically_user.user_cover&dr=8835&idc=useast5&ps=87d6e48a&refresh_token=d3a9fdaf&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=7YQotxQJWkQpt… (+17 chars)" ], "url_prefix": null, "width": null }, "aweme_count": 1059, "favoriting_count": 0, "follower_count": 1857214, "following_count": 1, "nickname": "cooking_recipescr", "region": "US", "sec_uid": "MS4wLjABAAAA9RLA_aJw3o-9lGAAgNdwVqfTMqakk-crm46C_kbbWjvl_QJw-j5GzmOZ0hNY1nDt", "signature": null, "total_favorited": 10596810, "uid": "7352666564073833515", "unique_id": "cooking_recipescr", "verified": false }, "… 28 more items in the full response" ] }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "tiktok-user-search-v4", "billable": true, "duration_ms": 725 }}