docs / threads

Threads API

base /threads/v17 endpoints

post/threads/v1/profile1 credit

Public Threads profile by username from embedded data-sjs JSON.

Parameter		Allowed / range	Description
username	required	—	Threads handle without the @ (the name in threads.net/@<username>).

Try in playground →

post/threads/v1/posts1 credit

Get the public posts from a Threads profile by username (threads.net).

Parameter		Allowed / range	Description
username	required	—	Threads handle without the @ (the name in threads.net/@<username>).
limit = 25	optional	1–100	Max items to return (1-100). Larger values are clamped to 100.

Try in playground →

post/threads/v1/replies1 credit

Get the public replies from a Threads profile by username (threads.net).

Parameter		Allowed / range	Description
username	required	—	Threads handle without the @ (the name in threads.net/@<username>).
limit = 25	optional	1–100	Max items to return (1-100). Larger values are clamped to 100.

Try in playground →

post/threads/v1/reposts1 credit

Get the posts a Threads user has reposted — equivalent to the Reposts tab on their threads.net profile page.

Parameter		Allowed / range	Description
username	required	—	Threads handle without the @ (the name in threads.net/@<username>).
limit = 25	optional	1–100	Max items to return (1-100). Larger values are clamped to 100.

Try in playground →

post/threads/v1/post1 credit

Public post detail. Provide url, or username + code.

Parameter		Allowed / range	Description
url	optional	—	Full Threads post URL (alternative to username + code).
username	optional	—	Threads handle without the @ (the name in threads.net/@<username>).
code	optional	—	Post shortcode — the code in threads.net/@<username>/post/<code>. Combine with username, or pass the full post `url` instead.

Try in playground →

post/threads/v1/post_replies1 credit

Replies for a public post. Provide post_id, or url, or username + code.

Parameter		Allowed / range	Description
post_id	optional	—	Numeric Threads post id (from a post's `id`). Alternative to url / username+code.
url	optional	—	Full Threads post URL (alternative to username + code).
username	optional	—	Threads handle without the @ (the name in threads.net/@<username>).
code	optional	—	Post shortcode — the code in threads.net/@<username>/post/<code>. Combine with username, or pass the full post `url` instead.
limit = 25	optional	1–100	Max items to return (1-100). Larger values are clamped to 100.

Try in playground →

post/threads/v1/search2 credits

Search public Threads posts by keyword on threads.net.

Parameter		Allowed / range	Description
q	required	—	Search keyword (also accepted as 'query').
limit = 25	optional	1–50	Max items to return (1-50). Larger values are clamped to 50.

Try in playground →

Example request · profile

curl -X POST https://api.reefapi.com/threads/v1/profile \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"username":"zuck"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}