Threads API

Threads' API requires Instagram Business account linking, Facebook app review, and media container polling. Zernio skips all of that with one endpoint for text, images, and video posts.

Get API keyFull documentation
  • Free tier
  • No credit card
  • 99.97% uptime
mira.builds@mira.builds

Spent the weekend rebuilding our onboarding. Three screens instead of nine.

Sunday 27:00 PMScheduled

Join 200,000+ of the world's most ambitious developers and builders

Warner Music Group
MoFlo
ClickUp
Readdy
RE/MAX
Moving Monkey®
How it works

Live in three steps, no Threads app review

1

Profile

default

Threads

Connect Threads

Sign up for free, get your API key and connect Threads accounts through our OAuth flow.

2

POST /v1/posts

const { data } = await zernio.posts.createPost({
  body: {
    content: 'Shipping today 🚀',
    mediaItems: [{ url: 'https://cdn.acme.com/launch.jpg' }],
    platforms: [
      { platform: 'threads', accountId: 'acc_8f2a' },
    ],
    scheduledFor: '2027-01-15T14:30:00',
    timezone: 'Europe/Madrid',
  },
});

Make one call

Send content to Threads from one REST endpoint, right away or scheduled.

3

post.failed

Webhook sent to your app

Failed

Mon, 18 Jan

09:00, Europe/Madrid

Scheduled

Shipping today 🚀

Fri, 15 Jan at 14:30

Published

Track every post

Follow each post from scheduled to published, with a webhook when one fails.

Endpoints

Threads endpoints on one REST API

EndpointWhat it does
POST/v1/postsCreate or schedule a Threads post (text, image, or video)
GET/v1/posts/{id}Get status and details of a Threads post
DELETE/v1/posts/{id}Cancel a scheduled Threads post
GET/v1/profilesList all connected Threads accounts
View full API reference
Media specs

What you can upload to Threads

Zernio transcodes and optimizes media for Threads's requirements automatically.

threads/media-specs
TypeFormatMax sizeNotes
ImageJPEG, PNG8 MBUp to 10 images per post
VideoMP4, MOV1 GBUp to 5 min duration
TextUTF-8500 charsLinks auto-embedded
Capabilities

Everything the API handles for you

Threads API has rate limits tied to Instagram's Graph API. Zernio manages these limits automatically, ensuring reliable posting.

Text, images, video

Post text, images, and videos.

Scheduling

Schedule posts for your best times.

Multi-account

Manage several Threads accounts from one API key.

Status webhooks

Get notified the moment a post publishes or fails.

Multi-image posts

Attach several images to one post.

Reply threads

Chain replies into a thread.

Instagram linking

Works with the Instagram account linked to Threads.

Response

What comes back from every call

Plain JSON back from every Threads call, with the IDs and statuses your app needs to follow up.

cURL

$ 

{
  "post": {
    "_id": "65f1c0a9e2b5af0012ab34cd",
    "status": "published",
    "content": "Just shipped something cool! What do you think? 🚀",
    "platforms": [{
      "platform": "threads",
      "accountId": { "_id": "acc_abc123", "username": "@yourhandle" },
      "status": "published",
      "platformPostId": "3456789012345678901",
      "platformPostUrl": "https://threads.net/@yourhandle/post/ABC123"
    }],
    "publishedAt": "2025-01-10T10:30:00Z"
  },
  "message": "Post published successfully"
}

Start building with the Threads API

Free tier available. No credit card required.

Get free API keyRead the docs
  • Free tier
  • No credit card
  • 99.97% uptime