All questionsX (Twitter)

Can I get X (Twitter) posts by date range?

Partly. The profile posts endpoint accepts since, an RFC 3339 timestamp, and stops paging once posts are older than it. That gives you "everything after a date" in one loop without paying for older pages. There is no until. For an end date, skip posts whose createdAt is past it.

Search has no date filter at all. It returns what X ranks for the query now. For a search bounded by time, run it on a schedule and keep the results. Your store becomes the range.

Checked September 2026 · request and response run against the API · no affiliate links

Get started for $0 Quickstart

GET /v1/twitter/profiles/@handle/posts?since=…

curl "https://api.openhandle.dev/v1/twitter/profiles/@copperfield_lab_x_test/posts?since=2026-08-01T00:00:00Z" \
  -H "Authorization: Bearer $OPENHANDLE_API_KEY"

TypeScript SDK

import { OpenHandle } from '@openhandle/sdk';

const openhandle = new OpenHandle({ apiKey: process.env.OPENHANDLE_API_KEY! });
const start = '2026-08-01T00:00:00Z';
const end = new Date('2026-09-01T00:00:00Z');

let page = await openhandle.twitter.profile('copperfield_lab_x_test').posts.list({ since: start });
while (page) {
    for (const post of page.data) {
        if (new Date(post.createdAt) < end) console.log(post.createdAt, post.text);
    }
    page = await page.next();
}

200 OK

{
  "platform": "twitter",
  "resource": "post",
  "capturedAt": "2026-09-18T12:34:55Z",
  "source": "live",
  "data": [
    {
      "id": "940100000000000001",
      "text": "A deterministic text post from a fictional lab. #synthetic",
      "createdAt": "2026-08-09T15:30:00Z",
      "metrics": { "likes": 42, "reposts": 3, "comments": 3 }
    }
  ],
  "meta": { "cursors": { "next": null } }
}

Trimmed to one post. The cursor is null because every remaining post is older than `since`. The example is a Test account.

What since does

—Stops paging. Once a page contains posts older than since, the cursor turns null. You do not pay for pages you would discard.
—Newest first. Feeds are ordered newest first. The first page is the most recent, the last page ends at your start date.
—Works on every post feed. Profile posts, replies, and media on X, and profile posts on Instagram, TikTok, and Reddit.

What since does not do

—No end date. Filter createdAt on your side. A pinned post can appear at the top with an old date. Compare dates, do not assume order.
—No search filter. Search returns what X ranks now. from:handle and keywords narrow it. Dates do not.
—No archive. X decides how far back a public timeline goes. since cannot reach past that.

Build the range yourself

Poll the feeds you care about with since set to the last capturedAt you stored. Every run appends only new posts. After a month you have a month. After a year you have a year, with the exact numbers each post showed on the day you read it.

When this does not work

These answers are definitive. Store them, do not retry them.

Situation	Status	Code
The account is protected	403	PROFILE_PRIVATE
The account is suspended, deleted, or never existed	404	PROFILE_NOT_FOUND
The since value is not an RFC 3339 timestamp	400	INVALID_SINCE

400 Bad Request

{
  "error": {
    "code": "INVALID_SINCE",
    "message": "The since value is invalid.",
    "requestId": "req_01j8…",
    "retryable": false
  }
}

Validation errors are never billed. Send timestamps in UTC with the Z suffix.

More X (Twitter) questions

X (Twitter)Is the X (Twitter) API free to read posts?No. The free tier of the X API can post but not read. Reading needs a paid monthly tier with a post cap. For public posts, profiles, and search, a per-request public data API costs a fraction.Read the answer X (Twitter)How do I search X (Twitter) posts by keyword?Call the search endpoint with a query. Latest or top posts come back one page at a time with author, text, and metrics. No monthly X API plan.Read the answer X (Twitter)How do I get replies or a full thread on X (Twitter)?Call the post comments endpoint with the post ID. Replies come back one page at a time with author, text, and metrics. Nested replies have their own endpoint. Cursors keep working.Read the answer

Send your agent ahead.

Paste the prompt into your agent and it sets everything up. Or come yourself, it takes five minutes.

For agents

Get started for $0 Read the quickstart