Threads API by APISH

Get public Threads data as clean, consistent JSON: threads profile and recent posts, search Threads posts, search Threads users, threads tag, threads post with replies, threads media posts of a user and more. 9 endpoints, one response shape, numbers parsed, absolute URLs.

How to use

1. Pick an Endpoint. Each option shows what it returns and its price in credits.
2. Enter its Parameters as JSON, for example {"username":"zuck"}. All parameters are listed below.
3. Run. Each call becomes one row in the dataset. Use Batch to run the same endpoint for many inputs and Pages per input to follow pagination.

Pricing

Pay per event: you pay per APISH credit the call used. The price of each endpoint is in the table below. Calls that fail on our side (server errors, timeouts, blocks) are free.

Endpoints

Endpoint	Returns	Required parameters	Credits
/threads/v1/profile	Threads profile and recent posts	username	1
/threads/v1/search	Search Threads posts	q	1
/threads/v1/search/users	Search Threads users	q	1
/threads/v1/tag	Threads tag	tag	2
/threads/v1/thread	Threads post with replies	url	1
/threads/v1/user/media	Threads media posts of a user	username	1
/threads/v1/user/posts	Threads user posts	username	1
/threads/v1/user/replies	Threads replies of a user	username	2
/threads/v1/user/reposts	Threads reposts of a user	username	1

Output

Each dataset row has endpoint, params, status, credits_used and the endpoint's data. Add "raw": 1 to the parameters to also get the site's original record, or "fields": "a,b.c" to return only the fields you need.

Endpoint details

Threads profile and recent posts

Endpoint /threads/v1/profile · 1 credit per successful call.

Parameters:

• username (required)

Example parameters: {"username":"zuck"}

Search Threads posts

Endpoint /threads/v1/search · 1 credit per successful call.

Parameters:

• q (required)
• sort: top or recent.

Example parameters: {"q":"ai"}

Search Threads users

Endpoint /threads/v1/search/users · 1 credit per successful call.

Parameters:

• q (required)

Example parameters: {"q":"nasa"}

Threads tag

Endpoint /threads/v1/tag · 2 credits per successful call.

A topic tag's page as Threads shows it to logged-out visitors: the tag's thread count and up to about 15 posts. Threads serves no further pages logged out, so next_cursor is always null.

Parameters:

• tag (required): Tag name, with or without #.

Example parameters: {"tag":"photography"}

Threads post with replies

Endpoint /threads/v1/thread · 1 credit per successful call.

The post, the posts it replies to (parents) and its direct replies (10 per page). Pagination: pass next_cursor back as cursor for more replies; it is null on the last page.

Parameters:

• url (required): Post URL.
• sort — one of top, recent: Order of replies: top (default) or recent.
• cursor: Value of next_cursor from the previous page.

Example parameters: {"url":"https://www.threads.com/@zuck/post/DeZtp-TkQHh"}

Threads media posts of a user

Endpoint /threads/v1/user/media · 1 credit per successful call.

The account's posts with photos or videos. Logged out, Threads serves one page of up to 15 per tab.

Parameters:

• username (required): Username or profile URL.
• cursor: Value of next_cursor from the previous page.

Example parameters: {"username":"zuck"}

Threads user posts

Endpoint /threads/v1/user/posts · 1 credit per successful call.

Parameters:

• username (required)
• cursor: Value of next_cursor from the previous page.

Example parameters: {"username":"zuck"}

Threads replies of a user

Endpoint /threads/v1/user/replies · 2 credits per successful call.

The account's replies, each with the post it answers (threads). Logged out, Threads serves one page of up to 15 per tab.

Parameters:

• username (required): Username or profile URL.
• cursor: Value of next_cursor from the previous page.

Example parameters: {"username":"zuck"}

Threads reposts of a user

Endpoint /threads/v1/user/reposts · 1 credit per successful call.

Posts the account reposted. Logged out, Threads serves one page of up to 15 per tab.

Parameters:

• username (required): Username or profile URL.
• cursor: Value of next_cursor from the previous page.

Example parameters: {"username":"zuck"}

Support

Questions, bugs or a missing field? Open an issue in this Actor's Issues tab and we will reply there.

Public data only: nothing behind a login. You are responsible for how you use the data you collect.