The Threads API without the Meta app review
Publish to Threads and manage replies through one API.
- Free tier, no credit card
- Instant API key
- MCP server included
ledge.skateOct 6
New white lows just landed. In store Saturday, all sizes.

/v1/posts201 CreatedCapabilities: What you can build on Threads
Every capability is one endpoint, the same one you call on every other platform.The screens show where each call lands.
Comments
Read replies on your Threads posts, reply to them, fetch the full reply thread under a comment, and hide, unhide, or delete replies. Toggling comments off for a post is not supported by the Threads API.
- GET
/v1/inbox/comments/{postId} - POST
/v1/inbox/comments/{postId}
ledge.skateOct 6
New white lows just landed. In store Saturday, all sizes.


maya.r2h
Do these come in black?
ledge.skate1mAuthor
Yes, black with a gum sole, sizes 36 to 46.

jin.k5h
Skated mine all weekend, the grip is unreal.
- GET
Mentions
Delivered to your webhook endpoint in real time. Threads has no polling endpoint for mentions.
Webhook events
mention.received
Publishing
Publish text-only, single image, single video, and carousel posts holding 2 to 20 images, videos, or a mix of both.
- POST
/v1/posts
- text
- image
- video
- carousel, 2 to 20
- POST
Webhooks
Receive real-time notifications for new replies and mentions on your Threads posts.
Webhook events
comment.receivedmention.received
On every platform
Agent-ready
Every Threads capability is a typed tool on the SocialAPI.ai MCP server.
- social_api_validate_post
- social_api_list_post_comments
One API key
The key that calls Threads calls all 13 platforms.
Authorization: Bearer sapi_key_…Predictable errors
The same status codes everywhere, whatever the platform behind them.
- 401expired token
- 429rate limited
- 501not on this platform
Threads API code examples.
Publish a post to Threads
The same POST /v1/posts endpoint you already use for every other platform. SocialAPI.ai handles Threads' container creation and, for carousels, the multi-step assembly behind the scenes.
Read the full Threads API publishing guidecurl -X POST https://api.social-api.ai/v1/posts \
-H "Authorization: Bearer <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"targets": [{ "account_id": "<threads-account-id>" }],
"text": "Just shipped a new feature. Ship fast, learn faster.",
"publish_now": true
}' | jq
# Response
{
"id": "<post-id>",
"status": "published",
"targets": [
{
"platform": "threads",
"account_id": "<threads-account-id>",
"status": "published",
"platform_post_id": "17899...",
"published_at": "2026-03-20T18:00:00Z"
}
]
}import requests
resp = requests.post(
"https://api.social-api.ai/v1/posts",
headers={"Authorization": "Bearer <your-api-key>"},
json={
"targets": [{"account_id": "<threads-account-id>"}],
"text": "Hot take: unified APIs beat six SDKs.",
"publish_now": True,
},
)
print(resp.json()) # { "id": "...", "status": "published", ... }const res = await fetch("https://api.social-api.ai/v1/posts", {
method: "POST",
headers: {
Authorization: "Bearer <your-api-key>",
"Content-Type": "application/json",
},
body: JSON.stringify({
targets: [{ account_id: "<threads-account-id>" }],
text: "Hot take: unified APIs beat six SDKs.",
publish_now: true,
}),
});
console.log(await res.json());Comparison: The official Threads API vs one API key.
| Aspect | The Meta Threads API | With SocialAPI.ai |
|---|---|---|
| Getting access | The Meta Threads APIRegister a Meta developer app, configure Threads use cases, and pass app review yourself. | With SocialAPI.aiNo Meta registration. Connect a Threads account through OAuth and publish immediately. |
| Publishing | The Meta Threads APITwo-step container flow: create a media container, poll its status, then publish. | With SocialAPI.aiOne POST /v1/posts call. Container creation and status polling happen behind the endpoint. |
| Mentions | The Meta Threads APIRequires Advanced Access approval plus the threads_manage_mentions scope and your own webhook plumbing. | With SocialAPI.aiMention events arrive on your configured webhook endpoint with verified signatures. |
| Reply moderation | The Meta Threads APISeparate endpoints and permission scopes for hide, unhide, and delete. | With SocialAPI.aiOne moderation endpoint: hide, unhide, or delete any reply. |
In depth: How the Threads API works on SocialAPI.ai
Threads has a full publishing API, and you can use it without registering a Meta developer app. Create text, image, video, and carousel posts, fetch reply threads, and hide or delete replies through one REST endpoint and one API key. SocialAPI.ai runs the Meta app and its review process for you.
Multi-format publishing
Publish text-only posts, single image posts, single video posts, and carousel posts holding 2 to 20 images, videos, or a mix of the two. SocialAPI.ai handles the Threads API's container creation flow for you: a single atomic call for text, a two-step container-and-publish flow for single media, and a three-step flow for carousels. You send one request and the API handles the rest.
Reply-thread management
Read every reply on your Threads posts through a single paginated endpoint, reply back to engage with your audience, and fetch the full reply thread under any comment. SocialAPI.ai normalizes Threads' reply model into the same comment schema used across every other connected platform.
Reply moderation
Hide, unhide, or delete any reply on your Threads posts through one moderation endpoint. Threads does not support toggling comments off for an entire post, so hide, unhide, and delete are the moderation actions available.
Webhook-only mentions
Threads has no polling endpoint for mentions, so a webhook is the only way to track them. SocialAPI.ai verifies Meta's webhook signatures and delivers mention events to your configured endpoint in real time, alongside new-reply notifications.
Managed Meta app
SocialAPI.ai runs the Meta Threads App and carries the app review process on its side, so you never register your own Meta developer app. Connect a Threads account through OAuth and start publishing immediately.
Threads API pricing.
Reading comments, DMs, and mentions is free and unlimited on every plan. Paid plans start at $29/mo with unlimited posts and interactions. The free tier needs no credit card.
Threads API rate limits
Meta caps each Threads profile at 250 posts, 1,000 replies, and 100 deletions per rolling 24 hours, and a carousel counts as one post. The total call budget is 4,800 × the profile's impressions over the last 24 hours, floored at 10, so a brand-new profile still gets 48,000 calls a day. These are Meta's per-profile quotas, so they apply to posts published through SocialAPI.ai too.
SocialAPI.ai plans for Threads
The free tier includes 2 social profiles and 10 posts a month with no credit card. Paid plans have unlimited posts: $29/mo for 10 profiles, $109/mo for 50, and $349/mo for 200. Reading replies and mentions is free on every plan.
Frequently asked questions
What developers ask before they ship Threads.
Does Threads have an API?
Yes. Threads has a full publishing API for text, image, video, and carousel posts, plus endpoints for reading and moderating replies. SocialAPI.ai runs the Meta app and its review process, so you connect a Threads account through OAuth and publish without registering your own Meta developer app.
Is the Threads API free?
Meta does not charge for Threads API access. SocialAPI.ai has a free tier with 2 social profiles and 10 posts a month, no credit card required, and paid plans start at $29/mo with unlimited posts.
Can I publish carousels to Threads via the API?
Yes. Carousel posts can hold 2 to 20 images, videos, or a mix of both. SocialAPI.ai handles the multi-step container flow Threads requires for carousels behind one POST /v1/posts call.
Can I edit a Threads post through the API?
No. The Threads API does not support editing a published post. Delete it and publish a new one instead.
Can I moderate replies on my Threads posts?
Yes. You can hide, unhide, or delete any reply on your Threads posts through one moderation endpoint. Threads does not support toggling comments off for an entire post.
Can AI agents post to Threads?
Yes. The built-in MCP server exposes publishing as tools, so Claude and other MCP-capable agents can draft and publish Threads posts with your approval flow.
Every other platform, one API: Every other platform, one API
Same key, same shapes, same webhook.
Ready to unify your social interactions?
Free tier available. No credit card required. Ships with the MCP server.