User posts
A user's latest posts: the ones their profile shows logged out. There is no next page.
GET/v1/threads/profiles/posts1 creditHeaders
Get your API keyx-api-key*stringrequiredheaderYour API key, made in the dashboard.
Parameters
2handlestringoptionalqueryA Threads handle, with or without the @. Give handle or url.
example: zuck
urlstringoptionalqueryA profile's link: threads.com/@<handle>, with anything after it. Give handle or url.
max 300 chars
Response fields
36dataarrayThe result: one object, or a list for the endpoints that return several.
data[].idstringThreads' id for the post.
data[].urlstringThe post's link.
data[].codestringThe post's code: the part after /post/ in its link.
data[].textstringnullableWhat it says.
data[].authorstringnullableIts author's username.
data[].author_idstringnullableIts author's id.
data[].author_namestringnullableIts author's display name.
data[].author_picturestringnullableIts author's profile picture. The link is signed, and expires after a while.
data[].author_verifiedbooleannullableWhether its author is verified.
data[].is_replybooleannullableWhether it replies to another post.
data[].reply_tostringnullableThe username of the post's author it replies to.
data[].pinnedbooleannullableWhether it is pinned to its author's profile.
data[].scoreintegernullableLikes.
data[].comment_countintegernullableDirect replies.
data[].repost_countintegernullableReposts.
data[].quote_countintegernullableQuotes.
data[].reshare_countintegernullableShares.
data[].media_typestringnullableWhat it holds: text, image, video, carousel (several images or videos) or other.
data[].mediaarraynullableIts images and videos, in order.
data[].media[].typestringnullableimage or video; other for a kind Threads adds later.
data[].media[].urlstringThe file's link. It is signed, and expires after a while.
data[].media[].widthintegernullableIts width, in pixels.
data[].media[].heightintegernullableIts height, in pixels.
data[].created_atstringnullableWhen it was posted.
format: date-time
pageobjectnullablePaging, for the endpoints that page; null for the others.
page.next_cursorstringnullableSend it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.
page.has_morebooleanoptionalWhether another page follows.
default: false
metaobjectAbout this call.
meta.platformstringThe platform: reddit, threads, tiktok or youtube.
meta.endpointstringThe endpoint's name, such as channel_videos.
meta.paramsobjectThe call's parameters, defaults included. Parameters without a value, and the cursor, are left out.
meta.request_idstringThis call's id. Quote it when you report a problem.
meta.api_versionstringThe API version that answered.
meta.fetched_atstringWhen the data was fetched from the platform (UTC).
format: date-time
meta.cachedbooleanoptionalWhether 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/profiles/posts?handle=zuck' \ -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" } ], "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 }}