Back to Search TikTok

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.

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

countinteger · optional

items per page (default 20)

minimum: 1 · maximum: 20

keywordstring · required

Value supplied for keyword.

minLength: 1 · maxLength: 500

offsetinteger · optional

Value supplied for offset.

minimum: 0 · maximum: 10000

publish_timeinteger · optional

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

minimum: 0 · maximum: 4102444800

regionstring · optional

region code; default US

minLength: 1 · maxLength: 500

sort_typeinteger · optional

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

minimum: 0 · maximum: 1000000

Output

dataobject

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.