Back to Get X (Twitter) posts and profiles

Search X (Twitter) posts by keyword

TikHub

Twitter: fetch search timeline (web)

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 X (Twitter) posts by keyword (tool ID: tikhub.twitter-web-fetch-search-timeline). 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

Twitter: fetch search timeline (web) 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. A post may omit quoted posts, reposts, mentions and media. These content-dependent fields are optional; the example retains each post ID, text, timestamp and author handle.

Inputs and outputs

Input

cursorstring · optional

Cursor

minLength: 1 · maxLength: 4096

keywordstring · required

Search Keyword

minLength: 1 · maxLength: 500

search_typestring · optional

Search Type

minLength: 1 · maxLength: 500

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.twitter-web-fetch-search-timeline",
  "input": {
    "keyword": "Elon Musk",
    "search_type": "Top"
  }
}

Output

{
  "data": {
    "status": "ok",
    "timeline": [
      {
        "text": "🚨🇬🇷 Meanwhile in Athens, Greece \n\n“Europe is heading towards civil war” \n- Elon Musk \n\nThe Greek Capital is on fire - people everywhere have simply had enough ‼️ https://t.co/U1eF5DPyBE",
        "tweet_id": "2104680779578323309",
        "created_at": "Mon Sep 28 21:12:55 +0000 2026",
        "screen_name": "mr_pool4"
      }
    ]
  }
}
Errors and limitations
  • invalid_input: The lookup fields or limits are invalid.example: {"keyword":"Elon Musk","search_type":"Top"}
  • 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.