TikTok Search by Keyword

Searches for TikTok videos by keyword or phrase — the general video search across all of TikTok.

1 credit / request

GET /v1/tiktok/search/keyword Try it

TikTok Search by Keyword
GET /v1/tiktok/search/keyword

Searches for TikTok videos by keyword or phrase — the general video search across all of TikTok.

Authentication: x-api-key
Example URL: https://api.datawake.ai/v1/tiktok/search/keyword?date_posted=all-time&sort_by=relevance&cursor=10

Parameters:
- query (query · string · required)
- date_posted (query · string · optional) = all-time
- sort_by (query · string · optional) = relevance
- region (query · string · optional)
- cursor (query · number · optional) = 10
- trim (query · boolean · optional)

Overview

WakeScrap exposes this TikTok endpoint as a live-data API. The platform keeps the documented request and response shape stable while unifying auth, request tracking, and credits billing.

Searches for TikTok videos by keyword or phrase — the general video search across all of TikTok. Returns `search_item_list`, an array of objects each containing `aweme_info` with `aweme_id`, `desc` (caption), `statistics` (play_count, digg_count/likes, comment_count, share_count), `video` info, and `author` details. Paginate with `cursor`.

Required params: query.

Headers

x-api-key string required

Your Wake API access key.

Example:

YOUR_API_KEY

Query Parameters

query string required

Keyword to search for

date_posted string

Time Frame

Example:

all-time

enum: yesterday, this-week, this-month, last-3-months, last-6-months, all-time

sort_by string

Sort by

Example:

relevance

enum: relevance, most-liked, date-posted

region string

This parameter does not filter results by region directly; it sets the region used for the request. Use it in case you want to scrape posts only available for some country. Use 2-letter country codes like US, GB, FR, etc

cursor number

Cursor to get more videos. Get 'cursor' from previous response.

Example:

trim boolean

Set to true to get a trimmed response


              curl 'https://api.datawake.ai/v1/tiktok/search/keyword?date_posted=all-time&sort_by=relevance&cursor=10' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'


              const response = await fetch("https://api.datawake.ai/v1/tiktok/search/keyword?date_posted=all-time&sort_by=relevance&cursor=10", {
  method: "GET",
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Accept': 'application/json',
  },
});

const data = await response.json();
console.log(data);


              import requests

response = requests.request(
    "GET",
    "https://api.datawake.ai/v1/tiktok/search/keyword?date_posted=all-time&sort_by=relevance&cursor=10",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Accept": "application/json",
    },
)

print(response.json())


              $ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.datawake.ai/v1/tiktok/search/keyword?date_posted=all-time&sort_by=relevance&cursor=10",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        'x-api-key: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;


              client := &http.Client{}
req, err := http.NewRequest("GET", "https://api.datawake.ai/v1/tiktok/search/keyword?date_posted=all-time&sort_by=relevance&cursor=10", nil)
if err != nil {
    panic(err)
}

req.Header.Set("x-api-key", "YOUR_API_KEY")
req.Header.Set("Accept", "application/json")

resp, err := client.Do(req)
if err != nil {
    panic(err)
}
defer resp.Body.Close()

body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))


              HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.datawake.ai/v1/tiktok/search/keyword?date_posted=all-time&sort_by=relevance&cursor=10"))
    .header("x-api-key", "YOUR_API_KEY")
    .header("Accept", "application/json")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());


              {
  "search_item_list": [
    {
      "aweme_id": "7268287584244124971",
      "desc": "Tìm 'musclesandnursing'",
      "desc_language": "vi",
      "region": "US",
      "statistics": {
        "aweme_id": "7268287584244124971",
        "collect_count": 6978,
        "comment_count": 187,
        "digg_count": 481608,
        "download_count": 458,
        "forward_count": 0,
        "lose_comment_count": 0,
        "lose_count": 0,
        "play_count": 1282645,
        "repost_count": 0,
        "share_count": 2721,
        "whatsapp_share_count": 56
      },
      "video": {
        "CoverTsp": 0,
        "ai_dynamic_cover": {
          "uri": "...",
          "url_list": "...",
          "url_prefix": "..."
        },
        "ai_dynamic_cover_bak": {
          "uri": "...",
          "url_list": "...",
          "url_prefix": "..."
        },
        "animated_cover": {
          "uri": "...",
          "url_list": "...",
          "url_prefix": "..."
        },
        "big_thumbs": [],
        "bit_rate": [
          "..."
        ],
        "bit_rate_audio": [],
        "cdn_url_expired": 0,
        "cla_info": {
          "caption_infos": "...",
          "captions_type": "...",
          "creator_edited_caption_id": "...",
          "enable_auto_caption": "...",
          "has_original_audio": "...",
          "hide_original_caption": "...",
          "no_caption_reason": "...",
          "original_language_info": "...",
          "vertical_positions": "..."
        },
        "cover": {
          "height": "...",
          "uri": "...",
          "url_list": "...",
          "url_prefix": "...",
          "width": "..."
        },
        "did_profile_labels": "",
        "download_addr": {
          "data_size": "...",
          "height": "...",
          "uri": "...",
          "url_list": "...",
          "url_prefix": "...",
          "width": "..."
        },
        "download_no_watermark_addr": {
          "data_size": "...",
          "file_cs": "...",
          "file_hash": "...",
          "height": "...",
          "uri": "...",
          "url_key": "...",
          "url_list": "...",
          "url_prefix": "...",
          "width": "..."
        },
        "duration": 22874,
        "dynamic_cover": {
          "height": "...",
          "uri": "...",
          "url_list": "...",
          "url_prefix": "...",
          "width": "..."
        },
        "has_watermark": true,
        "height": 1024,
        "is_bytevc1": 0,
        "...": "9 more fields"
      },
      "author": {
        "accept_private_policy": false,
        "account_labels": null,
        "ad_cover_url": null,
        "advance_feature_item_order": null,
        "advanced_feature_info": null,
        "authority_status": 0,
        "avatar_168x168": {
          "height": "...",
          "uri": "...",
          "url_list": "...",
          "url_prefix": "...",
          "width": "..."
        },
        "avatar_300x300": {
          "height": "...",
          "uri": "...",
          "url_list": "...",
          "url_prefix": "...",
          "width": "..."
        },
        "avatar_larger": {
          "height": "...",
          "uri": "...",
          "url_list": "...",
          "url_prefix": "...",
          "width": "..."
        },
        "avatar_medium": {
          "height": "...",
          "uri": "...",
          "url_list": "...",
          "url_prefix": "...",
          "width": "..."
        },
        "avatar_thumb": {
          "height": "...",
          "uri": "...",
          "url_list": "...",
          "url_prefix": "...",
          "width": "..."
        },
        "avatar_uri": "tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777",
        "aweme_count": 0,
        "bold_fields": null,
        "can_message_follow_status_list": null,
        "can_set_geofencing": null,
        "cha_list": null,
        "comment_filter_status": 0,
        "...": "76 more fields"
      },
      "create_time": 1692280120,
      "is_ad": false,
      "is_eligible_for_commission": false,
      "create_time_utc": "2023-08-17T13:48:40.000Z",
      "url": "https://www.tiktok.com/@thatgreygentlemanitdxz/video/7268287584244124971"
    }
  ],
  "cursor": 30
}


              {
  "error": {
    "code": "invalid_request",
    "message": "One or more required parameters are missing or invalid."
  }
}


              {
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing x-api-key header."
  }
}


              {
  "error": {
    "code": "insufficient_credits",
    "message": "This request requires available credits before execution."
  }
}