Upscrape
Sign in Get an API key

Threads Scraper scraper API

Scrapes public Threads (threads.com) profiles, posts, replies, reposts, and search results by parsing embedded JSON…

Social & content 7 capabilities stable 7.8% success rate
Sign in to run this LLM brief

Capabilities

Every capability is one POST /execute call that returns structured JSON.

Health Check

threads.health

Check the availability of all Threads scraping surfaces.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{},"capability":"threads.health"}'

Output

Field Type Required Description
first_error string optional First error encountered during the health check, if any.
post_ok boolean optional
profile_ok boolean optional
search_ok boolean optional
status string optional Overall health status.
threads_ok boolean optional

Get Post

threads.post

Fetch a single Threads post and its reply threads.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"shortcode":"DZpPDXbCeTt","username":"zuck"},"capability":"threads.post"}'

Input

Field Type Required Description
shortcode string optional Shortcode identifier of the post.
url string optional Full URL of the Threads post.
username string optional Username of the post author.

Output

Field Type Required Description
main_thread object optional
main_thread.id string optional
main_thread.posts array<object> optional
replies array<object> optional Reply threads to the post.
replies[].id string optional
replies[].posts array<object> optional
source_url string optional Source URL used for the request.

Get Profile

threads.profile

Fetch a Threads user profile including bio, follower count, and verification status.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"username":"zuck"},"capability":"threads.profile"}'

Input

Field Type Required Description
url string optional Threads profile URL to look up.
username string optional Threads username to look up.

Output

Field Type Required Description
source_url string optional Source URL used for the request.
user object optional The user profile data.
user.bio_links array<object> optional
user.biography string optional
user.follower_count integer optional
user.full_name string optional
user.has_badge boolean optional
user.hd_profile_pics array<object> optional
user.id string optional
user.is_private boolean optional
user.is_verified boolean optional
user.pk string optional
user.profile_pic_url string optional
user.profile_url string optional
user.username string optional

Search Threads

threads.search

Search for threads matching a text query.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"limit":5,"query":"threads"},"capability":"threads.search"}'

Input

Field Type Required Description
limit integer optional Maximum number of results to return.
query string required Search query string.

Output

Field Type Required Description
count integer optional Number of threads returned.
end_cursor string optional Cursor for pagination.
has_more boolean optional Whether more results are available.
query string optional The search query that was executed.
source_url string optional Source URL used for the request.
threads array<object> optional List of matching threads.
threads[].id string optional
threads[].posts array<object> optional

List User Replies

threads.user.replies

Fetch the replies posted by a user.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"limit":5,"username":"zuck"},"capability":"threads.user.replies"}'

Input

Field Type Required Description
limit integer optional Maximum number of replies to return.
username string required Threads username whose replies to fetch.

Output

Field Type Required Description
count integer optional Number of reply threads returned.
end_cursor string optional Cursor for pagination.
has_more boolean optional Whether more replies are available.
source_url string optional Source URL used for the request.
threads array<object> optional List of reply threads.
threads[].id string optional
threads[].posts array<object> optional
username string optional The username whose replies were fetched.

List User Reposts

threads.user.reposts

Fetch the reposts made by a user.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"limit":5,"username":"zuck"},"capability":"threads.user.reposts"}'

Input

Field Type Required Description
limit integer optional Maximum number of reposts to return.
username string required Threads username whose reposts to fetch.

Output

Field Type Required Description
count integer optional Number of repost threads returned.
end_cursor string optional Cursor for pagination.
has_more boolean optional Whether more reposts are available.
source_url string optional Source URL used for the request.
threads array<object> optional List of repost threads.
threads[].id string optional
threads[].posts array<object> optional
username string optional The username whose reposts were fetched.

List User Threads

threads.user.threads

Fetch the threads (posts) published by a user.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"limit":5,"username":"zuck"},"capability":"threads.user.threads"}'

Input

Field Type Required Description
limit integer optional Maximum number of threads to return.
username string required Threads username whose threads to fetch.

Output

Field Type Required Description
count integer optional Number of threads returned.
end_cursor string optional Cursor for pagination.
has_more boolean optional Whether more threads are available.
source_url string optional Source URL used for the request.
threads array<object> optional List of threads.
threads[].id string optional
threads[].posts array<object> optional
username string optional The username whose threads were fetched.

Run Threads Scraper in under a minute

Sign in, create an API key, and try any capability in the playground before you write code.

Get an API key