User Posts
GET/v1/threads/user/posts1 credit
Returns an account's most recent Threads posts with text, media, like, reply, repost and quote counts, and a link to each post.
01Query parameters
| Name | Type | Description |
|---|---|---|
| handlerequired | string | Threads username, with or without the leading `@` (e.g. `zuck`). |
| trimoptional | boolean | `true` returns a slimmer item with only `id`, `pk`, `caption`, `code`, `like_count`, `taken_at`, `user` and `url`.Default: false |
02Request
curl "https://api.scrapesocial.ai/v1/threads/user/posts?handle=mosseri" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Responses
Real answers from the API. Lists are shortened to 2 items.
GET /v1/threads/user/posts?handle=mosseri
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"posts": [
{
"id": "4014618741857699006_63482099442",
"pk": "4014618741857699006",
"user": {
"friendship_status": null,
"pk": "63482099442",
"profile_pic_url": "https://scontent.cdninstagram.com/v/t51.82787-19/652081753_17949596661115443_3143547630500927369_n.jpg?stp=dst-jpg_s206x206_tt6&_nc_cat=111&ccb=7-5&_nc_sid=30ff31&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy42NzguQzMifQ%3D%3D&_nc_ohc=wlK8d3fTC_sQ7kNvwGGj9KZ&_nc_oc=Adp1Q2T_nEZvbm81E6PG9RrUrGwVxlVqjsKZEU7oecRD8FaTaVwnTVCC2vHnh3XiiDfd2HobRSAyEQr_bkbwKTmK&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_…",
"username": "mosseri",
"id": "63482099442",
"transparency_label": null,
"transparency_product": null,
"transparency_product_enabled": false,
"is_verified": true,
"text_post_app_is_private": false,
"has_onboarded_to_text_post_app": true
},
"text_post_app_info": {
"show_header_follow": false,
"is_markup": false,
"custom_feed_preview_info": null,
"link_preview_attachment": null,
"linked_inline_media": null,
"special_effects_enabled_str": "",
"text_fragments": {
"fragments": [
{
"fragment_type": "plaintext",
"link_fragment": null,
"mention_fragment": null,
"plaintext": "I was so excited when Emily Bode agreed to design the ring this year. Rings is a small way we look to celebrate some of the most creative people on Instagram. It’s the second year we’ve done this, and it feels good, particularly in the midst of all of this AI mania, to be giving people a small beautiful physical token, in addition to other things, to celebrate their achievements.",
"inline_sticker_fragment": null,
"linkified_web_url": null,
"linkified_in_app_url": null,
"styling_info": null
}
]
},
"reshare_count": 16,
"direct_reply_count": 89,
"repost_count": 57,
"quote_count": 2,
"share_info": {
"quoted_attachment_author_attribution_allowed": true,
"quoted_attachment_post_unavailable": false,
"quoted_attachment_post": null,
"quoted_post": null,
"reposted_post": null
},
"reply_to_author": null,
"reply_control": "everyone",
"private_reply_partner": null,
"self_thread_count": 0,
"tag_header": null,
"root_post_author": null,
"pinned_post_info": {
"is_pinned_to_parent_post": false,
"is_pinned_to_profile": false
},
"related_trends_info": null,
"is_reply": false,
"is_post_unavailable": false,
"post_unavailable_reason": null,
"hush_info": null
},
"is_paid_partnership": null,
"audio": null,
"caption": {
"text": "I was so excited when Emily Bode agreed to design the ring this year. Rings is a small way we look to celebrate some of the most creative people on Instagram. It’s the second year we’ve done this, and it feels good, particularly in the midst of all of this AI mania, to be giving people a small beautiful physical token, in addition to other things, to celebrate their achievements.",
"has_translation": null,
"pk": "18101842106366643",
"text_translation": null
},
"caption_is_edited": false,
"transcription_data": null,
"carousel_media": [
{
"text_post_app_info": {
"tappable_elements": [],
"id": "XDTTextPostAppMediaInfo:18033922145901297",
"share_info": {
"quoted_post": null
},
"ultra_carousel_card_type": null
},
"accessibility_caption": null,
"giphy_media_info": null,
"has_audio": null,
"is_dash_eligible": null,
"video_dash_manifest": null,
"image_versions2": {
"candidates": [
{
"url": "https://instagram.fdiy2-1.fna.fbcdn.net/v/t51.82787-15/860018369_17990212284115443_1766906274600589800_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=101&_nc_map=urlgen_bucketless&ig_cache_key=NDAxNDYxODczMzY3ODc3MDc0Mw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTIwNS5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=FQvHFaz5LSMQ7kNvwElMDzG&_nc_oc=AdqpygGnBMm_34YGeNmUemYncG0…",
"height": 2077,
"width": 1205
},
{
"url": "https://instagram.fdiy2-1.fna.fbcdn.net/v/t51.82787-15/860018369_17990212284115443_1766906274600589800_n.jpg?stp=dst-jpg_e35_p1080x1080_tt6&_nc_cat=101&_nc_map=urlgen_bucketless&ig_cache_key=NDAxNDYxODczMzY3ODc3MDc0Mw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTIwNS5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=FQvHFaz5LSMQ7kNvwElMDzG&_nc_oc=AdqpygGnBMm_34YG…",
"height": 1862,
"width": 1080
}
]
},
"media_type": 1,
"original_height": 2077,
"original_width": 1205,
"pk": "4014618733678770743",
"video_versions": null,
"usertags": null,
"id": "4014618733678770743_63482099442",
"number_of_qualities": null,
"code": "De2ynfJjTo3",
"text_app_music_info": null,
"fbid": "18033922145901297",
"user": {
"pk": "63482099442",
"id": "63482099442"
}
},
{
"text_post_app_info": {
"tappable_elements": [],
"id": "XDTTextPostAppMediaInfo:17883057546628142",
"share_info": {
"quoted_post": null
},
"ultra_carousel_card_type": null
},
"accessibility_caption": null,
"giphy_media_info": null,
"has_audio": null,
"is_dash_eligible": null,
"video_dash_manifest": null,
"image_versions2": {
"candidates": [
{
"url": "https://instagram.fdiy2-1.fna.fbcdn.net/v/t51.82787-15/864655138_17990212416115443_8040082000059729905_n.jpg?stp=cp6_dst-jpegr_e35_tt6&_nc_cat=104&_nc_map=urlgen_bucketless&ig_cache_key=NDAxNDYxNzUwODg0NDAwNTYyNA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMzA3Mi5oZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=uPe_2nZB6WcQ7kNvwGZ7B4V&_nc_oc=AdpvEe2ZxELwmn6ApH5s8…",
"height": 4096,
"width": 3072
},
{
"url": "https://instagram.fdiy2-1.fna.fbcdn.net/v/t51.82787-15/864655138_17990212416115443_8040082000059729905_n.jpg?stp=cp6_dst-jpegr_e35_p1080x1080_tt6&_nc_cat=104&_nc_map=urlgen_bucketless&ig_cache_key=NDAxNDYxNzUwODg0NDAwNTYyNA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMzA3Mi5oZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=uPe_2nZB6WcQ7kNvwGZ7B4V&_nc_oc=AdpvEe2ZxE…",
"height": 1440,
"width": 1080
}
]
},
"media_type": 1,
"original_height": 4096,
"original_width": 3072,
"pk": "4014617508844005624",
"video_versions": null,
"usertags": null,
"id": "4014617508844005624_63482099442",
"number_of_qualities": null,
"code": "De2yVqbtej4",
"text_app_music_info": null,
"fbid": "17883057546628142",
"user": {
"pk": "63482099442",
"id": "63482099442"
}
}
],
"code": "De2ynmxDcS-",
"image_versions2": {
"candidates": [
{
"height": 2077,
"url": "https://instagram.fdiy2-1.fna.fbcdn.net/v/t51.82787-15/860018369_17990212284115443_1766906274600589800_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=101&_nc_map=urlgen_bucketless&ig_cache_key=NDAxNDYxODczMzY3ODc3MDc0Mw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTIwNS5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=FQvHFaz5LSMQ7kNvwElMDzG&_nc_oc=AdqpygGnBMm_34YGeNmUemYncG0…",
"width": 1205
},
{
"height": 1862,
"url": "https://instagram.fdiy2-1.fna.fbcdn.net/v/t51.82787-15/860018369_17990212284115443_1766906274600589800_n.jpg?stp=dst-jpg_e35_p1080x1080_tt6&_nc_cat=101&_nc_map=urlgen_bucketless&ig_cache_key=NDAxNDYxODczMzY3ODc3MDc0Mw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTIwNS5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=FQvHFaz5LSMQ7kNvwElMDzG&_nc_oc=AdqpygGnBMm_34YG…",
"width": 1080
}
]
},
"original_height": 2077,
"original_width": 1205,
"accessibility_caption": null,
"video_versions": null,
"has_audio": null,
"media_type": 8,
"caption_add_on": null,
"giphy_media_info": null,
"media_overlay_info": null,
"sharing_friction_info": {
"should_have_sharing_friction": false,
"sharing_friction_payload": null
},
"like_count": 486,
"metaPlace": null,
"meta_place": null,
"gen_ai_detection_method": {
"detection_method": "NONE"
},
"taken_at": 1792799869,
"organic_tracking_token": "eyJ2ZXJzaW9uIjo2LCJwYXlsb2FkIjp7ImlzX2FuYWx5dGljc190cmFja2VkIjp0cnVlLCJ1dWlkIjoiQVFTMnRkV3lEQ043bHBxNXJaVlp3dXo0MDE0NjE4NzQxODU3Njk5MDA2Iiwic2VydmVyX3Rva2VuIjoiMTc5Mjk0ODM5OTA3Mnw0MDE0NjE4NzQxODU3Njk5MDA2fDYzNDgyMDk5NDQyfDBkZWI0MDU3YzgwYTJkMDY1ODE5N2ZhZWM0NzRiYjhlMGM3MDIzNTUxYWMxMGExYmUxMDU3NGJjYzhhZDhmYmEifSwic2lnbmF0dXJlIjoiIn0=",
"logging_info_token": null,
"like_and_view_counts_disabled": false,
"url": "https://www.threads.com/@mosseri/post/De2ynmxDcS-"
},
{
"id": "4013832852559003856_63482099442",
"pk": "4013832852559003856",
"user": {
"friendship_status": null,
"pk": "63482099442",
"profile_pic_url": "https://scontent.cdninstagram.com/v/t51.82787-19/652081753_17949596661115443_3143547630500927369_n.jpg?stp=dst-jpg_s206x206_tt6&_nc_cat=111&ccb=7-5&_nc_sid=30ff31&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy42NzguQzMifQ%3D%3D&_nc_ohc=wlK8d3fTC_sQ7kNvwGGj9KZ&_nc_oc=Adp1Q2T_nEZvbm81E6PG9RrUrGwVxlVqjsKZEU7oecRD8FaTaVwnTVCC2vHnh3XiiDfd2HobRSAyEQr_bkbwKTmK&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_…",
"username": "mosseri",
"id": "63482099442",
"transparency_label": null,
"transparency_product": null,
"transparency_product_enabled": false,
"is_verified": true,
"text_post_app_is_private": false,
"has_onboarded_to_text_post_app": true
},
"text_post_app_info": {
"show_header_follow": false,
"is_markup": false,
"custom_feed_preview_info": null,
"link_preview_attachment": null,
"linked_inline_media": null,
"special_effects_enabled_str": "",
"text_fragments": {
"fragments": [
{
"fragment_type": "plaintext",
"link_fragment": null,
"mention_fragment": null,
"plaintext": "Every major platform has had to lean into recommendations — posts from accounts you don't happen to follow — to stay relevant. Going back to a following-only feed would quickly mean a smaller Instagram, with less reach to go around for everyone. That doesn't mean the loss of agency isn't real, or worth solving. Glad to see this becoming an industry-wide direction.",
"inline_sticker_fragment": null,
"linkified_web_url": null,
"linkified_in_app_url": null,
"styling_info": null
}
]
},
"reshare_count": 15,
"direct_reply_count": 364,
"repost_count": 52,
"quote_count": 17,
"share_info": {
"quoted_attachment_author_attribution_allowed": true,
"quoted_attachment_post_unavailable": false,
"quoted_attachment_post": null,
"quoted_post": {
"text_post_app_info": {
"is_post_unavailable": false,
"id": "XDTTextPostAppMediaInfo:18079070444417376",
"best_of_threads_info": null,
"is_ghost_post": false,
"self_thread_info": null,
"is_spoiler_media": false,
"tappable_elements": [],
"is_markup": false,
"attachment_tombstone_info": null,
"ghost_post_exp_time_ms": null,
"ghost_post_approximate_like_count_str": null,
"ghost_post_reply_type": null,
"ghost_post_approximate_reply_count_str": null,
"direct_reply_count": 8,
"repost_count": 12,
"quote_count": 2,
"reshare_count": 6,
"custom_feed_preview_info": null,
"platform_podcast_episode_info": null,
"platform_podcast_info": null,
"link_preview_attachment": null,
"link_preview_response": null,
"linked_inline_media": null,
"snippet_attachment_info": null,
"game_score_share_info": null,
"public_view_count_card_attachment_info": null,
"community_emoji_update_attachment_info": null,
"share_info": {
"quoted_attachment_author_attribution_allowed": true,
"quoted_attachment_post_unavailable": false,
"quoted_attachment_post": null,
"quoted_post": null,
"quoted_post_caption": null
},
"special_effects_enabled_str": "",
"algo_tweaks_info": null,
"text_fragments": {
"fragments": [
{
"fragment_type": "plaintext",
"link_fragment": null,
"mention_fragment": null,
"plaintext": "Instagram expanded its feature that lets users provide specific feedback to tailor their feed. And across the social media ecosystem, platforms are increasingly offering similar options to give users greater control over what they see as they scroll. ",
"inline_sticker_fragment": null,
"linkified_web_url": null,
"linkified_in_app_url": null,
"styling_info": null
},
{
"fragment_type": "link",
"link_fragment": {
"display_text": "cnn.it/4si8H…",
"uri": "https://cnn.it/4si8Haw"
},
"mention_fragment": null,
"plaintext": "https://cnn.it/4si8Haw",
"inline_sticker_fragment": null,
"linkified_web_url": null,
"linkified_in_app_url": null,
"styling_info": null
}
]
},
"show_header_follow": false,
"is_reply": false,
"self_thread_count": 0,
"tag_header": null,
"reply_to_author": null,
"related_trends_info": null,
"is_liked_by_root_author": false
},
"code": "DeyxYi-lJTj",
"user": {
"username": "cnn",
"id": "63404358343",
"pk": "63404358343",
"profile_pic_url": "https://scontent.cdninstagram.com/v/t51.2885-19/358506515_645911684262096_4169089819037913513_n.jpg?stp=dst-jpg_s206x206_tt6&_nc_cat=1&ccb=7-5&_nc_sid=30ff31&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=x4aPmjr-Yp4Q7kNvwEeY4Kv&_nc_oc=AdoWwMGir-7GdshZ9tnrcvSLrO8CfsosAlRDumZZ2-q-c8ki1GGn-hh6okKMMOLDw-VIIiPUhnQ85TqwFUwfltSL&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_ss=7…",
"interop_messaging_user_fbid": "17900533092118344",
"friendship_status": null,
"is_verified": true
},
"canonical_url": null,
"id": "4013487409044165859_63404358343",
"is_paid_partnership": null,
"audio": null,
"caption": {
"text": "Instagram expanded its feature that lets users provide specific feedback to tailor their feed. And across the social media ecosystem, platforms are increasingly offering similar options to give users greater control over what they see as they scroll. https://cnn.it/4si8Haw",
"has_translation": null,
"pk": "18079070453417376",
"text_translation": null
},
"caption_is_edited": false,
"pk": "4013487409044165859",
"transcription_data": null,
"carousel_media": null,
"image_versions2": {
"candidates": [
{
"height": 1350,
"url": "https://instagram.fdiy2-1.fna.fbcdn.net/v/t51.82787-15/863149874_17987818302118344_2466955845274183808_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=107&_nc_map=urlgen_bucketless&ig_cache_key=NDAxMzQ4NzQwOTA0NDE2NTg1OQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=-WavVZ-We5EQ7kNvwEPWO2d&_nc_oc=AdrxGLF72m8Uqe-aAklpLk2AzrdGc2NJOevA7-Y…",
"width": 1080
},
{
"height": 900,
"url": "https://instagram.fdiy2-1.fna.fbcdn.net/v/t51.82787-15/863149874_17987818302118344_2466955845274183808_n.jpg?stp=dst-jpg_e35_p720x720_tt6&_nc_cat=107&_nc_map=urlgen_bucketless&ig_cache_key=NDAxMzQ4NzQwOTA0NDE2NTg1OQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=-WavVZ-We5EQ7kNvwEPWO2d&_nc_oc=AdrxGLF72m8Uqe-aAklpLk2AzrdGc2…",
"width": 720
}
]
},
"original_height": 1350,
"original_width": 1080,
"accessibility_caption": null,
"usertags": null,
"is_dash_eligible": null,
"number_of_qualities": null,
"video_dash_manifest": null,
"video_versions": null,
"has_audio": null,
"media_type": 1,
"caption_add_on": null,
"logging_info_token": null,
"text_app_music_info": null,
"fbid": "18079070444417376",
"audience": null,
"like_count": 111,
"has_viewer_saved": null,
"giphy_media_info": null,
"text_app_glimmer_post_info": null,
"metaPlace": null,
"original_lang_for_translations": null,
"detected_language": null,
"taken_at": 1792665008,
"is_fb_only": null,
"is_internal_only": null,
"media_overlay_info": null,
"like_and_view_counts_disabled": false
},
"reposted_post": null
},
"reply_to_author": null,
"reply_control": "everyone",
"private_reply_partner": null,
"self_thread_count": 0,
"tag_header": null,
"root_post_author": null,
"pinned_post_info": {
"is_pinned_to_parent_post": false,
"is_pinned_to_profile": false
},
"related_trends_info": null,
"is_reply": false,
"is_post_unavailable": false,
"post_unavailable_reason": null,
"hush_info": null
},
"is_paid_partnership": null,
"audio": null,
"caption": {
"text": "Every major platform has had to lean into recommendations — posts from accounts you don't happen to follow — to stay relevant. Going back to a following-only feed would quickly mean a smaller Instagram, with less reach to go around for everyone. That doesn't mean the loss of agency isn't real, or worth solving. Glad to see this becoming an industry-wide direction.",
"has_translation": null,
"pk": "18103206893533183",
"text_translation": null
},
"caption_is_edited": false,
"transcription_data": null,
"carousel_media": null,
"code": "Dez_7aUkoDQ",
"image_versions2": {
"candidates": []
},
"original_height": 612,
"original_width": 612,
"accessibility_caption": null,
"video_versions": null,
"has_audio": null,
"media_type": 19,
"caption_add_on": null,
"giphy_media_info": null,
"media_overlay_info": null,
"sharing_friction_info": {
"should_have_sharing_friction": false,
"sharing_friction_payload": null
},
"like_count": 267,
"metaPlace": null,
"meta_place": null,
"gen_ai_detection_method": {
"detection_method": "NONE"
},
"taken_at": 1792706184,
"organic_tracking_token": "eyJ2ZXJzaW9uIjo2LCJwYXlsb2FkIjp7ImlzX2FuYWx5dGljc190cmFja2VkIjp0cnVlLCJ1dWlkIjoiQVFTMnRkV3lEQ043bHBxNXJaVlp3dXo0MDEzODMyODUyNTU5MDAzODU2Iiwic2VydmVyX3Rva2VuIjoiMTc5Mjk0ODM5ODk5OHw0MDEzODMyODUyNTU5MDAzODU2fDYzNDgyMDk5NDQyfDNmZWE2ZmUyZTFlYTYxMDcyYmYyYmFkM2NkMjk5ZDg3NDAwZjJjNzgzMzEwNjg5OThjZjk1NjVjMTJmMWYwYTYifSwic2lnbmF0dXJlIjoiIn0=",
"logging_info_token": null,
"like_and_view_counts_disabled": false,
"url": "https://www.threads.com/@mosseri/post/Dez_7aUkoDQ"
}
]
}Common to every endpoint
Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}04Notes
About 15 posts, in `posts`: the first post of each of the account's latest threads. There is no paging: one call returns one batch. An account with no posts returns an empty list for 0 credits. An unknown or private account answers 404, free.
05Errors & credits
Every error has success: false, a real HTTP status and costs no credits.
400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.