honesthook

threads-api/posts

Threads posts API — recent posts, no pagination

Recent posts from the profile itself, read from the same kind of document as threads/profile.

Parameters

NameWhat it is
handleThe Threads handle, without the @.

Handle format and anchor

What this endpoint does not return.

A field we cannot read comes back null, never 0. A zero would be a claim about the account; null is a fact about our collection.

Where this goes wrong.

No pagination and no limit parameter. It returns whatever came in the page — measured across three handles: 4, 5 and 10 posts. That is not the account's post count.

Measured

The document is downloaded AGAIN: the cache is keyed by endpoint plus params, so calling both routes for the same handle fetches twice. Measured 2026-09-15: 1.55s after profile against 1.60s without it, cached:false on both.

Cost

1 credit per call. A call that finds nothing costs nothing.

Does calling profile first make posts cheaper or faster?

No. The cache is keyed by endpoint plus params, so the document is fetched twice. Measured: 1.55s against 1.60s.

Can I ask for 50 posts?

No. There is no limit parameter and no pagination. You get what came in the page — 4, 5 and 10 across three measured handles.

Why is quotes null here but filled on Bluesky and Mastodon?

Because Threads does not publish a quote count. The field keeps its place in the shape and stays null.

Other routes for this platform

← threads-api