Threads
Posts / User Posts
per_call
Paginated feed of a Threads account's posts including text, quoted posts, attached images or video, like, reply and repost counts and timestamps. Built for early-mover social listening on the platform.
What you get
Each call returns one post record. There is no pagination.
Endpoint
GET /v1/threads/posts-user-posts
Price
$1.50
per 1,000 calls · $0.0015 per call
Cost per call
1 credit
Failed calls never charged
Parameters
target
required
stringThe Threads handle, URL or identifier to resolve.
limit
optional
integerMaximum records to return, capped at this service's page size (see Limits below). Omit it to receive the whole page. It shapes the response, not the price — a call costs the same either way.
cursor
optional
stringPagination cursor returned by a previous response.
fresh
optional
enumBypass cached data and force a live fetch for this one call. Use it for daily monitoring or any figure you are tracking over time. Accepts `true`, `1`, `false` or `0`; anything else returns 400 `invalid_fresh`. Defaults to false and costs exactly the same as a cached call.
One of: true, 1, false, 0
Example request
Live call. Successful calls are charged; failed and empty results are not.
curl
curl "https://fastfetchz.com/v1/threads/posts-user-posts?target=nasa" \
-H "X-API-Key: $FASTFETCHZ_KEY"Example response
200 application/json
{
"success": true,
"service": {
"platform": "Threads",
"name": "Posts / User Posts",
"slug": "posts-user-posts"
},
"credits_charged": 1,
"credits_remaining": 99,
"latency_ms": 214,
"data": {
"posts": [
{
"id": "3978857420671757794_28829152388",
"pk": "3978857420671757794",
"user": {
"friendship_status": null,
"pk": "28829152388",
"profile_pic_url": "https://scontent-ord5-1.cdninstagram.com/v/t51.82787-19/669747085_18089786557960389_922072622069351626_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-ord5-1.cdninstagram.com&_nc_cat=109&_nc_oc=Q6cZ2gG_GqtQEwHRSVzlJ2D_ZJWswk9onkIWwZ5wsyNuef40q6M_F0H6w2yJtWhEqeMBmoc&_nc_ohc=x8STo1pOkeAQ7kNvwHl0FxY&_nc_gid=TqLtgEMinF5tzPVWVcC9Xg&edm=AA3D…",
"username": "nasa",
"id": "28829152388",
"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": {
"display_url": "youtube.com",
"favicon_url": "https://external-ord5-1.xx.fbcdn.net/emg1/v/t13/8192225234307536207?url=https%3A%2F%2Fwww.youtube.com%2Fs%2Fdesktop%2F7cc1189c%2Fimg%2Ffavicon_144x144.png&utld=youtube.com&_nc_sid=1d65fc&_nc_ht=external-ord5-1.xx.fbcdn.net&stp=dst-png_s42x42&ccb=18-1&_nc_gid=TqLtgEMinF5tzPVWVcC9Xg&_nc_ad=z-m&_nc_cid=0&_nc_zt=3&oh=06_Q3_DAe5mPP5v2YrviY4X2GAWbkeobrQsDB7pVACdFh5eINkQ&oe=6AA240CD",
"image_url": "https://external-ord5-1.xx.fbcdn.net/emg1/v/t13/17926082443546971180?stp=dst-src&url=https%3A%2F%2Fi.ytimg.com%2Fvi%2FMVt2139voxk%2Fmaxresdefault.jpg&utld=ytimg.com&_nc_gid=TqLtgEMinF5tzPVWVcC9Xg&_nc_oc=AdqQO-lDPAv11_rpwHFOZd5koR9EM4g_c39ljmX7OCqvLRWhZ6bWgIYbY9e6GFckC2o&ccb=13-1&oh=06_Q3_DARtPbrf6JGfdX8R3W45elN7BJ-0w4rJzgr6hqfKukF0Z&oe=6AA25E4A&_nc_sid=1d65fc",
"title": "For Earth, With Love: Artemis II",
"url": "https://l.threads.com/?u=https%3A%2F%2Fyoutu.be%2FMVt2139voxk&e=AUBl7H_j1SKLpChVdDDxVYMbawgWabk4ZMuJ8QxiTWG6HcOkmoGUnQ055N0AojhxFtoGbpUse_m93TcN0d0Wkz33HOTgsT6M5fqwGfpIwUeWkgmCGSqTwpDEifg"
},
"linked_inline_media": null,
"special_effects_enabled_str": "",
"text_fragments": {
"fragments": [
{
"fragment_type": "plaintext",
"link_fragment": null,
"mention_fragment": null,
"plaintext": "It's been a few months since Artemis II splashed down, but Moon Joy doesn't have an expiration date! Press play on our new recap video. ",
"tag_fragment": null,
"linkified_web_url": null
},
{
"fragment_type": "inline_sticker",
"link_fragment": null,
"mention_fragment": null,
"plaintext": "□",
"tag_fragment": null,
"linkified_web_url": null
}
]
},
"reshare_count": 8,
"direct_reply_count": 41,
"repost_count": 105,
"quote_count": 16,
"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": {
"display_name": "Space Threads",
"id": "18401017042011621"
},
"root_post_author": null,
"pinned_post_info": {
"is_pinned_to_parent_post": false,
"is_pinned_to_profile": true
},
"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": "It's been a few months since Artemis II splashed down, but Moon Joy doesn't have an expiration date! Press play on our new recap video. ▓",
"pk": "18087977444682897",
"has_translation": null
},
"caption_is_edited": false,
"transcription_data": null,
"carousel_media": null,
"code": "Dc3vb5DES3i",
"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": 1416,
"metaPlace": null,
"meta_place": null,
"gen_ai_detection_method": null,
"taken_at": 1788536788,
"organic_tracking_token": "eyJ2ZXJzaW9uIjo1LCJwYXlsb2FkIjp7ImlzX2FuYWx5dGljc190cmFja2VkIjpmYWxzZSwidXVpZCI6ImQwYzExNGU2NDVjMjQ0NzBhNmZkNjg1NGIzODVjODJhMzk3ODg1NzQyMDY3MTc1Nzc5NCJ9LCJzaWduYXR1cmUiOiIifQ==",
"logging_info_token": null,
"like_and_view_counts_disabled": false,
"url": "https://www.threads.com/@nasa/post/Dc3vb5DES3i"
},
{
"id": "3976157978336241783_28829152388",
"pk": "3976157978336241783",
"user": {
"friendship_status": null,
"pk": "28829152388",
"profile_pic_url": "https://scontent-ord5-1.cdninstagram.com/v/t51.82787-19/669747085_18089786557960389_922072622069351626_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-ord5-1.cdninstagram.com&_nc_cat=109&_nc_oc=Q6cZ2gG_GqtQEwHRSVzlJ2D_ZJWswk9onkIWwZ5wsyNuef40q6M_F0H6w2yJtWhEqeMBmoc&_nc_ohc=x8STo1pOkeAQ7kNvwHl0FxY&_nc_gid=TqLtgEMinF5tzPVWVcC9Xg&edm=AA3D…",
"username": "nasa",
"id": "28829152388",
"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": "Main character energy unlocked! 👩🚀\n\nNASA astronaut Jessica Meir and ",
"tag_fragment": null,
"linkified_web_url": null
},
{
"fragment_type": "mention",
"link_fragment": null,
"mention_fragment": {
"mention_type": "text_app_profile",
"mentioned_user": {
"username": "europeanspaceagency",
"id": "63029318381"
}
},
"plaintext": "@europeanspaceagency",
"tag_fragment": null,
"linkified_web_url": null
}
]
},
"reshare_count": 20,
"direct_reply_count": 64,
"repost_count": 125,
"quote_count": 22,
"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": {
"display_name": "Space Threads",
"id": "18401017042011621"
},
"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": "Main character energy unlocked! 👩🚀\n\nNASA astronaut Jessica Meir and @europeanspaceagency astronaut Sophie Adenot will conduct a spacewalk Tuesday, Sept. 1, with live coverage beginning at 7 a.m. EDT (1100 UTC). Watch with us!",
"pk": "18098751293369016",
"has_translation": null
},
"caption_is_edited": false,
"transcription_data": null,
"carousel_media": null,
"code": "DcuJp1dkSh3",
"image_versions2": {
"candidates": [
{
"height": 2730,
"url": "https://scontent-ord5-2.cdninstagram.com/v/t51.82787-15/792157949_18117073114960389_7210144324164257653_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=104&ig_cache_key=Mzk3NjE1Nzk3ODMzNjI0MTc4Mw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuNDA5Ni5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=v4AUjFaBdO0Q7kNvwFEgiv8&_nc_oc=AdrHQSyTnFEuCvBpS0rO_ps9emKnZs8-oknfRWFQYP8JaSDTWN33u62jIUW8s2jv…",
"width": 4096
},
{
"height": 720,
"url": "https://scontent-ord5-2.cdninstagram.com/v/t51.82787-15/792157949_18117073114960389_7210144324164257653_n.jpg?stp=dst-jpg_e35_s1080x1080_tt6&_nc_cat=104&ig_cache_key=Mzk3NjE1Nzk3ODMzNjI0MTc4Mw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuNDA5Ni5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=v4AUjFaBdO0Q7kNvwFEgiv8&_nc_oc=AdrHQSyTnFEuCvBpS0rO_ps9emKnZs8-oknfRWFQYP8JaSDTWN33u…",
"width": 1080
}
]
},
"original_height": 2730,
"original_width": 4096,
"accessibility_caption": "NASA astronaut Jessica Meir (left) and ESA astronaut Sophie Adenot (right) stand back-to-back with arms crossed inside the International Space Station, flanked by two white spacesuits mounted on either side of the frame.",
"video_versions": null,
"has_audio": null,
"media_type": 1,
"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": 3209,
"metaPlace": null,
"meta_place": null,
"gen_ai_detection_method": null,
"taken_at": 1788214989,
"organic_tracking_token": "eyJ2ZXJzaW9uIjo1LCJwYXlsb2FkIjp7ImlzX2FuYWx5dGljc190cmFja2VkIjpmYWxzZSwidXVpZCI6ImQwYzExNGU2NDVjMjQ0NzBhNmZkNjg1NGIzODVjODJhMzk3NjE1Nzk3ODMzNjI0MTc4MyJ9LCJzaWduYXR1cmUiOiIifQ==",
"logging_info_token": null,
"like_and_view_counts_disabled": false,
"url": "https://www.threads.com/@nasa/post/DcuJp1dkSh3"
}
]
}
}Limits
- Maximum per call: 15 posts.
- Minimum per call: 1 post — a target with less data returns fewer posts, and an empty result is still a successful call.
- Each call fetches a full page of up to 15 and costs the same either way. Pass limit to receive fewer than that in the response.
- This endpoint returns a single record per call and is not paginated.
What this costs in practice
10,000 posts = 10,000 calls × 1 credits per call = 10,000 credits = $0.00
Priced at the Custom pack rate: 1,000,000 credits for $0.00.
Open in the pricing calculatorError codes
StatusCodeMeaning
401invalid_api_keyMissing or unrecognized X-API-Key header. No credits are charged.
402insufficient_creditsYour balance is below the cost of the call. Top up to continue.
403account_suspended / key_revokedThe account is suspended or the key was revoked.
429rate_limitedOver your account's requests-per-second limit. Retrying helps: the body carries retry_after_seconds and the response carries a Retry-After header. Not charged.
429monthly_cap_reachedThis key used the monthly call cap you set for it. Retrying will not help — raise the cap, use another key, or wait for the next calendar month. No Retry-After header is sent. Not charged.
500upstream_errorUnexpected failure while fulfilling the request. Not charged.