Social Fetch
Threads

Get Threads post

Get a single Threads post.

GET/v1/threads/posts
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
2
url*stringquery

Link to the Threads post.

min 1 chars · max 4096 chars

trimbooleanoptionalquery

When true, returns a smaller response with fewer fields.

Response fields
86

Endpoint-specific response payload.

datalookupStatus
string

Whether the post was found.

one of: found, not_found

Primary post when found.

datapostid
string

Post id.

min 1 chars

datapostshortcode
string

Public shortcode for the post.

min 1 chars

dataposturl
string

Canonical public Threads URL.

min 1 chars

datapostcaption
stringnullable

Caption text.

dataposttakenAt
integer

Unix timestamp when the post was published.

≥ 0

datapostisReply
booleanoptional

Whether this post is a reply.

datapostreplyControl
stringnullableoptional

Reply audience setting when available.

datapostunavailableReason
stringnullableoptional

Reason when content is unavailable.

Author when found.

dataauthorplatform
string

Social platform for this author.

one of: threads

dataauthorplatformUserId
stringoptional

Numeric profile id.

dataauthorhandle
string

Threads username without a leading @.

min 1 chars

dataauthordisplayName
stringnullableoptional

Display name.

dataauthoravatarUrl
stringnullableoptional

Avatar image URL.

dataauthorverified
boolean

Whether the profile is verified.

dataauthorprivateAccount
booleanoptional

Whether the account is private.

Engagement metrics for a Threads post.

datametricslikes
integernullableoptional

Like count when available.

≥ 0

datametricsviews
integernullableoptional

View count when available.

≥ 0

datametricsreplies
integernullableoptional

Direct reply count when available.

≥ 0

datametricsreposts
integernullableoptional

Repost count when available.

≥ 0

datametricsquotes
integernullableoptional

Quote count when available.

≥ 0

datametricsreshares
integernullableoptional

Reshare count when available.

≥ 0

Primary media payload for the post.

datamediamediaType
string

Normalized media kind.

one of: text, image, video, carousel, unknown

Image renditions.

datamediaimages[]url
string

Media URL.

min 1 chars

datamediaimages[]width
integernullableoptional

Width in pixels when available.

≥ 0

datamediaimages[]height
integernullableoptional

Height in pixels when available.

≥ 0

Video renditions.

datamediavideos[]url
string

Media URL.

min 1 chars

datamediavideos[]width
integernullableoptional

Width in pixels when available.

≥ 0

datamediavideos[]height
integernullableoptional

Height in pixels when available.

≥ 0

Original dimensions when available.

datamediadimensionswidth
integer

≥ 0

datamediadimensionsheight
integer

≥ 0

datamediaaccessibilityCaption
stringnullableoptional

Accessibility description when available.

Top-level replies when available.

datareplies[]id
string

Post id.

min 1 chars

datareplies[]shortcode
string

Public shortcode.

min 1 chars

datareplies[]url
string

Canonical public Threads URL.

min 1 chars

datareplies[]caption
stringnullable

Caption text.

datareplies[]takenAt
integer

Unix timestamp when published.

≥ 0

Author when known.

datareplies[]authorplatform
string

Social platform for this author.

one of: threads

datareplies[]authorplatformUserId
stringoptional

Numeric profile id.

datareplies[]authorhandle
string

Threads username without a leading @.

min 1 chars

datareplies[]authordisplayName
stringnullableoptional

Display name.

datareplies[]authoravatarUrl
stringnullableoptional

Avatar image URL.

datareplies[]authorverified
boolean

Whether the profile is verified.

datareplies[]authorprivateAccount
booleanoptional

Whether the account is private.

Engagement metrics for a Threads post.

datareplies[]metricslikes
integernullableoptional

Like count when available.

≥ 0

datareplies[]metricsviews
integernullableoptional

View count when available.

≥ 0

datareplies[]metricsreplies
integernullableoptional

Direct reply count when available.

≥ 0

datareplies[]metricsreposts
integernullableoptional

Repost count when available.

≥ 0

datareplies[]metricsquotes
integernullableoptional

Quote count when available.

≥ 0

datareplies[]metricsreshares
integernullableoptional

Reshare count when available.

≥ 0

Related posts when available.

datarelatedPosts[]id
string

Post id.

min 1 chars

datarelatedPosts[]shortcode
string

Public shortcode.

min 1 chars

datarelatedPosts[]url
string

Canonical public Threads URL.

min 1 chars

datarelatedPosts[]caption
stringnullable

Caption text.

datarelatedPosts[]takenAt
integer

Unix timestamp when published.

≥ 0

Author when known.

datarelatedPosts[]authorplatform
string

Social platform for this author.

one of: threads

datarelatedPosts[]authorplatformUserId
stringoptional

Numeric profile id.

datarelatedPosts[]authorhandle
string

Threads username without a leading @.

min 1 chars

datarelatedPosts[]authordisplayName
stringnullableoptional

Display name.

datarelatedPosts[]authoravatarUrl
stringnullableoptional

Avatar image URL.

datarelatedPosts[]authorverified
boolean

Whether the profile is verified.

datarelatedPosts[]authorprivateAccount
booleanoptional

Whether the account is private.

Engagement metrics for a Threads post.

datarelatedPosts[]metricslikes
integernullableoptional

Like count when available.

≥ 0

datarelatedPosts[]metricsviews
integernullableoptional

View count when available.

≥ 0

datarelatedPosts[]metricsreplies
integernullableoptional

Direct reply count when available.

≥ 0

datarelatedPosts[]metricsreposts
integernullableoptional

Repost count when available.

≥ 0

datarelatedPosts[]metricsquotes
integernullableoptional

Quote count when available.

≥ 0

datarelatedPosts[]metricsreshares
integernullableoptional

Reshare count when available.

≥ 0

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/threads/posts?url=https://www.threads.net/@zuck/post/DK-BydcJHkF" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Lookup result. Check `data.lookupStatus` for `found` or `not_found`.

On this page

No Headings