scrollport

Post Search

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

by XReady to run$0.0500 per request · $5.00 per 100 requests

Example

You ask your agent

“Find English posts about AI agents on X from the first week of July 2026.”

You get

URL
https://x.com/public_author/status/1950589874029756544
Text
A public post about AI agents.
Language
en
Published at
2026-07-03 12:00 UTC
Author URL
https://x.com/public_author
Username
public_author
Verified
No
Likes
31
What your agent sends and gets back (JSON)

Your agent works out the exact inputs, such as IDs, dates and settings, from what you ask.

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

Response

{
  "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
}

Use it with your agent

Copy the prompt and paste it into your agent, then 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.

Provider access is included. If your agent isn't connected to Scrollport yet, it will help you set that up.

Other tools for this job

Compare all 14 →

Questions

Is Post Search by X free?

Scrollport has no free tier: it costs $0.0500 per request ($5.00 per 100 requests), paid per use from a prepaid wallet with no subscription. Connecting your first agent adds $1 of trial credit, so you can try it before adding funds.

Do I need an API key from X?

No. Your agent runs it through your Scrollport connection (MCP, the Scrollport CLI or the HTTP API), and Scrollport handles access to X, so you don't sign up with X or manage an API key.

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.

All inputs and outputs

Input

cursorstring · optional

Pagination cursor from a previous response; omit it for the first page.

minLength: 1 · maxLength: 2048

limitinteger · optional

Maximum number of results to return.

minimum: 1 · maximum: 100

max_pagesinteger · optional

Maximum number of result pages to request.

minimum: 1 · maximum: 5

modestring · optional

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

When the data was retrieved.

duplicate_itemsnumber

Number of duplicate items removed.

has_next_pageboolean
itemsarray

Result records.

next_cursorstring

Cursor to pass for the next page; absent when there are no more results.

omitted_itemsnumber

Number of items left out of the response.

pages_fetchednumber
pagination_stoppednull
Errors and limits
  • 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}