LurkAPI
Docs · Threads post

Threads post

The text, author, media and engagement of one public Threads post.

1 credit per callFresh within 5 minutesMCP tool: threads_post
GEThttps://api.lurkapi.com/v1/threads/post

Example responseView as markdown

When to use this

Pass a public threads.com or threads.net post URL. Returns the target post rather than suggested posts or its reply thread. Unknown or deleted posts return 404 only when Threads explicitly reports them unavailable. Login walls and incomplete pages return an upstream error.

Parameters

All parameters go in the query string.

ParameterDescription
url
stringrequired
Public post URL on threads.com or threads.net, containing /@<username>/post/<code>.
Example
https://www.threads.com/@zuck/post/Dd1MqfcG0aH

Example request

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

Language

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 (1 KB)
{
  "success": true,
  "credits_remaining": 99,
  "credits_charged": 1,
  "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
}

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 25 fields
FieldTypeDescription
successtrueAlways true here; errors have success: false.
credits_remainingnumberYour balance after this call. On anonymous playground calls: free tries left today.
credits_chargednumberCredits this call cost; 0 on free endpoints. On anonymous playground calls: tries used (1).
idstringNumeric Threads post id, returned as a string.
codestringPost shortcode used in its public URL.
urlstringCanonical public post URL on threads.com.
textstringPost text; empty for posts that contain only media.
created_atstringnullablePublication time in ISO 8601; null when unknown.
like_countnumbernullableLikes when fetched; null when Threads omits the count.
reply_countnumbernullableDirect replies when fetched; null when unknown.
repost_countnumbernullableReposts when fetched; null when unknown.
quote_countnumbernullableQuote posts when fetched; null when unknown.
authorobjectnullablePublic author metadata; null when no usable author identity is included.
author.idstringNumeric Threads account id, returned as a string.
author.usernamestringAccount username without @.
author.namestringnullableDisplay name; null when the public post omits it.
author.is_verifiedbooleannullableWhether the author has a verified badge; null when unknown.
author.profile_pic_urlstringnullableProfile picture URL; null when the public post omits it.
mediaobject[]Attached media in source order; empty for text-only posts.
media[].typestringWhether the URL is an image or a playable video file.
media[].urlstringLargest public image or video file URL supplied by Threads; these CDN links can expire.
media[].widthnumbernullableMedia width in pixels; null when unknown.
media[].heightnumbernullableMedia height in pixels; null when unknown.
is_replybooleannullableWhether this is a reply to another post; null when unknown.
is_pinnedbooleannullableWhether Threads marks the post as pinned; null when unknown.

Caching and freshness

Responses are cached for up to 5 minutes, so a repeat call within that window can return the same data. It still costs 1 credit.

Errors

Errors return { success: false, error, code, docs } with the HTTP status below. Validation errors, 401/402/429 rejections and 5xx failures are free; not_found is charged (how charging works). All error codes.

StatusCodeMeaning
401missing_api_keyNo API key. Send it in the x-api-key header.
401invalid_api_keyThe key is unknown or was revoked.
402insufficient_creditsNot enough credits for this call. Buy a pack or wait for tomorrow's top-up.
403not_publicThe platform confirmed this account or content isn't available to logged-out visitors. Use a publicly visible target.
404not_foundThe endpoint, or the thing you asked for (ad, post, subreddit), doesn't exist. Charged when the platform was checked.
405method_not_allowedEndpoints take GET with query params.
429rate_limitedToo many calls at once. Wait for the retry-after seconds, then retry.
500internal_errorSomething broke on our side. Retry; 5xx errors are free.
502upstream_errorThe platform didn't give a usable answer. Retry; 5xx errors are free.
503upstream_busyAll our connections to the platform are busy. Retry in a few seconds; 5xx errors are free.
504upstream_timeoutThe 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_post tool. Ask in plain English, for example:

Ask Claude
Use LurkAPI's threads_post with url "https://www.threads.com/@zuck/post/Dd1MqfcG0aH" and summarize what you find.

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

Tool arguments
{
  "url": "https://www.threads.com/@zuck/post/Dd1MqfcG0aH"
}

Tool results skip nulls and empty lists to save tokens.