Social Parse
PricingDashboard
Threads

Post

A post, with its replies, its author's follow-up posts in the thread, and the posts Threads shows with it.

GET/v1/threads/posts1 credit

Headers

Get your API key
x-api-key*stringrequiredheader

Your API key, made in the dashboard.

Parameters

2
codestringoptionalquery

A post's code: the part after /post/ in its link. Give code or url.

example: DeZtp-TkQHh

urlstringoptionalquery

A post's link: threads.com/@<handle>/post/<code>. Give code or url.

max 300 chars

Response fields

112
dataobject

The result: one object, or a list for the endpoints that return several.

data.idstring

Threads' id for the post.

data.urlstring

The post's link.

data.codestring

The post's code: the part after /post/ in its link.

data.textstringnullable

What it says.

data.authorstringnullable

Its author's username.

data.author_idstringnullable

Its author's id.

data.author_namestringnullable

Its author's display name.

data.author_picturestringnullable

Its author's profile picture. The link is signed, and expires after a while.

data.author_verifiedbooleannullable

Whether its author is verified.

data.is_replybooleannullable

Whether it replies to another post.

data.reply_tostringnullable

The username of the post's author it replies to.

data.pinnedbooleannullable

Whether it is pinned to its author's profile.

data.scoreintegernullable

Likes.

data.comment_countintegernullable

Direct replies.

data.repost_countintegernullable

Reposts.

data.quote_countintegernullable

Quotes.

data.reshare_countintegernullable

Shares.

data.media_typestringnullable

What it holds: text, image, video, carousel (several images or videos) or other.

data.mediaarraynullable

Its images and videos, in order.

data.media[].typestringnullable

image or video; other for a kind Threads adds later.

data.media[].urlstring

The file's link. It is signed, and expires after a while.

data.media[].widthintegernullable

Its width, in pixels.

data.media[].heightintegernullable

Its height, in pixels.

data.created_atstringnullable

When it was posted.

format: date-time

data.viewsintegernullable

Views, where Threads shows them.

data.repliesarray

The direct replies its page shows.

data.replies[].idstring

Threads' id for the post.

data.replies[].urlstring

The post's link.

data.replies[].codestring

The post's code: the part after /post/ in its link.

data.replies[].textstringnullable

What it says.

data.replies[].authorstringnullable

Its author's username.

data.replies[].author_idstringnullable

Its author's id.

data.replies[].author_namestringnullable

Its author's display name.

data.replies[].author_picturestringnullable

Its author's profile picture. The link is signed, and expires after a while.

data.replies[].author_verifiedbooleannullable

Whether its author is verified.

data.replies[].is_replybooleannullable

Whether it replies to another post.

data.replies[].reply_tostringnullable

The username of the post's author it replies to.

data.replies[].pinnedbooleannullable

Whether it is pinned to its author's profile.

data.replies[].scoreintegernullable

Likes.

data.replies[].comment_countintegernullable

Direct replies.

data.replies[].repost_countintegernullable

Reposts.

data.replies[].quote_countintegernullable

Quotes.

data.replies[].reshare_countintegernullable

Shares.

data.replies[].media_typestringnullable

What it holds: text, image, video, carousel (several images or videos) or other.

data.replies[].mediaarraynullable

Its images and videos, in order.

data.replies[].media[].typestringnullable

image or video; other for a kind Threads adds later.

data.replies[].media[].urlstring

The file's link. It is signed, and expires after a while.

data.replies[].media[].widthintegernullable

Its width, in pixels.

data.replies[].media[].heightintegernullable

Its height, in pixels.

data.replies[].created_atstringnullable

When it was posted.

format: date-time

data.threadarray

Its author's own follow-up posts in the thread.

data.thread[].idstring

Threads' id for the post.

data.thread[].urlstring

The post's link.

data.thread[].codestring

The post's code: the part after /post/ in its link.

data.thread[].textstringnullable

What it says.

data.thread[].authorstringnullable

Its author's username.

data.thread[].author_idstringnullable

Its author's id.

data.thread[].author_namestringnullable

Its author's display name.

data.thread[].author_picturestringnullable

Its author's profile picture. The link is signed, and expires after a while.

data.thread[].author_verifiedbooleannullable

Whether its author is verified.

data.thread[].is_replybooleannullable

Whether it replies to another post.

data.thread[].reply_tostringnullable

The username of the post's author it replies to.

data.thread[].pinnedbooleannullable

Whether it is pinned to its author's profile.

data.thread[].scoreintegernullable

Likes.

data.thread[].comment_countintegernullable

Direct replies.

data.thread[].repost_countintegernullable

Reposts.

data.thread[].quote_countintegernullable

Quotes.

data.thread[].reshare_countintegernullable

Shares.

data.thread[].media_typestringnullable

What it holds: text, image, video, carousel (several images or videos) or other.

data.thread[].mediaarraynullable

Its images and videos, in order.

data.thread[].media[].typestringnullable

image or video; other for a kind Threads adds later.

data.thread[].media[].urlstring

The file's link. It is signed, and expires after a while.

data.thread[].media[].widthintegernullable

Its width, in pixels.

data.thread[].media[].heightintegernullable

Its height, in pixels.

data.thread[].created_atstringnullable

When it was posted.

format: date-time

