scrollport

Search TikTok videos by keyword

Search TikTok videos by keyword

by TikHubReady to run$0.0025 per request · $0.25 per 100 requests

Example

You ask your agent

“Find TikTok videos about coffee.”

You get

Description
Step by step how I make my perfect morning coffee
Music title
original sound - noahsterncoffee
Author
Noah Stern
User count
1
Nickname
Noah Stern
Follower count
306,698
Following count
114
Comment count
1107
What your agent sends and gets back (JSON)

Your agent works out the exact inputs, such as IDs, dates and settings, from what you ask.

Request

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

Response

{
  "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
          }
        }
      }
    ]
  }
}

Use it with your agent

Copy the prompt and paste it into your agent, then 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.

Provider access is included. If your agent isn't connected to Scrollport yet, it will help you set that up.

Other tools for this job

Compare all 23 →

Questions

Is Search TikTok videos by keyword (TikHub) free?

Scrollport has no free tier: it costs $0.0025 per request ($0.25 per 100 requests), paid per use from a prepaid wallet with no subscription. Connecting your first agent adds $1 of trial credit, so you can try it before adding funds.

Do I need an API key from TikHub?

No. Your agent runs it through your Scrollport connection (MCP, the Scrollport CLI or the HTTP API), and Scrollport handles access to TikHub, so you don't sign up with TikHub or manage an API key.

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.

All inputs and outputs

Input

countinteger · optional

Maximum items requested per page (1–20); Scrollport defaults to 10. Results may contain fewer items.

minimum: 1 · maximum: 20

keywordstring · required

Words to search for on TikTok.

minLength: 1 · maxLength: 500

offsetinteger · optional

Start with 0; use the next offset returned by the response for another page.

minimum: 0 · maximum: 10000

publish_timeinteger · optional

Publish window: 0 = any time; 1, 7, 30, 90 or 180 = the previous number of days. This is not a Unix timestamp.

minimum: 0 · maximum: 4102444800

regionstring · optional

TikTok region or ISO 3166-1 alpha-2 country code, such as US or GB; upstream defaults to US. This selects a search region, not a regional trend chart.

minLength: 1 · maxLength: 500

sort_typeinteger · optional

Documented ordering: 0 = relevance, 1 = most liked. Other sort values are not verified.

minimum: 0 · maximum: 1000000

Output

dataobject

Main result payload.

Errors and limits
  • 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.