scrollport
Back to Twitter post research

Post Search

X

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

Capability
Twitter post research
Current price
$0.0003/result
Availability
Ready to run
Last accepted verification

What this API does

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. TwitterAPI.io returns up to 20 supplier-billed posts per page; limit caps Scrollport output but cannot shrink that provider page, so one page can settle up to $0.0042 at the listed $0.000210 per post. 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.

Agents select this operation with tool ID x.post-search, then inspect its current executable contract before a run.

Public input and output shape

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

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

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
}
Teaching 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}
Updated
21 August 2026

Use Post Search with Scrollport

Use Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.