Returns public metadata for a single Threads post. Whether the post was found is indicated in `data.lookupStatus`.
GET /v1/threads/posts
Headers x-api-key string required (header)
API key (`sfk_...`)
Parameters url string required (query)
Link to the Threads post.
min 1 chars · max 4096 chars
trim boolean (query)
When true, returns a smaller response with fewer fields.
Response fields Endpoint-specific response payload.
data . lookupStatus
string required
Whether the post was found.
one of: found, not_found
data . post
object required nullable
Primary post when found.
data . post . id
string required
Post id.
min 1 chars
data . post . shortcode
string required
Public shortcode for the post.
min 1 chars
data . post . url
string required
Canonical public Threads URL.
min 1 chars
data . post . caption
string required nullable
Caption text.
data . post . takenAt
integer required
Unix timestamp when the post was published.
≥ 0
Whether this post is a reply.
data . post . replyControl
string nullable
Reply audience setting when available.
data . post . unavailableReason
string nullable
Reason when content is unavailable.
data . author
object required nullable
Author when found.
data . author . platform
string required
Social platform for this author.
one of: threads
data . author . platformUserId
string
Numeric profile id.
data . author . handle
string required
Threads username without a leading @.
min 1 chars
data . author . displayName
string nullable
Display name.
data . author . avatarUrl
string nullable
Avatar image URL.
data . author . verified
boolean required
Whether the profile is verified.
data . author . privateAccount
boolean
Whether the account is private.
data . metrics
object required nullable
Engagement metrics for a Threads post.
data . metrics . likes
integer nullable
Like count when available.
≥ 0
data . metrics . views
integer nullable
View count when available.
≥ 0
data . metrics . replies
integer nullable
Direct reply count when available.
≥ 0
data . metrics . reposts
integer nullable
Repost count when available.
≥ 0
data . metrics . quotes
integer nullable
Quote count when available.
≥ 0
data . metrics . reshares
integer nullable
Reshare count when available.
≥ 0
data . media
object required nullable
Primary media payload for the post.
data . media . mediaType
string required
Normalized media kind.
one of: text, image, video, carousel, unknown
data . media . images
array required
Image renditions.
data . media . images [] . url
string required
Media URL.
min 1 chars
data . media . images [] . width
integer nullable
Width in pixels when available.
≥ 0
data . media . images [] . height
integer nullable
Height in pixels when available.
≥ 0
data . media . videos
array required
Video renditions.
data . media . videos [] . url
string required
Media URL.
min 1 chars
data . media . videos [] . width
integer nullable
Width in pixels when available.
≥ 0
data . media . videos [] . height
integer nullable
Height in pixels when available.
≥ 0
data . media . dimensions
object
Original dimensions when available.
data . media . dimensions . width
integer required
≥ 0
data . media . dimensions . height
integer required
≥ 0
data . media . accessibilityCaption
string nullable
Accessibility description when available.
data . replies
array required
Top-level replies when available.
data . replies [] . id
string required
Post id.
min 1 chars
data . replies [] . shortcode
string required
Public shortcode.
min 1 chars
data . replies [] . url
string required
Canonical public Threads URL.
min 1 chars
data . replies [] . caption
string required nullable
Caption text.
data . replies [] . takenAt
integer required
Unix timestamp when published.
≥ 0
data . replies [] . author
object required nullable
Author when known.
data . replies [] . author . platform
string required
Social platform for this author.
one of: threads
data . replies [] . author . platformUserId
string
Numeric profile id.
data . replies [] . author . handle
string required
Threads username without a leading @.
min 1 chars
data . replies [] . author . displayName
string nullable
Display name.
data . replies [] . author . avatarUrl
string nullable
Avatar image URL.
data . replies [] . author . verified
boolean required
Whether the profile is verified.
data . replies [] . author . privateAccount
boolean
Whether the account is private.
data . replies [] . metrics
object required nullable
Engagement metrics for a Threads post.
data . replies [] . metrics . likes
integer nullable
Like count when available.
≥ 0
data . replies [] . metrics . views
integer nullable
View count when available.
≥ 0
data . replies [] . metrics . replies
integer nullable
Direct reply count when available.
≥ 0
data . replies [] . metrics . reposts
integer nullable
Repost count when available.
≥ 0
data . replies [] . metrics . quotes
integer nullable
Quote count when available.
≥ 0
data . replies [] . metrics . reshares
integer nullable
Reshare count when available.
≥ 0
data . relatedPosts
array required
Related posts when available.
data . relatedPosts [] . id
string required
Post id.
min 1 chars
data . relatedPosts [] . shortcode
string required
Public shortcode.
min 1 chars
data . relatedPosts [] . url
string required
Canonical public Threads URL.
min 1 chars
data . relatedPosts [] . caption
string required nullable
Caption text.
data . relatedPosts [] . takenAt
integer required
Unix timestamp when published.
≥ 0
data . relatedPosts [] . author
object required nullable
Author when known.
data . relatedPosts [] . author . platform
string required
Social platform for this author.
one of: threads
data . relatedPosts [] . author . platformUserId
string
Numeric profile id.
data . relatedPosts [] . author . handle
string required
Threads username without a leading @.
min 1 chars
data . relatedPosts [] . author . displayName
string nullable
Display name.
data . relatedPosts [] . author . avatarUrl
string nullable
Avatar image URL.
data . relatedPosts [] . author . verified
boolean required
Whether the profile is verified.
data . relatedPosts [] . author . privateAccount
boolean
Whether the account is private.
data . relatedPosts [] . metrics
object required nullable
Engagement metrics for a Threads post.
data . relatedPosts [] . metrics . likes
integer nullable
Like count when available.
≥ 0
data . relatedPosts [] . metrics . views
integer nullable
View count when available.
≥ 0
data . relatedPosts [] . metrics . replies
integer nullable
Direct reply count when available.
≥ 0
data . relatedPosts [] . metrics . reposts
integer nullable
Repost count when available.
≥ 0
data . relatedPosts [] . metrics . quotes
integer nullable
Quote count when available.
≥ 0
data . relatedPosts [] . metrics . reshares
integer nullable
Reshare count when available.
≥ 0
Metadata describing the request and billing outcome.
meta . requestId
string required
Unique request identifier for tracing this API call.
min 1 chars
meta . creditsCharged
integer required
Credits charged for this request.
≥ 0
meta . version
string required
Public API version that served the response.
one of: v1
Code example cURL Node.js TypeScript SDK Python Go Java
Responses 200 400 401 402 500 502 503
Lookup result. Check `data.lookupStatus` for `found` or `not_found`.
Error codes
bad_request insufficient_credits internal_error lookup_failed temporarily_unavailable unauthorized