JSON POST request example
POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/tiktok/search-hashtag with Content-Type: application/json and your Authorization: Bearer header.
{
"hashtag": "python",
"count": 3
}// request reference
TikTok Search Hashtag parameters
Send query parameters with GET /api/tiktok/search-hashtag. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server.
POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.
Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.
Request parameters
cursorUpstream pagination cursor from the preceding response; 0 starts a new feed.
Type string | integer · GET query or POST JSON · Default 0
- Pattern: ^[0-9]{1,25}$ (string)
- Minimum: 0 (integer)
- Maximum: 9223372036854775807 (integer)
countRequested page size, between 1 and 35.
Type integer · GET query or POST JSON · Default 20
- Minimum: 1
- Maximum: 35
hashtagTikTok hashtag name, with or without the leading #.
Type string · GET query or POST JSON
- Minimum characters: 1
- Maximum characters: 100
- Pattern: ^#?[^\s#/&?=]+$
// response
Work with the complete JSON response
Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.
Response groups include has_more, cursor, total, items, submit_feedback_for_this_response_here.
Failed requests return status 503 with {"error":"Service unavailable"} and are not billed.
Example successful response.
{
"has_more": true,
"cursor": "3",
"items": [
{
"author": {
"id": "6699542567460389894",
"nickname": "Jay Prehistoric",
"uniqueId": "jayprehistoricpets",
"verified": true
},
"createTime": 1620481002,
"desc": "Literally drooling to get me 😂 she’s never been the nicest 🤷♂️ #snake #python #behindthescenes",
"id": "6959912891663371525",
"stats": {
"collectCount": 24800,
"commentCount": 4129,
"diggCount": 584400,
"playCount": 14000000,
"shareCount": 25000
},
"video": {
"duration": 36,
"height": 1024,
"id": "6959912891663371525",
"ratio": "540p",
"width": 576
}
},
{
"author": {
"id": "7273574456055890950",
"nickname": "Ball Python Reptiles",
"uniqueId": "ballpythonreptiles",
"verified": false
},
"createTime": 1791588887,
"desc": "🔥Brother and sister looking MUY CALIENTE!🥵🔥 Both are Special YB Spotnose Clowns, and DAMN did these two turn out nice! 😮💨🔥 That girl? Yeah, she's DEFINITELY going in the holdback rack!🔒🐍 Would you keep the brother too? 👀 #ballpythonreptiles #BallPythonMorphs #ClownBallPython #SpotnoseClown",
"id": "7694815628129045767",
"stats": {
"collectCount": 1,
"commentCount": 0,
"diggCount": 9,
"playCount": 218,
"shareCount": 2
},
"video": {
"duration": 16,
"height": 1024,
"id": "7694815628129045767",
"ratio": "540p",
"width": 576
}
}
],
"submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}