List Threads profile posts
Get posts from a specific Threads profile.
Call `GET /v1/threads/profiles/{handle}` when you must distinguish `private` from `not_found` before interpreting an empty post list.
An empty `data.posts` array can occur with `lookupStatus: "found"` (no posts in this response) or `lookupStatus: "not_found"` (handle did not resolve).
Headers
Get your API keyAPI key (`sfk_...`)
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.
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
curl "https://api.socialfetch.dev/v1/threads/profiles/charlidamelio/posts" \
-H "x-api-key: YOUR_API_KEY"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).