List Threads profile posts
Returns recent public posts for a Threads handle. For handle resolution, inspect `data.lookupStatus` (`found` vs `not_found`). An empty `data.posts` array can still accompany `lookupStatus: "found"` when the handle resolves but no posts are returned. Call `GET /v1/threads/profiles/{handle}` first if you need `private` vs `not_found` for the account itself.
Operation
/v1/threads/profiles/{handle}/postsHeaders
API key (`sfk_...`)
Parameters
Threads handle whose posts should be listed.
min 1 chars · max 64 chars
When true, returns a smaller response with fewer post fields when available.
Response fields
Endpoint-specific response payload.
Whether the handle resolved for this listing.
one of: found, not_found
Threads posts returned for this request.
Threads post identifier.
min 1 chars
Public short code used in the Threads post URL.
min 1 chars
Canonical public URL for this Threads post.
min 1 chars
Caption text when available.
When the post was published (Unix epoch seconds).
Author snapshot when available.
Social platform.
one of: threads
Threads username without a leading @.
min 1 chars
Numeric profile identifier when available.
Profile image URL when available.
Whether the profile is verified.
Whether the account is private.
Engagement metrics when available.
Like count when exposed.
≥ 0
Reply count when exposed.
≥ 0
Native repost count when exposed.
≥ 0
Share or reshare count when exposed.
≥ 0
Quote post count when exposed.
≥ 0
Media payloads when resolved.
Primary image variants when present.
Image URL.
min 1 chars
Width in pixels when available.
≥ 0
Height in pixels when available.
≥ 0
Playable video variants when present.
Video URL.
min 1 chars
Width in pixels when available.
≥ 0
Height in pixels when available.
≥ 0
Media type label when exposed.
min 1 chars
Carousel media items when present.
Images in this carousel cell when present.
Image URL.
min 1 chars
Width in pixels when available.
≥ 0
Height in pixels when available.
≥ 0
Videos in this carousel cell when present.
Video URL.
min 1 chars
Width in pixels when available.
≥ 0
Height in pixels when available.
≥ 0
Media type label when exposed.
min 1 chars
Whether the post is pinned on the profile when known.
Whether this post is a reply when known.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Posts for the requested profile. Use `data.lookupStatus`: `not_found` when the handle cannot be resolved; `found` when the handle resolves (check `data.posts`—it may be empty).
Error codes