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.
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
integerItems to return for list responses. Default 10, max 100.
cursor
optional
stringPagination cursor returned by a previous response.
Example request
Sandbox calls return deterministic sample data in the live payload shape.
curl
curl "https://api.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": {
"items": [
{
"id": "7000493429",
"shortcode": "SAKQD",
"url": "https://example.com/threads/nasa/493429",
"caption": "Sandbox posts / user posts item #1 for @nasa.",
"media_type": "image",
"like_count": 13629,
"comment_count": 234,
"view_count": 494429,
"duration_sec": 61,
"taken_at": "2026-08-24T10:34:39.624Z"
},
{
"id": "7000015494",
"shortcode": "SBYE",
"url": "https://example.com/threads/nasa/15494",
"caption": "Sandbox posts / user posts item #2 for @nasa.",
"media_type": "image",
"like_count": 15694,
"comment_count": 199,
"view_count": 16494,
"duration_sec": 26,
"taken_at": "2026-08-23T10:34:39.624Z"
}
],
"paging": {
"has_more": true,
"next_cursor": "cursor_40643"
}
}
}Error 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_limitedThe key exceeded its monthly cap or the burst limit. Retry later.
500upstream_errorUnexpected failure while fulfilling the request. Not charged.