Post Search

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

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

cursorstring · optional

Value supplied for cursor.

minLength: 1 · maxLength: 2048

limitinteger · optional

Value supplied for limit.

minimum: 1 · maximum: 100

max_pagesinteger · optional

Maximum number of result pages to request.

minimum: 1 · maximum: 5

modestring · optional

Value supplied for mode.

enum: Latest, Top

querystring · required

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

minLength: 1 · maxLength: 200

sincestring · optional

Inclusive start; requires until.

format: date-time

untilstring · optional

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

format: date-time

Output

captured_atstring

Returned captured at value.

duplicate_itemsnumber

Returned duplicate items value.

has_next_pageboolean

Returned has next page value.

itemsarray

Returned items value.

next_cursorstring

Returned next cursor value.

omitted_itemsnumber

Returned omitted items value.

pages_fetchednumber

Returned pages fetched value.

pagination_stoppednull

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}