+Threads API
Read public Threads profiles, posts, reply chains, tags and search results as JSON, without a Meta app or Threads login.
The API.SH Threads API reads public Threads, Meta's text app, and returns JSON. A profile comes with bio, bio links, follower and following counts, verified flag, topics and recent posts. An account's posts, its replies (each with the post it answers), its reposts and its photo and video posts have their own routes. Each post carries text, media, links, the quoted post and like, reply, repost and quote counts. A post URL returns the post, the posts above it in the conversation and its direct replies, sorted top or recent and paged with a cursor. Keyword search returns matching posts, user search finds accounts with their follower counts and bios, and a topic tag page gives the tag's thread count and its posts.
- 9 endpoints
- from $1 / 1,000 calls
- 1,000 free credits / month
- failed calls free
GET https://api.api.sh/threads/v1/ profile
{"id": "63055343223","username": "zuck","name": "Mark Zuckerberg","bio": "Mostly superintelligence and MMA takes","bio_links": [],"followers": 5756183,"verified": true,"private": false,"profile_pic": "https://instagram.fdxb3-2.fna.fbcdn.net/v/t51.82787-19/825322135_17989325280103224_1252773933700107438_n.jpg?stp=dst-jpg_s640x640_tt6&efg=ey…","url": "https://www.threads.com/@zuck","bio_link_details": [],"following": null,"threads_badge": true,"topics": ["AI Threads","UFC Threads","… 3 more"],"public_views": null,"transparency_label": null,"posts": [{"id": "4020948437830849967","code": "DfNR0zhEdWv","text": "Tried to get the family to dress as burger night, but couldn't corral the littlest burger","published_at": "2026-11-01T17:33:48.000Z","username": "zuck","user_verified": true,"like_count": 4224,"reply_count": 764,"repost_count": 182,"quote_count": 33,"image": "https://instagram.ffjr8-1.fna.fbcdn.net/v/t51.82787-15/879845210_17995497813103224_7602527028515417661_n.webp?_nc_cat=102&_nc_map=urlgen_buc…","video": null,"url": "https://www.threads.com/@zuck/post/DfNR0zhEdWv","pk": "4020948437830849967","media_id": "4020948437830849967_63055343223","fbid": "17938935495400934","media_type": 8,"taken_at_timestamp": 1793554428,"user": {"id": "63055343223","username": "zuck","name": "Mark Zuckerberg","verified": true,"private": false,"profile_pic": "https://instagram.fdxb3-2.fna.fbcdn.net/v/t51.82787-19/825322135_17989325280103224_1252773933700107438_n.jpg?stp=dst-jpg_s150x150_tt6&efg=ey…"},"name": "Mark Zuckerberg","user_id": "63055343223","reshare_count": 102,"is_reply": false,"reply_to": null,"reply_control": "everyone","is_pinned": false,"caption_edited": false,"self_thread_count": 0,"topic": null,"width": 2279,"height": 2849,"has_audio": null,"alt": null,"images": [{"url": "https://instagram.ffjr8-1.fna.fbcdn.net/v/t51.82787-15/879845210_17995497813103224_7602527028515417661_n.webp?_nc_cat=102&_nc_map=urlgen_buc…","width": 2279,"height": 2849},{"url": "https://instagram.ffjr8-1.fna.fbcdn.net/v/t51.82787-15/879845210_17995497813103224_7602527028515417661_n.webp?stp=dst-webp_p1080x1080&_nc_ca…","width": 1080,"height": 1350},"… 12 more"],"videos": [],"carousel": [{"id": "4020948399372495898","image": "https://instagram.ffjr8-1.fna.fbcdn.net/v/t51.82787-15/879845210_17995497813103224_7602527028515417661_n.webp?_nc_cat=102&_nc_map=urlgen_buc…","video": null,"width": 2279,"height": 2849,"alt": null},{"id": "4020948399355662061","image": "https://instagram.ffjr1-2.fna.fbcdn.net/v/t51.82787-15/873072173_17995497822103224_7662939010019123382_n.webp?_nc_cat=108&_nc_map=urlgen_buc…","video": null,"width": 2169,"height": 2711,"alt": null},"… 1 more"],"links": [],"mentions": [],"link_preview": null,"quoted_post": null,"…": "1 more fields"},{"id": "4006434140014576097","code": "DeZtp-TkQHh","text": "Introducing Muse Wonder, our new family of frontier models with state of the art performance for personal and professional agentic work.","published_at": "2026-10-12T16:56:29.000Z","username": "zuck","user_verified": true,"like_count": 2228,"reply_count": 658,"repost_count": 177,"quote_count": 62,"image": "https://instagram.ffjr1-1.fna.fbcdn.net/v/t51.82787-15/844965867_17991705567103224_8296143909108287920_n.webp?_nc_cat=109&_nc_map=urlgen_buc…","video": null,"url": "https://www.threads.com/@zuck/post/DeZtp-TkQHh","pk": "4006434140014576097","media_id": "4006434140014576097_63055343223","fbid": "17960968839079838","media_type": 1,"taken_at_timestamp": 1791824189,"user": {"id": "63055343223","username": "zuck","name": "Mark Zuckerberg","verified": true,"private": false,"profile_pic": "https://instagram.fdxb3-2.fna.fbcdn.net/v/t51.82787-19/825322135_17989325280103224_1252773933700107438_n.jpg?stp=dst-jpg_s150x150_tt6&efg=ey…"},"name": "Mark Zuckerberg","user_id": "63055343223","reshare_count": 150,"is_reply": false,"reply_to": null,"reply_control": "everyone","is_pinned": false,"caption_edited": false,"self_thread_count": 0,"topic": null,"width": 2160,"height": 3260,"has_audio": null,"alt": null,"images": [{"url": "https://instagram.ffjr1-1.fna.fbcdn.net/v/t51.82787-15/844965867_17991705567103224_8296143909108287920_n.webp?_nc_cat=109&_nc_map=urlgen_buc…","width": 2160,"height": 3260},{"url": "https://instagram.ffjr1-1.fna.fbcdn.net/v/t51.82787-15/844965867_17991705567103224_8296143909108287920_n.webp?stp=dst-webp_p1080x1080&_nc_ca…","width": 1080,"height": 1630},"… 12 more"],"videos": [],"carousel": [],"links": [],"mentions": [],"link_preview": null,"quoted_post": null,"…": "1 more fields"},"… 8 more"],"next_cursor": "eyJhIjoiUVZGQk5GY3dkVzQ0Y0VWVE5FcFJjVTlyUlRGWWJsQk5WM2RKWW5kWVpHMXpYelJvYUY5TmVVcGlXRkJuWTFOblYxQTNkMjE1VVhJd2NIaEtZMTgyVEVwVk5VaHhhbFJ0VVUx…","cached": false,"credits_used": 1} What you can build with the Threads API
Brand mentions on Threads
/threads/v1/search with q and sort catches public posts that mention a brand or product, each with like_count, reply_count, repost_count and quote_count; open the conversation under any of them with /threads/v1/thread.
Finding Threads creators
/threads/v1/profile returns followers, bio links, topics and recent posts, and /threads/v1/search/users finds accounts by keyword with their bios and follower counts, for building outreach lists of Threads creators.
Reading a debate under a viral post
Pull a post's parents and direct replies with /threads/v1/thread, sort=top or recent, and keep passing next_cursor back as cursor to collect the whole reply list for sentiment or argument mapping.
Competitor content audits
Compare what an account posts, answers and amplifies with /threads/v1/user/posts, /threads/v1/user/replies and /threads/v1/user/reposts, and pull its photo and video posts separately with /threads/v1/user/media.
Topic tag tracking
/threads/v1/tag returns a topic tag's thread count and the posts Threads shows for it, a quick daily read on how active a tag such as photography or nba is.
Threads data you get
Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.
Threads API endpoints and prices
Every Threads endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing
| Search Threads posts /threads/ | $1 · $2 PAYG 1 credit |
| Search Threads users /threads/ | $1 · $2 PAYG 1 credit |
| Threads profile and recent posts /threads/ | $1 · $2 PAYG 1 credit |
| Threads media posts of a user /threads/ | $1 · $2 PAYG 1 credit |
| Threads user posts /threads/ | $1 · $2 PAYG 1 credit |
| Threads replies of a user /threads/ | $1 · $2 PAYG 1 credit |
| Threads reposts of a user /threads/ | $1 · $2 PAYG 1 credit |
| Threads post with replies /threads/ | $1 · $2 PAYG 1 credit |
| Threads tag /threads/ | $1 · $2 PAYG 1 credit |
Call the Threads API
Threads profile and recent posts: GET https://api.api.sh/threads/
curl "https://api.api.sh/threads/v1/profile?username=zuck" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/threads/v1/profile",
params={"username": "zuck"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/threads/v1/profile");
url.searchParams.set("username", "zuck");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); # Google Sheets (API.SH add-on)
=APISH("/threads/v1/profile", "username", "zuck")
# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Threads" and "Threads profile and recent posts".
# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp - Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
- Create an API keyOne key works for all 918 platforms.
- Send the requestJSON back in one call. Add
output=csvoroutput=ndjsonfor files.
Why API.SH for Threads data
- Public data only: no Threads login, cookies or account needed
- One key and one response shape for Threads and 917 other platforms
- Built and maintained by API.SH, not third-party publishers
- Pay per call; errors on our side cost nothing
- No rate limits: run as many calls in parallel as you need
- Live status for every endpoint
API.SH vs the official Threads API
Meta's Threads API publishes posts, manages replies and reads insights through a Meta developer app, OAuth access tokens from the accounts you work with, and app review for wider permissions. API.SH reads public Threads profiles, posts and search results without that setup.
Threads scrapers on Apify and GitHub break when Meta changes the Threads site and are priced per result. API.SH keeps profile, post, reply and search routes on one key, with blocks and retries handled, next to its Instagram and Facebook routes.
Threads API questions
What Threads data can I get?+
Profiles: /threads/v1/profile with recent posts, plus an account's posts, replies, reposts and media posts. Posts: /threads/v1/thread with its parents and replies. Search: posts by keyword (/threads/v1/search) and users (/threads/v1/search/users). Tags: /threads/v1/tag with the thread count and posts.
How much does the Threads API cost?+
Every Threads endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.
Does Threads have a free API?+
Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /threads/v1/profile at 1 credit each.
Is there an official Threads API?+
Yes. Meta publishes the Threads API for posting text, images, videos and carousels, managing replies and reading insights. It needs a Meta developer app, OAuth tokens from the accounts you work with and app review for wider access. API.SH covers the read side for public content without that setup.
Do I need a Threads or Instagram account?+
No. Requests use only your API.SH key. Private profiles are not returned, and the replies, reposts and media tabs return the single page Threads shows logged-out visitors.
How do I get the replies to a Threads post?+
/threads/v1/thread with the post url returns the post, the posts it replies to (parents) and its direct replies in pages; set sort to top or recent and pass next_cursor back as cursor until it is null.
Can I search Threads by keyword?+
Yes. /threads/v1/search?q=... returns matching public posts with author, text, media and like, reply, repost and quote counts; sort=top favors the most engaged ones. Use /threads/v1/search/users for accounts and /threads/v1/tag for a topic tag.
Can I use the Threads API from Python?+
Yes: GET https://api.api.sh/threads/v1/profile?username=zuck with the x-api-key header, using requests or the Python SDK. There is no Meta access token or token refresh to handle.
How do I get started?+
Register at api.sh, copy your key and request /threads/v1/search?q=product+launch&sort=top. Parameter details are at https://api.sh/docs; the JS and Python SDKs, Google Sheets, Zapier, Make, n8n and the MCP server at https://api.sh/mcp work with the same calls.
Does the Threads API have a rate limit?+
No. API.SH puts no rate limit on your key: send as many Threads calls in parallel as you need and pay only for the calls that run. If Threads itself slows down, the call returns 503 with a retry-after header and is not charged.