# Post Search

X

Search public X posts with bounded query, mode, time and pagination controls.

## 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 Post Search (tool ID: x.post-search). 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.0500/request

**Availability:** Ready to run

## Tool details

**About this tool**

Return at most 100 deduplicated public X posts across at most five direct advanced-search pages, with stable string IDs, canonical URLs, timestamps, authors, entities, metrics, verification, withheld/unavailable state and one-level quoted or reposted context. Each completed supplier page is one billable request covering up to 20 posts, including an empty page. The quote reserves the requested page count; only completed pages are charged. Optional ISO time bounds are translated to supported Unix since_time and until_time operators. This read-only contract accepts no X login, cookies or action credentials.

**Inputs and outputs**

### Input

`cursor` string · optional

Value supplied for cursor.

minLength: 1 · maxLength: 2048

`limit` integer · optional

Value supplied for limit.

minimum: 1 · maximum: 100

`max_pages` integer · optional

Maximum number of result pages to request.

minimum: 1 · maximum: 5

`mode` string · optional

Value supplied for mode.

enum: Latest, Top

`query` string · required

X advanced-search query without since, until, since_time or until_time operators.

minLength: 1 · maxLength: 200

`since` string · optional

Inclusive start; requires until.

format: date-time

`until` string · optional

Exclusive end; requires since and a window of at most 31 days.

format: date-time

### Output

`captured_at` string

Returned captured at value.

`duplicate_items` number

Returned duplicate items value.

`has_next_page` boolean

Returned has next page value.

`items` array

Returned items value.

`next_cursor` string

Returned next cursor value.

`omitted_items` number

Returned omitted items value.

`pages_fetched` number

Returned pages fetched value.

`pagination_stopped` null

Returned pagination stopped 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": "x.post-search",
  "input": {
    "mode": "Latest",
    "limit": 20,
    "query": "AI agents lang:en",
    "since": "2026-07-01T00:00:00.000Z",
    "until": "2026-07-08T00:00:00.000Z",
    "max_pages": 1
  }
}
```

### Output

```
{
  "items": [
    {
      "id": "1950589874029756544",
      "url": "https://x.com/public_author/status/1950589874029756544",
      "text": "A public post about AI agents.",
      "author": {
        "id": "1659345642511212544",
        "url": "https://x.com/public_author",
        "username": "public_author",
        "verified": false
      },
      "metrics": {
        "likes": 31,
        "views": 2400,
        "quotes": 1,
        "replies": 2,
        "reposts": 4,
        "bookmarks": 3
      },
      "language": "en",
      "published_at": "2026-07-03T12:00:00.000Z"
    }
  ],
  "captured_at": "2026-08-20T00:00:00.000Z",
  "next_cursor": "opaque-next",
  "has_next_page": true,
  "omitted_items": 0,
  "pages_fetched": 1,
  "duplicate_items": 0,
  "pagination_stopped": null
}
```

**Errors and limitations**

- `invalid_input`: The search input was invalid or outside its time, page or result bounds.example: {"mode":"Latest","limit":20,"query":"AI agents lang:en","since":"2026-07-01T00:00:00.000Z","until":"2026-07-08T00:00:00.000Z","max_pages":1}

---

Canonical page: https://scrollport.com/tools/providers/x/post-search