Docs · Threads account posts

Threads account posts

One page of a public account's Threads posts, with text, media and engagement.

1 credit per callFresh within 1 minuteMCP tool: threads_user_posts

GEThttps://api.lurkapi.com/v1/threads/user/posts

When to use this

Read the account's public posts in the feed order returned by Threads, including linked self replies. count counts feed groups, so the number of individual posts can be larger. Pinned posts may appear ahead of newer posts. Pass next_cursor back as cursor with the same handle to continue; null means the end. Private accounts return 403 not_public. Login walls and incomplete responses are upstream errors, never empty success pages.

Parameters

All parameters go in the query string.

Parameter	Description
`handle` stringrequired	Threads username, with or without @, or its threads.com / threads.net profile URL. Example `zuck`
`cursor` stringoptional	Opaque `next_cursor` from the previous response. Keep the same handle when continuing.
`count` integeroptional	Number of feed groups to request, from 1 to 20; default 10. A linked thread can contain multiple posts. Default `10`

Example request

Replace YOUR_API_KEY with your key, or set LURKAPI_KEY for the code. Get a free key.

curlJavaScriptPython

JavaScript · reads your key from LURKAPI_KEY

const params = new URLSearchParams({
  handle: "zuck",
});
const res = await fetch(`https://api.lurkapi.com/v1/threads/user/posts?${params}`, {
  headers: { "x-api-key": process.env.LURKAPI_KEY },
});
const data = await res.json();
if (!data.success) throw new Error(`${data.code}: ${data.error}`);
console.log(data.posts);

Python · reads your key from LURKAPI_KEY

import os
import requests

res = requests.get(
    "https://api.lurkapi.com/v1/threads/user/posts",
    params={
        "handle": "zuck",
    },
    headers={"x-api-key": os.environ["LURKAPI_KEY"]},
    timeout=60,
)
data = res.json()
if not data["success"]:
    raise RuntimeError(f"{data['code']}: {data['error']}")
print(data["posts"])

Example response

A real response from this endpoint, captured from the live API and trimmed to a couple of items. Strings over 96 characters (mostly signed media URLs) are cut short and end in ….

Show the example response (2 KB)

{
  "success": true,
  "credits_remaining": 99,
  "credits_charged": 1,
  "posts": [
    {
      "id": "3996155940894885511",
      "code": "Dd1MqfcG0aH",
      "url": "https://www.threads.com/@zuck/post/Dd1MqfcG0aH",
      "text": "We believe superintelligence will create significant new opportunities f…",
      "created_at": "2026-09-28T12:35:32.000Z",
      "like_count": 2525,
      "reply_count": 2393,
      "repost_count": 155,
      "quote_count": 148,
      "author": {
        "id": "63055343223",
        "username": "zuck",
        "name": "Mark Zuckerberg",
        "is_verified": true,
        "profile_pic_url": "https://scontent-iad6-1.cdninstagram.com/v/t51.82787-19/825322135_179893…"
      },
      "media": [],
      "is_reply": false,
      "is_pinned": false
    },
    {
      "id": "3996155941205275653",
      "code": "Dd1Mqfum3QF",
      "url": "https://www.threads.com/@zuck/post/Dd1Mqfum3QF",
      "text": "Meta Enterprise Platform will use our strengths that few other companies…",
      "created_at": "2026-09-28T12:35:32.000Z",
      "like_count": 628,
      "reply_count": 57,
      "repost_count": 15,
      "quote_count": 1,
      "author": {
        "id": "63055343223",
        "username": "zuck",
        "name": "Mark Zuckerberg",
        "is_verified": true,
        "profile_pic_url": "https://scontent-iad6-1.cdninstagram.com/v/t51.82787-19/825322135_179893…"
      },
      "media": [],
      "is_reply": true,
      "is_pinned": false
    }
  ],
  "next_cursor": "AQHTDqxWB6zj4m3ifjfhSzUWaAKIEawVXR3MOFSYxxAzMitQ4z6sq0p2X_X-r607YZQLFZ3yIBSykpsL3FJDJKY-_w",
  "has_more": true
}

