# Search TikTok videos by keyword

TikHub

Search TikTok videos by keyword

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Search TikTok videos by keyword (tool ID: tikhub.tiktok-search-videos). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Search TikTok](https://scrollport.com/tools/tiktok-api)

**Current price:** $0.0025/request

**Availability:** Ready to run

## Tool details

**About this tool**

Search TikTok videos by keyword Retrieve one bounded result or page. Pagination is explicit; each follow-up page is another call. The catalog price is the maximum per request. Quotes use the selected limits. Completed requests cost their quote, including valid empty pages and no-match answers. Failed requests are uncharged. Read public social data without a connected social account. Results include reviewed business data and available pagination. The worked example shows selected fields from a recorded response, with at most one selected item from each list.

**Inputs and outputs**

### Input

`count` integer · optional

items per page (default 20)

minimum: 1 · maximum: 20

`keyword` string · required

Value supplied for keyword.

minLength: 1 · maxLength: 500

`offset` integer · optional

Value supplied for offset.

minimum: 0 · maximum: 10000

`publish_time` integer · optional

0 all time (default); other values narrow the publish window

minimum: 0 · maximum: 4102444800

`region` string · optional

region code; default US

minLength: 1 · maxLength: 500

`sort_type` integer · optional

0 relevance (default), 1 most liked, 2 newest

minimum: 0 · maximum: 1000000

### Output

`data` object

Returned data value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "tikhub.tiktok-search-videos",
  "input": {
    "count": 5,
    "offset": 0,
    "keyword": "coffee"
  }
}
```

### Output

```
{
  "data": {
    "search_item_list": [
      {
        "aweme_info": {
          "desc": "Step by step how I make my perfect morning coffee",
          "music": {
            "id": "7681528891646774029",
            "title": "original sound - noahsterncoffee",
            "author": "Noah Stern",
            "status": 1,
            "sec_uid": "MS4wLjABAAAAdBGROlxYI505ONzcMp2I61933gQsY5_KHqYFDww5GvgaUvHFhm5s4LqMkMICWczk",
            "user_count": 1
          },
          "author": {
            "status": 1,
            "sec_uid": "MS4wLjABAAAAdBGROlxYI505ONzcMp2I61933gQsY5_KHqYFDww5GvgaUvHFhm5s4LqMkMICWczk",
            "nickname": "Noah Stern",
            "unique_id": "noahsterncoffee",
            "follower_count": 306698,
            "following_count": 114
          },
          "status": {
            "aweme_id": "7681528849632349454"
          },
          "aweme_id": "7681528849632349454",
          "statistics": {
            "aweme_id": "7681528849632349454",
            "comment_count": 1107
          },
          "content_model": {
            "standard_biz": {
              "penalty_context": {
                "status": 102
              }
            }
          },
          "comment_config": {
            "comment_top_bar_component": [
              {
                "name": "search_keywords",
                "desc_prefix": {
                  "content": "Search:"
                },
                "desc_suffix": {
                  "content": "instant coffee vs coffee machine"
                }
              }
            ]
          },
          "interact_permission": {
            "allow_adding_as_post": {
              "status": 0
            },
            "allow_create_sticker": {
              "status": 0
            },
            "allow_story_switch_to_post": {
              "status": 1
            }
          },
          "added_sound_music_info": {
            "id": "7681528891646774029",
            "title": "original sound - noahsterncoffee",
            "author": "Noah Stern",
            "status": 1,
            "sec_uid": "MS4wLjABAAAAdBGROlxYI505ONzcMp2I61933gQsY5_KHqYFDww5GvgaUvHFhm5s4LqMkMICWczk",
            "user_count": 1
          }
        }
      }
    ]
  }
}
```

**Errors and limitations**

- `invalid_input`: The lookup fields or limits are invalid.example: {"keyword":"coffee","count":5,"offset":0}
- `upstream_error`: The provider could not complete a verified result; the wallet was not charged.Check the documented fields and contact Scrollport support with the run ID if needed.

---

Canonical page: https://scrollport.com/tools/providers/tikhub/tiktok-search-videos