TikTok API endpoint
Returns the tab keys the mobile search screen offers for a keyword (`general`, `video`, `photos`, `user`, `music`, `live`, `place`, `hashtag`), plus the gateway's `is_failed` flag. Measured on the mobile search edge with a form POST.
/tiktok/mobile/search/tabsReturns the tab keys the mobile search screen offers for a keyword, in the app's order. The app requests these
before rendering the tab bar, and the list is what GET /api/v1/tiktok/mobile/search and its sibling search routes
are partitioned by.
Measured 2026-10-20 on the aggr32-normal.tiktokv.us search edge (form POST): 8 tabs
(general, video, photos, user, music, live, place, hashtag), is_failed: 1 in the captured call —
the flag reports an internal experiment result and does not mean the tab list is unusable.
Query parameters:
keyword: required. Search keyword. Example: lofi.| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required | ||
| keyword | string | Yes | Search keyword | lofi |
curl -X GET "https://api.crawlora.net/api/v1/tiktok/mobile/search/tabs?keyword=lofi" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"keyword": "lofi",
"tabs": [
"general",
"video",
"photos",
"user",
"music",
"live",
"place",
"hashtag"
],
"is_failed": 1,
"host": "aggr32-normal.tiktokv.us",
"fetched_at": "2026-10-20T08:20:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/tiktokmobile.searchTabsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| fetched_at | string | No | ||||
| host | string | No | aggr32-normal.tiktokv.us | |||
| is_failed | integer | No | 0 | |||
| keyword | string | No | lofi | |||
| tabs | array | No |
| Status | Description | Schema |
|---|---|---|
| 400 | Invalid input | #/definitions/app.Response |
| 429 | Rate limit exceeded | #/definitions/app.Response |
| 500 | Internal server error | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/tiktok/mobile/search/tabs?keyword=lofi" \
-H "x-api-key: $CRAWLORA_API_KEY"