List Threads profile posts
List posts from a Threads profile by handle.
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 (ISO-8601).
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
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
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.