data.relatedarray

Other posts Threads shows with it.

data.related[].idstring

Threads' id for the post.

data.related[].urlstring

The post's link.

data.related[].codestring

The post's code: the part after /post/ in its link.

data.related[].textstringnullable

What it says.

data.related[].authorstringnullable

Its author's username.

data.related[].author_idstringnullable

Its author's id.

data.related[].author_namestringnullable

Its author's display name.

data.related[].author_picturestringnullable

Its author's profile picture. The link is signed, and expires after a while.

data.related[].author_verifiedbooleannullable

Whether its author is verified.

data.related[].is_replybooleannullable

Whether it replies to another post.

data.related[].reply_tostringnullable

The username of the post's author it replies to.

data.related[].pinnedbooleannullable

Whether it is pinned to its author's profile.

data.related[].scoreintegernullable

Likes.

data.related[].comment_countintegernullable

Direct replies.

data.related[].repost_countintegernullable

Reposts.

data.related[].quote_countintegernullable

Quotes.

data.related[].reshare_countintegernullable

Shares.

data.related[].media_typestringnullable

What it holds: text, image, video, carousel (several images or videos) or other.

data.related[].mediaarraynullable

Its images and videos, in order.

data.related[].media[].typestringnullable

image or video; other for a kind Threads adds later.

data.related[].media[].urlstring

The file's link. It is signed, and expires after a while.

data.related[].media[].widthintegernullable

Its width, in pixels.

data.related[].media[].heightintegernullable

Its height, in pixels.

data.related[].created_atstringnullable

When it was posted.

format: date-time

pageobjectnullable

Paging, for the endpoints that page; null for the others.

page.next_cursorstringnullable

Send it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.

page.has_morebooleanoptional

Whether another page follows.

default: false

metaobject

About this call.

meta.platformstring

The platform: reddit, threads, tiktok or youtube.

meta.endpointstring

The endpoint's name, such as channel_videos.

meta.paramsobject

The call's parameters, defaults included. Parameters without a value, and the cursor, are left out.

meta.request_idstring

This call's id. Quote it when you report a problem.

meta.api_versionstring

The API version that answered.

meta.fetched_atstring

When the data was fetched from the platform (UTC).

format: date-time

meta.cachedbooleanoptional

Whether it came from our cache; fetched_at says how old it is.

default: false

Code example

curl -X GET 'https://api.socialparse.dev/v1/threads/posts?code=DeZtp-TkQHh' \  -H 'x-api-key: YOUR_API_KEY'

Responses

Successful Response

{  "data": {    "id": "string",    "url": "string",    "code": "string",    "text": "string",    "author": "string",    "author_id": "string",    "author_name": "string",    "author_picture": "string",    "author_verified": true,    "is_reply": true,    "reply_to": "string",    "pinned": true,    "score": 0,    "comment_count": 0,    "repost_count": 0,    "quote_count": 0,    "reshare_count": 0,    "media_type": "string",    "media": [      {        "type": "string",        "url": "string",        "width": 0,        "height": 0      }    ],    "created_at": "2019-08-24T14:15:22Z",    "views": 0,    "replies": [      {        "id": "string",        "url": "string",        "code": "string",        "text": "string",        "author": "string",        "author_id": "string",        "author_name": "string",        "author_picture": "string",        "author_verified": true,        "is_reply": true,        "reply_to": "string",        "pinned": true,        "score": 0,        "comment_count": 0,        "repost_count": 0,        "quote_count": 0,        "reshare_count": 0,        "media_type": "string",        "media": [          {            "type": "string",            "url": "string",            "width": 0,            "height": 0          }        ],        "created_at": "2019-08-24T14:15:22Z"      }    ],    "thread": [      {        "id": "string",        "url": "string",        "code": "string",        "text": "string",        "author": "string",        "author_id": "string",        "author_name": "string",        "author_picture": "string",        "author_verified": true,        "is_reply": true,        "reply_to": "string",        "pinned": true,        "score": 0,        "comment_count": 0,        "repost_count": 0,        "quote_count": 0,        "reshare_count": 0,        "media_type": "string",        "media": [          {            "type": "string",            "url": "string",            "width": 0,            "height": 0          }        ],        "created_at": "2019-08-24T14:15:22Z"      }    ],    "related": [      {        "id": "string",        "url": "string",        "code": "string",        "text": "string",        "author": "string",        "author_id": "string",        "author_name": "string",        "author_picture": "string",        "author_verified": true,        "is_reply": true,        "reply_to": "string",        "pinned": true,        "score": 0,        "comment_count": 0,        "repost_count": 0,        "quote_count": 0,        "reshare_count": 0,        "media_type": "string",        "media": [          {            "type": "string",            "url": "string",            "width": 0,            "height": 0          }        ],        "created_at": "2019-08-24T14:15:22Z"      }    ]  },  "page": {    "next_cursor": "string",    "has_more": false  },  "meta": {    "platform": "string",    "endpoint": "string",    "params": {      "property1": "string",      "property2": "string"    },    "request_id": "string",    "api_version": "string",    "fetched_at": "2019-08-24T14:15:22Z",    "cached": false  }}

User posts

A user's latest posts: the ones their profile shows logged out. There is no next page.

Search

Posts that match a search: Threads' top results. There is no next page.