TikTok Explore API
Query public TikTok data synchronously; empty results and failures are free.
Results return directly in the same request; no task submission or polling is needed.
Open product page and API TesterEndpoint and authentication
GET https://api.goanyapi.com/api/v1/tiktok/exploreAuthenticate with Authorization: Bearer YOUR_API_KEY. Supply query-string parameters; there is no request body.
Input parameters
| Parameter | Type | Location | Required | Constraints / default | Description |
|---|---|---|---|---|---|
Authorization | string | Header | Yes | Bearer YOUR_API_KEY | API key for the current account |
category_type | string | Query | Yes | 120 / 119 / 104 / 112 / 100 / 107 / 101 / 105 / 102 / 103 / 109 / 108 / 117 / 116 / 118 / 113 / 106 / 110 / 114 / 115 / 111 | Explore category ID. 120=All; 119=Singing & Dancing; 104=Comedy; 112=Sports; 100=Anime & Comics; 107=Relationship; 101=Shows; 105=Daily Life; 102=Beauty Care; 103=Games; 109=Outfit; 108=Drama; 117=Fitness & Health; 116=Education; 118=Technology; 113=Animals; 106=Family; 110=Lipsync; 114=Society; 115=Cars; 111=Food. |
cursor | string | Query | No | Default: 0 | Collection cursor. Use nextCursor only when returned; never infer an offset. |
count | integer | Query | No | Default: 20; Fixed: 20 | Fixed page size 20; actual returned records may be fewer. |
Use a numeric-string category ID from the table below. Select a category on the product page; the default is 104 (Comedy). Changing the category resets the cursor.
Supported categories
| Category ID | Category |
|---|---|
120 | All |
119 | Singing & Dancing |
104 | Comedy |
112 | Sports |
100 | Anime & Comics |
107 | Relationship |
101 | Shows |
105 | Daily Life |
102 | Beauty Care |
103 | Games |
109 | Outfit |
108 | Drama |
117 | Fitness & Health |
116 | Education |
118 | Technology |
113 | Animals |
106 | Family |
110 | Lipsync |
114 | Society |
115 | Cars |
111 | Food |
Request example
GET /api/v1/tiktok/explore?category_type=104&cursor=0&count=20
Authorization: Bearer YOUR_API_KEYOutput parameters
Success returns HTTP 200. Null, empty and missing business fields are preserved; a zero statistic is valid. Only documented public fields are returned.
| Field | Type | Description |
|---|---|---|
code | string | ok on success |
message | string | Request message |
data.creditsUsed | number | Credits charged for this request; zero for empty results |
data.remainingCredits | number | Account balance after settlement |
data.items | array | Posts on this page; [] for empty results |
data.hasMore | boolean | Whether more records are reported; does not guarantee a cursor |
data.nextCursor | string | null | Returned next cursor, or null when unavailable; never invent a cursor even when hasMore=true |
data.pageSize | integer | Fixed requested maximum 20 |
data.items[].id | string | Post ID |
data.items[].desc | string | Post description |
data.items[].createTime | number | Unix timestamp in seconds |
data.items[].isAd | boolean | Advertisement indicator |
data.items[].author | object | Author information |
data.items[].stats | object | Engagement statistics |
data.items[].statsV2 | object | String statistics |
data.items[].video | object | Video media information |
data.items[].author.id | string | number | boolean | null | Returned public author field; may be absent or empty |
data.items[].author.uniqueId | string | number | boolean | null | Returned public author field; may be absent or empty |
data.items[].author.nickname | string | number | boolean | null | Returned public author field; may be absent or empty |
data.items[].author.signature | string | number | boolean | null | Returned public author field; may be absent or empty |
data.items[].author.secUid | string | number | boolean | null | Returned public author field; may be absent or empty |
data.items[].author.avatarThumb | string | number | boolean | null | Returned public author field; may be absent or empty |
data.items[].author.avatarMedium | string | number | boolean | null | Returned public author field; may be absent or empty |
data.items[].author.avatarLarger | string | number | boolean | null | Returned public author field; may be absent or empty |
data.items[].author.verified | string | number | boolean | null | Returned public author field; may be absent or empty |
data.items[].author.privateAccount | string | number | boolean | null | Returned public author field; may be absent or empty |
data.items[].author.createTime | string | number | boolean | null | Returned public author field; may be absent or empty |
data.items[].video.id | string | number | null | Returned public media field; may be absent or empty |
data.items[].video.desc | string | number | null | Returned public media field; may be absent or empty |
data.items[].video.createTime | string | number | null | Returned public media field; may be absent or empty |
data.items[].video.duration | string | number | null | Returned public media field; may be absent or empty |
data.items[].video.width | string | number | null | Returned public media field; may be absent or empty |
data.items[].video.height | string | number | null | Returned public media field; may be absent or empty |
data.items[].video.ratio | string | number | null | Returned public media field; may be absent or empty |
data.items[].video.cover | string | number | null | Returned public media field; may be absent or empty |
data.items[].video.originCover | string | number | null | Returned public media field; may be absent or empty |
data.items[].video.dynamicCover | string | number | null | Returned public media field; may be absent or empty |
data.items[].video.playAddr | string | number | null | Returned public media field; may be absent or empty |
data.items[].video.downloadAddr | string | number | null | Returned public media field; may be absent or empty |
data.items[].stats.diggCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].stats.shareCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].stats.commentCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].stats.playCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].stats.collectCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].stats.followerCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].stats.followingCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].stats.heartCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].stats.heart | number | string | null | Returned statistic; may be absent or empty |
data.items[].stats.videoCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].stats.friendCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].stats.viewCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].statsV2.diggCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].statsV2.shareCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].statsV2.commentCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].statsV2.playCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].statsV2.collectCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].statsV2.followerCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].statsV2.followingCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].statsV2.heartCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].statsV2.heart | number | string | null | Returned statistic; may be absent or empty |
data.items[].statsV2.videoCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].statsV2.friendCount | number | string | null | Returned statistic; may be absent or empty |
data.items[].statsV2.viewCount | number | string | null | Returned statistic; may be absent or empty |
Real response example
Saved from a real successful response and projected to public fields. Lists show only the first two records. Account balance and request charges are omitted; live responses also contain creditsUsed and remainingCredits based on current configuration. Displaying the example sends no query and charges no credits.
{
"code": "ok",
"message": "ok",
"data": {
"items": [
{
"id": "7697417641027259662",
"desc": "You can move out of your Mexican household but you can’t stop being Mexican, tried so hard to store my pots and pans in a cute way but they belong in the oven… is it just a Mexican thing to use the oven as a storage space for pots n pans ? - - #relatable #mexican #mexicanmemes #funny ",
"createTime": 1792194730,
"isAd": false,
"author": {
"id": "7006760049079878661",
"uniqueId": "milklard",
"nickname": "Milk lard",
"signature": "TWITCH n GYM <3",
"secUid": "MS4wLjABAAAAs8cmTgFigZN2SkC39aSu65y1D34RWlZl6s4bIEXok2XJsv9sWucS2q5QF9kgO5v2",
"avatarThumb": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/d35ba2b5b6dcba916e652ab6854a8d12~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=66f4abab&x-expires=1794646800&x-signature=Tw8Q0%2Bqjc6j9ih7HRaGGYFNwrq0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
"avatarMedium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/d35ba2b5b6dcba916e652ab6854a8d12~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=52a79d42&x-expires=1794646800&x-signature=I3ZVh7DkIge9Gt6nWejP4dz%2Fhlg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
"avatarLarger": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/d35ba2b5b6dcba916e652ab6854a8d12~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=df8da3b6&x-expires=1794646800&x-signature=BPpXMkaW%2Fj0vfaO%2FfkdoWTmsMzo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
"verified": false,
"privateAccount": false
},
"stats": {
"diggCount": 57800,
"shareCount": 4888,
"commentCount": 318,
"playCount": 851600,
"collectCount": 7453
},
"statsV2": {
"diggCount": "57800",
"shareCount": "4888",
"commentCount": "318",
"playCount": "851600",
"collectCount": "7453"
},
"video": {
"id": "7697417641027259662",
"duration": 25,
"width": 720,
"height": 1280,
"ratio": "720p",
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o8utS4sgao42KXkKAAmAgD5dEqh4iPBEBA1iI~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=ulumvDwjVnp%2Bz853eI5ip8sJbV8%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
"originCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oMKCRPVSYwvIBaYIBQ4iAfApuBaiIAnZ1HsyiL~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=crFAVhHSOausZ6Qaq6URsFhs7Z4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
"dynamicCover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o8utS4sgao42KXkKAAmAgD5dEqh4iPBEBA1iI~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=ulumvDwjVnp%2Bz853eI5ip8sJbV8%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
"playAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c002-tx/ogI93IA17aSusiY04R3BLwQCpHBPAfyRQEDZiV/?a=1988&bti=ODszNWYuMDE6&&bt=1052&ft=aEeq8qT0mIoPD12uXwZI3wU4YqAbMeF~O5&mime_type=video_mp4&rc=Z2ZoNTs8ZGQ1ZTY2PDs1OEBpajo0OXI5cnllZTMzZzczNEBgXzJgXzVjNmMxLi1eMDMxYSM1ZF5tMmQ0YDZhLS1kMS9zcw%3D%3D&expire=1794648902&l=20261112093436B813F22474CEB2012F6E&ply_type=2&policy=2&signature=6ef50d7bf0fcf8ac559300b7f65292d6&tk=tt_chain_token&btag=e000b8000",
"downloadAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c003-tx/oUAQuVnyBEjLRS4sAYiQpbIfHAPs1DBIi3wZCa/?a=1988&bti=ODszNWYuMDE6&&bt=965&ft=aEeq8qT0mIoPD12uXwZI3wU4YqAbMeF~O5&mime_type=video_mp4&rc=aTdoNjs8NjlkNGZpZGc8OEBpajo0OXI5cnllZTMzZzczNEA1LjIwNV5eNWIxNS1eYTY0YSM1ZF5tMmQ0YDZhLS1kMS9zcw%3D%3D&expire=1794648902&l=20261112093436B813F22474CEB2012F6E&ply_type=2&policy=2&signature=2d7d4a4e513a1f0355d70438d48e42e4&tk=tt_chain_token&btag=e000b8000"
}
},
{
"id": "7706672760273095950",
"desc": "This one gets the sarcasm from both mom and dad…#fun #girldad ",
"createTime": 1794349608,
"isAd": false,
"author": {
"id": "7018543553433830406",
"uniqueId": "derek_evans",
"nickname": "Derek_Evans 🦆",
"signature": "",
"secUid": "MS4wLjABAAAAEP_720CrhKrszmIVuRxue8KneC3yrJSy7Z_HdMjA08B_5Ny8caB1zApGYooYa2j0",
"avatarThumb": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7345838479902769194~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=23ebee4b&x-expires=1794646800&x-signature=W2abdU%2F44GkHBqyF5hc9dqjWkMc%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
"avatarMedium": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7345838479902769194~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=d9a72b06&x-expires=1794646800&x-signature=ACoi4quQqpw3Aq7QSo8205A3FCk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
"avatarLarger": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7345838479902769194~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=37ac96ff&x-expires=1794646800&x-signature=OzRANAvoMxgwoZDjHsKz8so3OGo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
"verified": false,
"privateAccount": false
},
"stats": {
"diggCount": 909500,
"shareCount": 173000,
"commentCount": 6327,
"playCount": 7700000,
"collectCount": 72100
},
"statsV2": {
"diggCount": "909500",
"shareCount": "173000",
"commentCount": "6327",
"playCount": "7700000",
"collectCount": "72113"
},
"video": {
"id": "7706672760273095950",
"duration": 33,
"width": 720,
"height": 1280,
"ratio": "720p",
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oYCDjzGN5vzeKeRbn3Prke9II0ELQIVLHgAAEO~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=oQlh4Gv60MiFYasWx2ZAnVtOPRA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
"originCover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oY1FnAlezkBStEQVn5FfHCAsnNWuKaQbjtDiIe~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=pfjS5xw8hXivSCBNPWKp2pNyC%2BM%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
"dynamicCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oM2zZiFuTv6UOgzBIiaiED4XIBxLdNtrmAvBy~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=GOEEsrep31kybDB4akVueFQa280%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
"playAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c004-tx/oEyO2lzUIgXmvixBJ49E6AziC0avtNEZWtvQB/?a=1988&bti=ODszNWYuMDE6&&bt=533&ft=aEeq8qT0mIoPD12uXwZI3wU4YqAbMeF~O5&mime_type=video_mp4&rc=NTczZmQ8OWQzPDk1Zzg5NEBpam11eGs5cnFzZTMzZzczNEAwXjM1MzAwXzQxNF80MGI0YSNqMmozMmRrZm1hLS1kMS9zcw%3D%3D&expire=1794648910&l=20261112093436B813F22474CEB2012F6E&ply_type=2&policy=2&signature=4bc1e5a94d907ecb5899a3c9fe667fdb&tk=tt_chain_token&btag=e00088000"
}
}
],
"hasMore": true,
"nextCursor": null,
"pageSize": 20
}
}Pagination
Each request asks for up to 20 records. Actual counts may be smaller. Continue only when hasMore=true and nextCursor is a valid string; pass it as cursor. Never infer an offset from record counts. When hasMore=true but nextCursor=null, this response cannot supply a subsequent page. Each next page is a separate billed request; pages are not fetched automatically.
Billing
With the current configuration, each successful request costs 1 credit.
Non-empty successful results use the currently configured rate; empty results and failures are free. Sufficient balance is required before requesting. A concurrent settlement with insufficient balance also returns 402 without delivering unsettled paid results. Empty or null details and lists without meaningful records are empty; individual empty fields do not make a populated result empty.
Errors
400: invalid parameters; 401: invalid authentication; 402: insufficient credits; 429: rate limit; 502: request failed; 503: API or pricing not configured. Errors contain code and message without internal addresses or credentials.
{"code":"invalid_params","message":"Invalid parameter"}