Loading tools…

Use this tool with your AI agent

Copy the prompt

Paste it into your agent

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 across all content by keyword (tool ID: tikhub.tiktok-app-v3-fetch-general-search-result). 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.

Tool details

About this tool

Search public TikTok content by keyword with explicit offset, count, sort and publish-time filters. Retrieve one bounded result page; each follow-up page is a separate request. Completed requests cost $0.0025, including valid empty pages; failures are uncharged. Results retain content and available pagination while excluding empty presentation markers. The worked example shows selected video identity, caption, creator and engagement fields from a recorded response. Music and other optional metadata may also be returned.

Inputs and outputs

Input

countinteger · optional

Number

minimum: 1 · maximum: 20

keywordstring · required

Keyword

minLength: 1 · maxLength: 500

offsetinteger · optional

Offset

minimum: 0 · maximum: 10000

publish_timeinteger · optional

Publish time

minimum: 0 · maximum: 4102444800

sort_typeinteger · optional

Sort type

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-app-v3-fetch-general-search-result",
  "input": {
    "count": 5,
    "offset": 0,
    "keyword": "coffee",
    "sort_type": 0,
    "publish_time": 0
  }
}

Output

{
  "data": {
    "data": [
      {
        "aweme_info": {
          "desc": "It’s COFFEE TIME ☕️🐓🎶🎉 ",
          "author": {
            "nickname": "Chicken Happy Hour",
            "unique_id": "chickenhappyhour"
          },
          "aweme_id": "7647571066872712479",
          "statistics": {
            "comment_count": 90
          }
        }
      }
    ]
  }
}

Errors and limitations

invalid_input: The lookup fields or limits are invalid.example: {"keyword":"coffee","offset":0,"count":5,"sort_type":0,"publish_time":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.