# 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.

**Job:** [Get X (Twitter) posts and profiles](https://scrollport.com/tools/x-api)

**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

`cursor` string · optional

Cursor

minLength: 1 · maxLength: 4096

`keyword` string · required

Search Keyword

minLength: 1 · maxLength: 500

`search_type` string · optional

Search Type

minLength: 1 · maxLength: 500

### 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.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.

---

Canonical page: https://scrollport.com/tools/providers/tikhub/twitter-web-fetch-search-timeline