Response fields

Every field of a successful response. [] marks a list: a[].b is the b of each item in a. nullable fields can be null; optional fields can be missing.

Show all 28 fields

Field	Type	Description
success	true	Always true here; errors have `success: false`.
credits_remaining	number	Your balance after this call. On anonymous playground calls: free tries left today.
credits_charged	number	Credits this call cost; 0 on free endpoints. On anonymous playground calls: tries used (1).
posts	object[]	Public posts in feed order, including linked self replies; post ids are unique within this page.
posts[].id	string	Numeric Threads post id, returned as a string.
posts[].code	string	Post shortcode used in its public URL.
posts[].url	string	Canonical public post URL on threads.com.
posts[].text	string	Post text; empty for posts that contain only media.
posts[].created_at	stringnullable	Publication time in ISO 8601; null when unknown.
posts[].like_count	numbernullable	Likes when fetched; null when Threads omits the count.
posts[].reply_count	numbernullable	Direct replies when fetched; null when unknown.
posts[].repost_count	numbernullable	Reposts when fetched; null when unknown.
posts[].quote_count	numbernullable	Quote posts when fetched; null when unknown.
posts[].author	objectnullable	Public author metadata; null when no usable author identity is included.
posts[].author.id	string	Numeric Threads account id, returned as a string.
posts[].author.username	string	Account username without @.
posts[].author.name	stringnullable	Display name; null when the public post omits it.
posts[].author.is_verified	booleannullable	Whether the author has a verified badge; null when unknown.
posts[].author.profile_pic_url	stringnullable	Profile picture URL; null when the public post omits it.
posts[].media	object[]	Attached media in source order; empty for text-only posts.
posts[].media[].type	string	Whether the URL is an image or a playable video file.
posts[].media[].url	string	Largest public image or video file URL supplied by Threads; these CDN links can expire.
posts[].media[].width	numbernullable	Media width in pixels; null when unknown.
posts[].media[].height	numbernullable	Media height in pixels; null when unknown.
posts[].is_reply	booleannullable	Whether this is a reply to another post; null when unknown.
posts[].is_pinned	booleannullable	Whether Threads marks the post as pinned; null when unknown.
next_cursor	stringnullable	Pass as `cursor` for the next page; null at the end.
has_more	boolean	Whether Threads reports another page. False when next_cursor is null.

Status	Code	Meaning
401	`missing_api_key`	No API key. Send it in the `x-api-key` header.
401	`invalid_api_key`	The key is unknown or was revoked.
402	`insufficient_credits`	Not enough credits for this call. Buy a pack or wait for tomorrow's top-up.
403	`not_public`	The platform confirmed this account or content isn't available to logged-out visitors. Use a publicly visible target.
404	`not_found`	The endpoint, or the thing you asked for (ad, post, subreddit), doesn't exist. Charged when the platform was checked.
405	`method_not_allowed`	Endpoints take GET with query params.
429	`rate_limited`	Too many calls at once. Wait for the `retry-after` seconds, then retry.
500	`internal_error`	Something broke on our side. Retry; 5xx errors are free.
502	`upstream_error`	The platform didn't give a usable answer. Retry; 5xx errors are free.
503	`upstream_busy`	All our connections to the platform are busy. Retry in a few seconds; 5xx errors are free.
504	`upstream_timeout`	The platform took over 30 seconds to answer. Retry; timeouts are free.

Use it in Claude

Once LurkAPI is connected to Claude, this endpoint is the threads_user_posts tool. Ask in plain English, for example:

Ask Claude

Use LurkAPI's threads_user_posts with handle "zuck" and summarize what you find.

Claude calls threads_user_posts with arguments like these, and each call costs 1 credit:

Tool arguments

{
  "handle": "zuck"
}

Tool results skip nulls and empty lists to save tokens.